Skip to content

docs(plugin): CLI 依存スキルの graceful degradation 明記 + bin/plangate 表記の PATH 解決形式への統一 #863

Description

@s977043

Context / Why

PR #860 の検証過程で、plugin 配布物の CLI 依存に 2 つの不整合を実測確認した:

  1. README の依存列挙が不足: plugin/plangate/README.md L36 は CLI 依存スキルを 7 個列挙するが、実測では 10 個(+intent-classifier / skill-policy-router、および agents 定義 2 本)が bin/plangate を参照している
  2. PATH を通しても字義どおりでは動かない: README の対処法は export PATH="$HOME/plangate/bin:$PATH" だが、スキル本文の呼び出しは全て bin/plangate validate のような相対パス形式。PATH 解決されるコマンド名は plangate であり、導入先リポジトリの cwd に bin/plangate は存在しないため、スキル記載を字義どおり実行すると失敗する

What

方針: CLI 依存スキルは plugin 同梱を維持し(外すと PlanGate の中核価値=ゲートワークフローが配布から消える)、以下で整合させる:

  1. CLI 依存スキル正本(.agents/skills/ 7 本 + .claude/skills/ 3 本)に CLI 未導入時の degrade 手順を明記(機械検証はスキップし手動チェックリスト代替・ゲートの厳密強制には CLI + hooks が必要である旨)
  2. スキル内の呼び出し表記を bin/plangateplangate(PATH 解決)に統一(リポジトリ内実行の文脈のみ bin/plangate を残す)
  3. plugin/plangate/README.md の依存列挙を実測 10 本に修正し、読み替え注記を追加
  4. HO パス(.claude/commands/plangate-setup.md / .claude/agents/{setup-coordinator,workflow-conductor}.md)は AI が差分提案・Human 適用

関連

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:clibugSomething isn't workingpriority:P1P1: 次 milestone 候補

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions