Communityコーディング&開発github.com

qbarev/para-plugin

Obsidian PARA vault内の「エリア」を操作します。継続的な責任領域を作成したり、停滞しているエリアやその中で何が漂っているかをレビューします。ユーザーが「エリアを作成」「新しいエリア」「エリアをレビュー」「どのエリアが停滞しているか」「заведи область」「новая сфера」「добавь область」「обзор областей」「что по областям」「какие сферы провисают」「ревью сфер」と言ったときに使用します。

para-plugin とは?

このスキルは、ObsidianのPARAメソッドにおける「エリア(Area)」を管理するためのものです。エリアとは、健康、財務、キャリアなど、終了日のない継続的な責任であり、プロジェクトとは異なり「完了」することがありません。このスキルは、エリアが停滞していることを発見することに特化しており、プロジェクトとは異なり、エリアが放置されていてもそれを示すものがないため、有用です。主な機能は2つあります。「create <name>」は、ユーザーの説明に基づいてエリアノートを作成し、適切なグループに配置します。「review」は、すべてのエリアをスキャンし、更新がないエリア、グループなしのノート、リンク切れ、プロジェクトのように振る舞っているエリアなどをレポートします。このスキルはObsidian vaultで動作し、設定ファイル(areas.md)で定義されたモデルを尊重し、グループ名などをハードコードしません。出力はすべて設定された言語で行われ、レビュー結果は事実に基づいて報告され、ユーザーの判断を促します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qbarev/para-plugin/tree/HEAD/skills/areas

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

エリア

エリアとは、終了日のない継続的な責任です。健康、財務、キャリアなどが該当します。 プロジェクトではなく、「完了」することはありません。このスキルが存在する目的は、停滞しているエリアを表面化することです。プロジェクトとは異なり、エリアが放置されていてもそれを知らせるものは何もありません。

エリアの整理方法はここでは決定しません。 areas.md がモデルを所有します。グループ化レイヤーが存在するかどうか、グループの名前、どのフロントマターがグループを記録するか、新しいノートがどこに配置されるかなどは、すべて areas.md が定義します。このスキルはアルゴリズムを保持し、モデルを読み取るだけです。グループ名をハードコードしたり、グループの数を推測したりすることは決してありません。

基本レイヤー

行動する前に、それぞれをこのスキルのベースディレクトリから見た ../../para/<file>.md として読み込んでください。これらは共有ルールを保持しており、記憶から再記述しないでください。

  • ../../para/paths.md — 常に。"言語"も含みます。以下の文字列は lang/<LANG>.md から取得されます。
  • .claude/para/areas.md (vault設定、REPO_ROOT 下) — 常に。このスキルはモデルなしでは意味がありません。
  • ../../para/note-format.md — create 用。review の場合は TASKS = files の下にある「レガシーフィールド」用。
  • ../../para/find-target.md — review が名前付きエリアを解決する必要がある場合。
  • ../../para/confirm.md — create は書き込みます。review は何も書き込みません。
  • ../../para/thresholds.md — review 用。

サブコマンド

$ARGUMENTS の最初の単語がサブコマンドを選択します:create または review。空の場合は、両方を表示して質問します。


create <name> — エリアを開始する

  1. ディスクから Templates/Area.md をそのまま読み込みます。
  2. グループを決定します。 areas.md の GROUPS リストの値のいずれかで、説明から判断します。どうしても不明な場合は質問します。グループ化フィールドはファイルの保存場所を決定するため、空白のままにすることはできません。 GROUPING = none の場合、この手順は適用されません。
  3. フロントマターを入力します。 note-format.md のスキーマの Area 行に従います:title、tags: [area/<slug>](slug は note-format.md に従って入力)、およびモデルにグループ化フィールドがある場合はそのフィールド。
  4. 本文を入力します。
    • common.links セクション — 関連ノートへのウィキリンク。それ以外の場合はテンプレートの空の -。
    • area.current_state セクション — この責任の現状を、ユーザー自身の説明の言葉で。ユーザーが何も言わなかった場合は空白。
    • area.notes セクション — 空のままにします。時間の経過とともに埋まります。
  5. areas.md の PLACEMENT が示すパスに書き込みます。 説明がサブフォルダーを示唆する場合は、より深い階層に配置します。最初にベース名がvault全体で衝突しないか確認します。
  6. パスとグループを報告します。

