Community생산성 & 협업github.com

qbarev/para-plugin

Obsidian PARA 보관함에서 아카이브 작업 수행 — 완료되거나 중단된 프로젝트(폴더와 작업 앱의 프로젝트, 예: Todoist) 또는 노트를 아카이브에 넣고, 이미 있는 내용을 나열하거나, 활성 폴더로 복원합니다. 사용자가 "이거 아카이브", "아카이브로 이동", "프로젝트 종료", "아카이브 내용 보기", "아카이브 표시", "아카이브에서 복원", "заархивируй", "перенеси в архив", "закрой проект", "что в архиве", "покажи архив", "верни из архива", "восстанови проект"라고 말할 때 사용합니다.

para-plugin란 무엇인가요?

이 스킬은 Obsidian PARA 메서드 기반 볼트에서 완료되거나 중단된 프로젝트 및 노트를 아카이브하는 작업을 자동화합니다. 사용자는 간단한 명령어(예: "archive this", "close the project")로 폴더와 연결된 백엔드 작업(예: Todoist)을 함께 아카이브하거나, 아카이브 목록을 조회하고, 항목을 다시 활성 폴더로 복원할 수 있습니다. 스킬은 `SKILL.md`에 정의된 엄격한 규칙을 따라 작동하며, `lang/<LANG>.md` 파일을 통해 영어와 러시아어 등 다국어를 지원합니다. 주요 기능으로는 아카이브 대상 찾기, 프로젝트 완료/중단 여부 평가(DoD 기준), 작업 상태 처리(완료, 이동, 유지), 충돌 검사 및 보고 등이 포함됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 Obsidian 볼트와 통합되어 작동하며, 사용자에게 일관된 워크플로우를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qbarev/para-plugin/tree/HEAD/skills/archive

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

아카이브

볼트의 Archive/ 영역: 완료되거나 보류된 모든 항목이 여기에 들어가며, 아카이빙은 항상 이동입니다 — 삭제가 아닙니다. 영구 삭제는 /remove입니다. 프로젝트의 백엔드 쌍은 폴더와 함께 아카이브 및 복원됩니다.

기본 계층

행동하기 전에 각각 이 스킬의 기본 디렉토리를 기준으로 ../../para/<file>.md로 읽으십시오 — 이 파일들은 공유 규칙을 담고 있으며, 메모리에서 다시 설명하지 마십시오:

  • ../../para/paths.md — 항상, «Language» 포함: 아래 문자열은 lang/<LANG>.md에서 가져옵니다.
  • ../../para/find-target.md — 대상을 사용하는 하위 명령어용
  • ../../para/move.md — 항상
  • ../../para/confirm.md — 항상
  • ../../para/dod.md — 대상이 프로젝트인 경우
  • ../../para/tasks.md — 대상이 프로젝트인 경우: 작업, 페어링, 영역 프로젝트
  • ../../para/note-format.md — frontmatter 편집 시; «레거시 필드»

하위 명령어

$ARGUMENTS의 첫 번째 단어가 하위 명령어를 선택합니다. list와 restore만 키워드입니다 — 다른 모든 것은 아카이브 대상이므로 /archive project c는 해당 프로젝트를 아카이브합니다. 빈 $ARGUMENTS → 세 개의 하위 명령어를 보여주고 질문합니다.


