あなたは大まかなアイデアを TODO.md の1つの適切に形成されたタスクに変換します。大まかなアイデア:
$ARGUMENTS
これはリファインメントワークフローであり、実装ではありません。コードを書かないでください。 タスクが明確になり、ユーザーが承認するまで TODO.md に書き込まないでください。以下の手順に従って作業します:
1. 憲法を読む
プロジェクトの憲法ファイルを見つけて読んでください。その規則、特にリスク階層と自律エージェント/TODOライフサイクルルールに従います。
sprint.confが存在する場合、SPRINT_CONSTITUTION_FILESにリストされているファイルを(順番に)読み込みます。- そうでなければ、存在する
AGENTS.md、CLAUDE.md(およびそれらが参照するプロジェクト固有のガイド、例:フロントエンドのCLAUDE.md)を読み込みます。 .githooks/README.mdが存在する場合は軽く読み、ダウンストリームへの影響を正しく説明できるようにします。
これらのファイルがどれも存在しない場合、リポジトリがまだブートストラップされていないことをユーザーに伝え、/sprint:bootstrap を提案します。
2. アイデアを実際のコードに基づいて検証する(推測しない)
アイデアが触れる実際のシンボル/ファイルとその影響範囲を見つけます:
- コードグラフ(推奨、利用可能な場合):
mcp__codegraph__*ツール(codegraph_search、…_callers、…_callees、…_impact、…_context)、またはCLI(codegraph context "<the idea>"、codegraph callers <symbol>、codegraph impact <symbol>)。インデックスが古そうな場合は、最初にcodegraph sync .を実行します。 - フォールバック(コードグラフなし): Grep/Globを使用して関連するシンボルとその呼び出し元を特定します。
実際に重要なファイルをいくつか読んでください。具体的な関数/ファイル名と、変更がどこに入るかを指定します。
3. 検証する(このスキルの中核)
コードが既に行っていることに対して、アイデアに疑問を投げかけます。以下の点を明らかにします:
- 質問かタスクか? 本当に質問(「…それとも何か見落としている?」)であれば、まずコードから答えてください。既存のロジックがすでにその一部をカバーしている可能性があります。
- 実際のスコープと、価値を提供する最小の変更。
- リスク階層(憲法/
AGENTS.mdに従う)。ハイリスクの場合は、そのように述べてください。自動実装はされません。チェインは人間に委ねます。 - ユーザーが決定すべき事項(製品/UX/ポリシーの選択)であり、あなたが決定すべき事項ではありません。
AskUserQuestion を使用して、それらのいくつかの決定事項をユーザーに質問します。真の製品決定に対する答えをでっち上げないでください。コードベースからの証拠を使用して誤った仮定を修正します。
4. 1つの構造化された項目をドラフトする(4つの要素)
以下の内容でドラフトを作成します:
- 明確な命令形のタスク(疑問形ではない)、
- リスク階層、
- 具体的な完了基準(どのターゲットテストが成功する必要があるか/どの動作が検証可能か)、
- ステップ2からのファイル/関数のヒント。
最小の価値ある変更に絞ります。ドラフトを表示し、ユーザーが満足するまで調整します。
5. TODO.md に書き込み、引き継ぐ
- 承認された項目を
TODO.mdの上部近くに- [ ]エントリとして追加します。 - それを単一のアクティブ項目にするかどうかを質問します。もし
yesの場合、スキップ規則に従って、他の現在アクティブな項目を<!-- … -->ブロック(または## 🚧 Deferredの下)に移動し、チェインがこの項目のみを取得するようにします。 - 自動的にコミットしないでください。 ユーザーに伝えます:
TODO.mdをコミットすると、plan→implement→reviewチェインが開始されます(実装は impl ブランチに配置され、自動マージは行われません)。プロセスを今すぐ開始したい場合は、コミットするように提案します。
対話は簡潔に保ちます: まず根拠を示し、重要な決定事項のみを質問し、その後書き込みます。