help

今すぐ実行

対象：$ARGUMENTS

すぐに解析します：

• 対象に --compact が含まれる場合：Vault の状態にかかわらず、コンパクトモードを強制します
• 対象にスキル名（例：「help reduce」または「help reflect」）が含まれる場合：その特定のスキルの詳細なヘルプを表示します
• 対象が空の場合：Vault の状態からモードを判断します

次の手順を実行します：

1. Vault の状態を収集する（ステップ 1）
2. ドメインの語彙を解決する（ステップ 2）
3. モードを判断する（ステップ 3）
4. コマンドを動的に検出する（ステップ 4）
5. 適切なモードで表示する（ステップ 5）

今すぐ開始してください。 各ステップの定義は以下を参照してください。

---

ステップ 1：Vault の状態を収集する

どのドメイン名のディレクトリが存在するか（notes/、reflections/、concepts/、ideas/、decisions/、memories/、または derivation-manifest.md から導出した任意のカスタム名）を確認して、ノートフォルダーを特定します。次に、件数を収集します：

• ノート数： ノートフォルダー内の .md ファイル数。MOC（フロントマターに type: moc を含むファイル）は除外します
• インボックス数： インボックスフォルダー（inbox/、journal/、encounters/ など）内の .md ファイル数
• 観察数： ops/observations/ または ops/methodology/ 内の .md ファイル数
• 緊張関係数： ops/tensions/ 内の .md ファイル数
• 接続密度： ノートフォルダー全体の Wiki リンク（[[）の数。ノート数の 2 倍未満の場合は疎とします
• キューの状態： ops/queue/queue.yaml または ops/queue/queue.json の保留中のタスク
• 健全性の警告： 存在する場合は、ops/health/ 内の最新のレポートを確認します
• チュートリアルの状態： 未完了のチュートリアルがないか ops/tutorial-state.yaml を確認します
• セッション数： ops/sessions/ 内のファイル数から推定します（利用の成熟度を示します）

# Quick state gathering
note_count=$(ls -1 {vocabulary.notes}/*.md 2>/dev/null | wc -l | tr -d ' ')
inbox_count=$(ls -1 {vocabulary.inbox}/*.md 2>/dev/null | wc -l | tr -d ' ')
obs_count=$(ls -1 ops/observations/*.md ops/methodology/*.md 2>/dev/null | wc -l | tr -d ' ')
tension_count=$(ls -1 ops/tensions/*.md 2>/dev/null | wc -l | tr -d ' ')

ステップ 2：ドメインの語彙を解決する

ops/derivation-manifest.md（または、ない場合は ops/derivation.md の「Vocabulary Mapping」セクション）を読み込みます。reduce、reflect、reweave、verify、rethink、note、MOC、inbox に対応するドメイン固有の名称を抽出します。どちらのファイルも存在しない場合は、共通の名称を使用します。

表示時に、ドメイン名と共通名が異なる場合は、共通名を括弧内に表示します：

  /{domain:reduce} (reduce)   Extract patterns from journal entries

ドメイン名と共通名が同じ場合は、その名称のみを表示します：

  /reduce   Extract insights from source material

ステップ 3：モードを判断する

条件	モード
引数に --compact が含まれる	コンパクト
引数に特定のスキル名が含まれる	スキル詳細
ノート数 < 5	ナラティブ
ノート数 >= 5	コンテキスト

ステップ 4：コマンドを検出する

${CLAUDE_PLUGIN_ROOT}/skills/ を動的にスキャンします：

• SKILL.md を含むサブディレクトリ（例：reduce/SKILL.md）

各フロントマターから name: と description: を抽出します。コマンド一覧をハードコードしないでください。

コマンドのカテゴリ：

カテゴリ	コマンド	表示するタイミング
コア	/ask、/learn、/next、/help	常に
処理	/reduce、/reflect、/reweave、/verify	常に（初日からすべてのスキルを表示）
メンテナンス	/health、/rethink、/remember	常に
進化	/architect、/reseed、/add-domain、/upgrade	常に
メタ	/tutorial、/graph、/stats	常に

ステップ 5：表示する

ナラティブモード（ノート数 < 5）

これは最初の印象です。ユーザーは新規ユーザーか、まだ利用を始めたばかりです。システムが「何をするか」を列挙する前に、「何であるか」を説明します。

ナラティブモードで伝えること：

1. Ars Contexta とは何か（1 文）
2. ユーザーのシステムが何をするために構築されたか（利用可能であれば ops/derivation.md を参照）
3. ユーザーが今すぐできること（抽象的な可能性ではなく、具体的な操作）
4. システムがユーザーとともにどのように成長するか

--=={ ars contexta : help }==--

Your knowledge system is ready. It turns thoughts
into a connected graph where every note compounds
the value of every other note.

[If ops/derivation.md exists:]
Your system: [domain description from derivation]

Getting started:

  Tell me a thought, observation, or question.
  I will turn it into a note and show you what
  the system does with it.

  Or try one of these:

  /ask [question]    Ask about [domain] -- I will
                     answer from your graph
  /learn [topic]     Research [topic] and grow
                     your graph with findings
  /tutorial          Walk through the system
                     step by step (5 minutes)

As your graph grows, you will use:
  /reduce [source]   Extract insights from articles,
                     notes, or any raw material
  /reflect           Find connections between notes
  /health            Check your system's health

Your system also learns from experience:
  /remember             Capture when something goes wrong
                        (your system remembers corrections)
  /ask [question]       Ask about [domain] -- answers draw
                        from 249 methodology notes AND your
                        system's own methodology notes

Type /help anytime for guidance.

マニュアルへの参照（manual/ が存在する場合）： Vault に manual/ ディレクトリがある場合は、ナラティブ出力に次を追加します：

  For a deeper guide, read manual/getting-started.md
  or explore the full manual in manual/manual.md.

ナラティブモードの主な原則：

• リスト形式ではなく、会話調にします
• 最も簡単な入り口を最初に示します（「考えを話しかけてください」）
• コマンドはアルファベット順ではなく、ユーザーが必要とするタイミングごとにまとめます
• 可能な場合は、ユーザーの実際のドメインに言及します
• チュートリアルが未完了の場合は、「未完了のチュートリアルがあります（5 段階中 N 段階）。/tutorial で再開できます」と伝えます

コンテキストモード (ノート数 >= 5)

ユーザーは作業を続けています。今何が起きているか、次に何が最も価値があるかを示します。

コンテキストモードが伝える内容:

1. 現在のシステム状態 (簡潔な指標)
2. 今すぐ注意が必要なこと (状態に応じたもの)
3. 推奨される次のアクション (最も価値のある単一のもの)
4. まだ知らないかもしれないコマンド
5. 完全なコマンドリファレンス

--=={ ars contexta : help }==--

Your system: [domain] knowledge graph
  [N] notes, [M] connections, [P] pending tasks

Right now:
  [State-aware observations — pick up to 3 most relevant:]
  Your inbox has [N] items (oldest: [age])
  [N] pending observations -- approaching /rethink threshold
  Pipeline: [N] tasks at [phase] phase
  [N] notes have sparse connections (< 2 links)

Suggested:
  [Single most valuable next action with rationale]

[If user hasn't tried certain commands:]
Commands you might not know:
  /remember    Capture when something goes wrong
               (teaches your system from friction)
  /graph       Explore your knowledge graph visually
  /stats       See vault metrics in shareable format

All commands:
  /ask [question]        Query your knowledge system
  /learn [topic]         Research and grow your graph
  /next                  Next recommended action
  /{reduce} [source]     Extract insights from material
  /{reflect}             Find connections between notes
  /{reweave}             Update older notes
  /verify [note]         Combined quality verification
  /health                Run vault diagnostics
  /{rethink}             Challenge assumptions
  /remember              Capture methodology learning
  /architect             Research-backed evolution advice
  /reseed                Principled restructuring
  /add-domain            Extend with a new domain
  /upgrade               Check for skill improvements
  /tutorial              Interactive walkthrough
  /graph                 Graph exploration
  /stats                 Vault metrics

状態に応じた提案ロジック:

最初に一致する条件を選びます:

条件	提案
受信トレイに項目がある	受信トレイを処理: /{reduce} [oldest-inbox-item-filename]
パイプラインに保留中のタスクがある	処理を再開: /next
10 件以上の観察または 5 件以上の緊張	蓄積された証拠を確認: /{rethink}
ヘルス警告が存在する	ヘルスを確認: /health
ノートは存在するが接続が疎	接続を構築: /{reflect}
ユーザーがまだ /learn を試していない	グラフを育てる: /learn [their domain に関連するトピック]
方法論フォルダに摩擦ノートがある	あなたのシステムは摩擦から学んでいます -- /{rethink} で確認してください
方法論フォルダに derivation-rationale 以外のノートがある	あなたのシステムには [N] 件の運用上の学びがあります -- /ask で問い合わせるか ops/methodology/ を閲覧してください
採掘されないままセッションが蓄積している	セッションの学びを採掘: /remember
健全な保管庫、プレッシャーなし	次は何か: /next

可能な場合は特定のファイルを参照してください (例: 実際の最も古い受信トレイのファイル名、実際の保留中のタスクの説明)。

マニュアルページの提案 (manual/ が存在する場合): 最初に一致する状態に応じた条件に基づいて、関連するマニュアルページを提案します:

条件	マニュアルページ
受信トレイに項目がある	[[workflows]] (処理パイプライン)
パイプラインに保留中のタスクがある	[[workflows]] (バッチ処理)
観察/緊張が蓄積している	[[meta-skills]] (/rethink ガイド)
ヘルス警告が存在する	[[troubleshooting]]
接続が疎	[[workflows]] (接続の発見)
全体的なオリエンテーションが必要	[[getting-started]]

追加: 詳細は manual/{page}.md を参照してください

「まだ知らないかもしれないコマンド」ロジック:

ユーザーが使用した可能性が高いコマンドを、その成果物を確認して追跡します:

• ops/sessions/ に learn 関連のトランスクリプトがあるか、受信トレイにリサーチファイルがあれば /learn が使用済み
• ops/methodology/ または ops/observations/ にファイルがあれば /remember が使用済み
• /graph は... 使用済み (成果物なし、ノート数 > 20 なら常に提案)
• /stats は... 使用済み (成果物なし、ノート数 > 10 なら常に提案)

ユーザーがおそらく試していないコマンドを最大 3 つ表示します。明らかに使用済みのコマンドはスキップします。

コンパクトモード (--compact フラグ)

クイックリファレンス。状態分析なし。提案なし。コマンドのみ。

--=={ ars contexta : help --compact }==--

  /ask [question]        Query knowledge system
  /learn [topic]         Research and grow graph
  /next                  Next recommended action
  /{reduce} [source]     Extract insights
  /{reflect}             Find connections
  /{reweave}             Update older notes
  /verify [note]         Quality verification
  /health                Vault diagnostics
  /{rethink}             Challenge assumptions
  /remember              Capture methodology learning
  /architect             Evolution advice
  /reseed                Restructure system
  /add-domain            Add new domain
  /upgrade               Check for improvements
  /tutorial              Interactive walkthrough
  /graph                 Graph exploration
  /stats                 Vault metrics
  /help                  This guide

スキル詳細モード (help [skill-name])

ユーザーが特定のスキルについてヘルプを求めた場合 (例: /help reduce または /help reflect):

1. そのスキルの SKILL.md ファイルを見つける
2. そのフロントマター (name、description) と最初のセクションを読む
3. 焦点を絞ったガイドを表示する:

--=={ ars contexta : help /{skill-name} }==--

{Description from frontmatter}

Usage:
  /{skill-name} [arguments]

Examples:
  /{skill-name} inbox/article.md
  /{skill-name} --since 7d

What it does:
  {2-3 sentence summary extracted from the skill's
   philosophy or first methodology section}

Related:
  /{related-skill}    {one-line description}

/help ask の特殊ケース: 「What it does」セクションを拡張して、両方のナレッジレイヤーに言及します:

What it does:
  Queries the bundled methodology knowledge base (249
  research claims) AND your local methodology notes
  in ops/methodology/. Answers are grounded in
  specific claims and applied to your system's
  configuration.

パイプライン上の位置 (このスキルの前後に何が来るか) を抽出して、ワークフローのコンテキストを示します。

マニュアルの相互参照: manual/skills.md が存在する場合、要求されたスキルに関する追加コンテキストについてもそれを確認します。マニュアルには、SKILL.md のフロントマターには含まれないドメイン固有の例やワークフローのコンテキストが含まれている場合があります。

---

レンダリングルール

• 最大幅: 76 文字
• ANSI カラーコードなし
• 絵文字なし
• 等幅フォントの配置を前提
• 短いコマンド形式 (/reduce) を表示し、プラグイン修飾形式 (/arscontexta:reduce) は表示しない
• 中括弧内のドメイン固有の名前 (例: /{reduce}) は derivation-manifest.md から解決される
• ドメイン名がユニバーサル名と等しい場合、中括弧を外す

エッジケース

ops/derivation-manifest.md がない場合： すべてのコマンド名に共通の語彙を使用します。

初期化前の実行： ボールト構造がまったく存在しない場合（notes フォルダーも ops/ もない場合）、最小限のメッセージを表示します。

Ars Contexta is not initialized in this directory.
Run /setup to create your knowledge system.

複数のドメイン： ops/derivation-manifest.md に複数のドメインが記載されている場合、コンテキストモードではドメインごとにグループ化してコマンドを表示します。