| name | intent-plan |
| description | 一続きのIntent Planningを求める依頼と、進行中の確認への回答を受け、必要な人確認を挟みながらdiscover・compass・packets・選択したexportまで続ける。特定段階だけの依頼は対象外。 |
intent-plan Skill
役割
一続きの Intent Planning を進める薄い進行役。段階内部のアルゴリズムは持たず、既存skillから生成された指示を正として直接適用する。
- 対象:
intent-plan の明示依頼、「Intent Planningして」など計画全体を求める依頼、およびこの進行役が確認待ちになった後の回答。
- 対象外:
intent-compass だけ、intent-packets だけなど特定段階を明示した依頼。個別skillの担当を横取りしない。
- アプリケーションコードは変更しない。下流の仕様作成や実装を起動しない。
- Skill toolやAgentを使って兄弟skillを呼ばない。生成済み指示を現在の文脈で読む。
読み方
最初に generated/CONTRACT.md を読む。次に、現在の段階について以下のファイルを全文読み、その本文が今回読むよう明示するruleだけを generated/sources/ から追加で読む。生成済みinstruction内のfrontmatterは権限として適用しない。
- 問題の理解:
generated/sources/intent-discover/instruction.md
- 判断基準:
generated/sources/intent-compass/instruction.md
- 作業単位:
generated/sources/intent-packets/instruction.md
- 選択した出口:
- cc-sdd:
generated/views/intent-export-cc-sdd/draft.md
- OpenSpec:
generated/views/intent-export-openspec/draft.md
- Spec Kit:
generated/views/intent-export-speckit/draft.md
- 自然言語Spec:
generated/sources/intent-to-spec/instruction.md
- direct: 追加の下書きを作らず、確定packetを引き渡し対象として報告する
全段階のファイルを一度に読まない。別のintent skillを明示した参照は generated/sources/<skill>/ から解決する。必要なファイルがなければ手順を推測せず、再生成が必要だと報告して停止する。
生成済み指示にshell由来の操作があれば、直接実行せず次へ置き換える: 現在日時→now、4文字乱数→rand4、.intent/内のdirectory作成→mkdir-intent <path>、packet移動→move-packet <source> <destination>、自分の起草宣言削除→remove-own-drafting-assignment <issue_dir> <session>、鮮度検査→intent-check、GitのHEAD取得→git-head。呼び出しは常にnode .intent/scripts/intent-plan-ops.mjs <subcommand>とする。この7操作に対応しないBash要求は、代替shellや権限追加へ進まず停止する。
進め方
- 依頼が計画全体か確認する。特定段階の依頼はこの進行役で処理しない。曖昧なら求める範囲を質問する。
- 既存の
.intent/ 成果物を確認し、最初の未完了段階または利用者が明示した見直し段階を決める。完了済み成果物を再開のためだけに作り直さない。
- 現在の段階の生成済み指示と必要なruleを読み、そのSuccess Criteria、質問、警告、停止条件を弱めず適用する。
- 段階完了時に「確定したこと・推測のままのこと・未確定事項」を短く示す。
- 次段階の入力が揃い、新しい人判断が不要なら、次のskill名や進行だけの承認を求めず続ける。
- 人が決める判断では停止する。問題設定、複数作業へ広く効く判断基準、実装範囲・packet優先順位・既存境界の変更は、明示確認まで確定扱いにしない。
- 短い「OK」は、直前に示した確認事項と次段階への進行だけの承認として扱う。
質問の確認範囲と終了条件
generated/CONTRACT.md の同名契約を工程横断で引き継ぐ。各工程の完了を固定した質問数や往復回数から推測せず、共通の確認対象へ現在の工程固有の観点だけを追加する。
- 各質問束の前に、確定した内容と残る内容を示す。回答済み事項を次工程で聞き直さず、前工程から残る未確認事項と現在工程で増えた事項を同じ4状態で扱う。
- 一度だけ行う recap、質問パック照合、観点レビュー、設計フレーム照合を工程全体の終了条件にしない。そこから見つかった重要事項は共通の未確認事項へ加える。
- 工程承認や短い「OK」で重要な未確認事項を解除しない。利用者が質問を終了した場合は新しい質問を止め、その事項が影響する範囲だけを停止し、影響しないと根拠を示せる範囲は進める。
- 独自の質問台帳や質問アルゴリズムは作らず、共通契約と各工程の生成済み指示をそのまま適用する。
内部にない専門的な観点
generated/CONTRACT.md の「内部にない専門的な観点の補強」を工程横断で引き継ぐ。各工程の内部照合で重要な専門的根拠が足りないと分かったときだけ、調査前の明示確認へ進む。工程が変わっても、同じ判断・文面の調査を重複実行せず、未確認の結果を確定事項へ格上げしない。
工程境界の重要判断確認
個別工程の生成済み指示を適用するときは、その工程固有の開始時・終了時の重要判断確認を省略しない。片側の確認が済んでいても、もう片側の確認を代用済みとは扱わない。
- discover は終了時確認を行う。
- compass は開始時確認と終了時確認の両方を行う。
- packets は開始時確認と終了時確認の両方を行う。
- cc-sdd、OpenSpec、Spec Kit は、それぞれの export の開始時確認を行う。
- 自然言語 Spec は生成開始時確認を行う。
- direct は選択前の確認を行い、別の明示依頼で実装へ進むときは実装開始時確認が必要だと引き渡す。
intent-plan 自身は実装を開始しない。
確認対象に重要判断が残る場合は、回答案・理由・推奨を変える条件と影響範囲を示す。利用者による決定、今回の範囲外、範囲限定の明示続行のいずれかを得るまで、影響範囲を次へ進めない。生成済み指示の停止条件を、進行役独自の短縮や工程移行への承認で解除しない。
出口
- 既定では、確認済みの最初のpacket 1件だけを処理する。複数packetは利用者が対象を明示した場合だけ、依存順と既存preflightに従って処理する。
- 出口が一意でなければ用途を示して選択を待つ。優先順位や出口を推測で確定しない。
- 実装向け3出口ではfull instructionを読まず、対応するdraft viewを適用して下書き生成まで行う。
- 完了時は、生成物またはdirectの対象packet、未処理packet、未確定事項、次に選べる工程を報告する。
- export後に下流の仕様作成、アプリケーション実装、外部変更を開始しない。それらは利用者による別の明示依頼で開始する。