説明に終了状態と目標がある場合は、それはプロジェクトであり、エリアではありません。その旨を伝え、/projects create を提案します。


review — 何が停滞しているか

読み取り専用です。「私がどの責任を見ていないか」に答えます。引数がある場合はそのエリアのみをレビューします。引数がない場合は、GROUPS がリストするすべてのグループ(数に関係なく)をレビューします。

  1. Areas/ を再帰的に走査します。すべてのノートについて:パス、グループ化フィールド、mtime (stat -f '%m %N')。TASKS = files の場合、*/Tasks/* は除外します。これらはタスクノートであり、エリアノートではありません(note-format.md「レガシーフィールド」)。

  2. 各ノートのフロントマターと、存在する場合は area.current_state セクションを読み取ります。全文は読み取りません。これはスイープであり、各ノートの要約ではありません。

  3. グループごとに計算します。 ノート数、グループが最後に触られた時期、および thresholds.md で定義されたエリアの陳腐化しきい値を超えた個々のノート。このしきい値は、プロジェクトのものよりも意図的にはるかに緩く設定されています。

  4. 実際に該当するものだけをフラグします。

    • ノートが1つもないグループ。
    • そのしきい値を超えたノート — 問題があるとは言わず、どのくらい経過したかを伝えます。
    • PLACEMENT_CHECK に違反するノート — グループ化フィールドが、そのノートが存在するフォルダーと一致しない。モデルが PLACEMENT_CHECK = none を設定している場合はスキップします。
    • area/ タグスラッグが未入力のエリアノート。
    • フロントマターがまったくないノート(慣行より前のもの — その旨を伝え、移行はしません)。
    • common.links セクション内の孤立したウィキリンク。
    • プロジェクト作業のように見える内容を持つエリア — 終了状態のある目標。それを特定し、分割することを提案します。
  5. LANG でレンダリングします。 REVIEW_GROUPING に従い、報告すべきことがないグループは除外し、areas.review.* の文字列を使用します。出力の正確な形状は areas.md にあります。モデルに依存するため、モデルが定義されている場所に記述されます。

  6. 何も書き込みません。 レビューで何か価値のあることが明らかになった場合は、それを伝え、ユーザーに決定を委ねます。

注意事項

  • エリアにおける沈黙は情報であり、判断ではありません。事実に基づいて報告します — 「74日間変更なし」とは言いますが、「あなたが放置した」とは決して言いません。
  • エリアがアーカイブされることはほとんどありません。継続的な責任は終了しません。アーカイブを依頼された場合、それは通常、ノートが古くなっているのであって、責任が終了したわけではありません。/archive を参照してください。
  • すべて LANG で出力されます。

Individual skills in this repo

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

qbarev/para-plugin

Work with Archive in the Obsidian PARA vault — put a finished or abandoned project (folder and its project in the task app, such as Todoist) or a note into the archive, list what is already there, or restore something back into an active folder. Use when the user says "archive this", "move to archive", "close the project", "what is in the archive", "show the archive", "restore from the archive", "заархивируй", "перенеси в архив", "закрой проект", "что в архиве", "покажи архив", "верни из архива", "восстанови проект".

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", "какие проекты", "список проектов", "покажи проекты", "что у меня в работе", "заведи проект", "новый проект", "саммари по проекту", "обзор проекта", "что по проекту", "статус проекта", "где я по проекту", "добавь задачу", "заведи задачу".

関連スキル