<target> — 아카이브에 넣기

  1. 대상 찾기 find-target.md에 따라, 작업 "Archive".

  2. 대상이 프로젝트인 경우:

    • 먼저 열린 작업을 확인합니다. 연결된 프로젝트의 작업을 읽습니다 (task.list, 열린 상태, project_ref 포함). 열린 작업이 있으면 목록을 표시하고 한 번 질문합니다 (Tier 1.5): 작업을 어떻게 처리할지: 완료 (task.complete 각각), 영역 프로젝트로 이동 (task.move with area), 또는 아카이브된 프로젝트 내에 남겨둡니다. 어댑터가 task.complete를 «지원하지 않음»으로 표시하는 경우, 첫 번째 선택지는 대신 archive.close_in_app 문자열이며, 이에 대해 아무것도 호출되지 않습니다. 계속 진행하기 전에 답변을 처리합니다. pairing: separate에서 레거시 Tasks/ 폴더가 있는 연결되지 않은 프로젝트는 백엔드 측이 없습니다; dod.md에 작업 확인 방법이 나와 있습니다. pairing: none에서는 작업이 프로젝트 자체의 Tasks/ 노트이며 폴더와 함께 이동합니다.
    • dod.md를 적용하고 충족되지 않은 모든 조건을 명명합니다. 해당 파일은 결과가 완료인지 중단인지 결정합니다; 여기서 그 추론을 재현하지 말고, 완화하지 마십시오.
    • 전체 폴더를 내부 구조를 그대로 유지한 채 Projects/PROJ-xxxx <title>/에서 Archive/PROJ-xxxx <title>/로 이동합니다. 이름은 정확히 그대로 유지됩니다: id는 프로젝트와 영원히 함께하며, id 발행은 Archive/를 스캔하여 예약 상태를 유지합니다 (project-id.md).
    • 연결된 경우 항상 project.archive (pairing: none에서는 무효). 개요에 tasks_ref:를 유지합니다 — 복원에 필요합니다.
    • 레거시 필드(status 등)는 정확히 그대로 둡니다 (note-format.md): 아카이브된 프로젝트는 이력을 유지합니다.
  3. 대상이 독립 노트인 경우 (Area, Resource, 또는 Inbox/에서 온 노트): 단일 .md 파일을 Archive/로 이동합니다.

    • Area는 본질적으로 지속적이며 일반적으로 아카이브되지 않습니다. 의도를 묻습니다 (Tier 1.5) — 보통 노트가 오래되었다는 의미이지, 책임이 끝난 것은 아닙니다.
    • 아카이브되지 않는 프로젝트 내의 레거시 작업 노트: 이동해도 유용한 것을 망가뜨리지 않으며, 아마도 의도한 바가 아닐 것입니다 — 질문합니다 (Tier 1.5). 작업은 이제 백엔드에서 종료됩니다.
  4. 이동 전 기본 이름 충돌 확인 (move.md, note-format.md). 중복은 해당 이름에 대한 모든 링크를 모호하게 만듭니다 — Tier 1.5, 이동보다 질문합니다.

  5. 루프 종료 — 프로젝트만 해당. 보고하기 전에 한 가지 질문을 하고 답변을 기다립니다: archive.ask_changed 문자열. 무엇이 생성되었는지가 아니라 — dod.md의 조건 2가 이미 결과물을 다룹니다 — 프로젝트가 끝난 후 무엇이 달라졌는지, 그리고 그 비용만큼 가치가 있었는지입니다.

    질문하기 전에 project.value 섹션을 소리 내어 읽습니다 — 프로젝트 시작 시 사용자가 기록한 이점 (note-format.md, "결과에 관한 세 개의 섹션") — 그리고 archive.expected 문자열로それが 실현되었는지 묻습니다 ({value} = 사용자가 쓴 내용, 예: «주당 검토 시간 -5시간»). 섹션이 비어 있거나 없는 경우, 기대치를 만들지 않고 질문 그대로 합니다.

    개요 본문 끝에 project.what_changed 섹션을 작성합니다. 첫 번째 줄은 dod.md에 따른 결과입니다 — project.outcome.completed 또는 project.outcome.abandoned 문자열 ({reason} 사용자 단어로) — 그 다음 사용자의 답변을 사용자의 단어 그대로; 자신의 말로 요약하지 마십시오. 답변이 프로젝트보다 오래 지속되는 무언가를 언급하는 경우, 이는 dod.md의 조건 4를 말하는 것입니다; 아카이브에 남기지 말고 Areas/ 또는 Resources/로 경로를 지정합니다.

    사용자가 답변을 원하지 않으면 결과 줄만 작성하고 루프가 건너뛰어졌다고 말합니다. 나머지를 절대 지어내지 마십시오.

  6. 보고: 이동한 항목, 새 경로, 결과 줄, 열린 작업 처리 상황, 백엔드 프로젝트가 아카이브되었는지 여부, 경고.


list — 아카이브 내용 보기

읽기 전용입니다. 아래에 명명된 것 이상으로 노트를 열지 마십시오.

  1. Archive/ 나열 — 프로젝트 폴더와 느슨한 .md 파일 모두.
  2. 각 프로젝트 폴더에 대해 개요 frontmatter (id, deadline)와 project.what_changed 섹션의 첫 번째 줄을 읽습니다(섹션이 있는 경우).
  3. LANG으로 두 개의 섹션을 인쇄하며, 각각 알파벳 순서, 헤더에 개수 포함 (archive.list.projects 및 archive.list.notes 문자열). 표시되는 결과는 완료된 프로젝트의 경우 마침표 없는 첫 번째 줄, 중단된 프로젝트의 경우 콜론 앞 단어만 (이유는 반복되지 않음); 마감일은 archive.list.deadline 문자열; 영어 문자열로 여기에 표시합니다:
**아카이브된 프로젝트 (N)**
1. PROJ-0005 프로젝트 D — 완료, 마감일 2026-09-30
2. PROJ-0007 프로젝트 F — 중단됨
3. PROJ-0003 프로젝트 C — 기록된 결과 없음
4. 오래된 프로젝트 — 메타데이터 없음

**아카이브된 노트 (N)**
1. 어떤 노트

project.what_changed 섹션의 첫 번째 비어 있지 않은 줄이 정확히 project.outcome.completed 문자열이거나 project.outcome.abandoned 문자열로 시작하는 경우에만 결과를 읽습니다(콜론까지). 그렇지 않은 경우 — 섹션이 누락되었거나 이 규칙 이전에 아카이브된 프로젝트에서처럼 사용자 자신의 단어로 시작하는 경우 — archive.no_outcome 문자열을 인쇄합니다; 자유 텍스트나 레거시 status에서 결과를 추론하지 마십시오. common.no_metadata 문자열 — frontmatter가 전혀 없음. 빈 아카이브는 유효한 답변입니다: 명확히 말합니다.


restore <target> — 항목 복원

  1. 대상 찾기 find-target.md에 따라, 작업 "Restore from archive".
  2. 되돌아갈 위치를 결정합니다. 프로젝트는 Projects/로 돌아갑니다. 노트는 frontmatter가 암시하는 PARA 폴더로 돌아갑니다 — area/<slug> → Areas/, resource/<slug> → Resources/. 태그가 알려주지 않거나 노트가 규칙보다 오래된 경우, 어디에 속하는지 묻습니다. 아무것도 Inbox/로 복원되지 않습니다 — 그것은 대상이 아닙니다 (paths.md).
  3. 위와 같이 기본 이름 충돌을 확인한 다음 이동합니다.
  4. 작업 측면 — 프로젝트만 해당. ref로 project.restore. pairing: separate이고 tasks_ref:가 없는 경우, 쌍 생성을 제안합니다 (tasks.md «페어링»); 예인 경우 project.create, tasks_ref: 키를 추가하고 채웁니다. pairing: none에서는 제공할 쌍이 없습니다. project.dod 섹션과 project.what_changed 섹션의 체크된 체크박스는 그대로 둡니다 — 편집은 Tier 2이며 거의 원하지 않습니다.
  5. 보고: 무엇이 돌아왔는지, 어디로, 그리고 백엔드 쌍의 상태.

참고 사항

  • 여기서 아무것도 삭제하지 마십시오. 아카이빙은 항상 Archive/로의 이동입니다; 사용자가 무언가를 없애고 싶다면 그것은 /remove입니다.
  • 모든 사용자 대상 텍스트와 모든 frontmatter 값은 LANG으로; 고정 문자열은 lang/<LANG>.md에서 가져옵니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

qbarev/para-plugin

Work with Areas in the Obsidian PARA vault — create an area of ongoing responsibility, or review which areas have gone quiet and what has drifted in them. Use when the user says "create an area", "new area", "review the areas", "which areas have gone quiet", "заведи область", "новая сфера", "добавь область", "обзор областей", "что по областям", "какие сферы провисают", "ревью сфер".

qbarev/para-plugin

Work with the inbox of the PARA vault, which lives in the task app's inbox — capture a raw thought into it, list what is sitting there unprocessed, or process captures one by one into their proper PARA folder. Use when the user wants to capture a note, mentions their task app's inbox (Todoist «Входящие», for example), or says "capture this", "add to the inbox", "what is in the inbox", "process the inbox", "запиши", "закинь в инбокс", "что в инбоксе", "покажи инбокс", "разбери инбокс", "разгреби инбокс".

qbarev/para-plugin

Set up a folder as a PARA vault run by this plugin, or bring an already set-up vault up to date — detect what the folder is, ask the setup questions one at a time, show one plan, apply it on one «yes», report. Re-running fills in what is missing and migrates an older vault schema. Use when the user says "set up the vault", "init the vault", "initialise PARA", "migrate the vault", "run /para:init", "настрой хранилище", "инициализируй хранилище", "подключи PARA", "мигрируй хранилище".

qbarev/para-plugin

Work with Projects in the Obsidian PARA vault and their pairs in the task app — list the active projects, create a project (folder plus a project in the task app), summarize where a project stands, or add a task to a project in the task app (Todoist, for example). Use when the user says "list projects", "show projects", "what am I working on", "create a project", "new project", "project overview", "project status", "add a task", "какие проекты", "список проектов", "покажи проекты", "что у меня в работе", "заведи проект", "новый проект", "саммари по проекту", "обзор проекта", "что по проекту", "статус проекта", "где я по проекту", "добавь задачу", "заведи задачу".

관련 스킬