implement-spec

mattpocock/skills の skills/engineering/implement-spec/SKILL.md（4ae2317、MIT（LICENSE））から workflow-axa に同梱されています。以下の上流テキストは変更されていません。内容が競合する場合は、末尾の workflow-axa の適用内容が優先されます。

仕様が提供されています。この仕様には、実装方法を説明するチケットが関連付けられているはずです。

課題トラッカーも提供されているはずです。提供されていない場合は、ユーザーに /setup-matt-pocock-skills を実行するよう伝えてください。

目標は、単一の 統合ブランチで仕様全体を実装し、課題トラッカーが作業を完了とする方法に従ってすべてのチケットを解決することです。

チケットは手順の一覧ではありません。ブロック関係を持つ タスクグラフです。つまり、常に着手可能なチケットのフロンティアがあります。

各サブエージェントは、必ず新しいコンテキストウィンドウで開始してください。

サブエージェントとのやり取りは最小限にしてください。主に、仕様、チケット、調査メモ、過去のコミットへのコンテキストポインターを使って伝達します。ポインターから参照できる情報を重複して伝えないでください。

可能な場合は、並行性を最大限に高めるため、実装サブエージェントをバックグラウンドで実行してください。

手順

1. 仕様とチケットを読み、タスクグラフを把握します。

2. （任意）チケットで必要な調査（関連するコードベースのファイルや外部ドキュメントなど）を行うために、調査サブエージェントを使用します。調査サブエージェントがファイルを保存できることを確認してください。すべての後続サブエージェントがアクセスできる、リポジトリ外のディレクトリに Markdown 形式のメモを保存させます。これにより、実装サブエージェントは調査ではなく実装に集中できます。

3. 統合ブランチを作成します。課題トラッカーが PR で作業を完了とする場合、またはユーザーが PR を求めている場合は、手順 5 の最初のマージ後に、仕様とチケットを完了するものとしてクローズするドラフト PR を作成します（main より先行するコミットがないブランチでは PR を作成できません）。

4. チケットごとに新しい 実装サブエージェントを使用し、それぞれ専用の worktree と専用のブランチで作業させます。各実装サブエージェントは次の作業を行います。

   • 作業開始前に、自分の worktree が統合ブランチをベースとしていることを確認し、そうでない場合は統合ブランチにリセットします。
   • tdd を指定して Skill ツールを呼び出し、チケットを実装します。
   • 完了を報告する前に、統合ブランチの最新状態を自分のブランチにマージします。

5. 実装サブエージェントが作業を完了したら、マージサブエージェントを使って、その作業を統合ブランチにマージします。

6. これにより、対応可能なチケットのフロンティアが変わった場合は、新たに着手可能になったチケットの作業を開始するため、さらに実装サブエージェントを起動します。これにより、並行性を最大限に高められます。

7. すべてのチケットが完了したら、統合ブランチで code-review を指定して Skill ツールを呼び出します。コードレビューで指摘された問題はすべて、新たに起動した単一の実装サブエージェントで修正します。

8. ドラフト PR がある場合は、レビュー可能な状態にします。ない場合は、課題トラッカーが作業を完了とする方法に従って各チケットを解決し、統合ブランチを報告します。

9. すべての実装サブエージェントの worktree をクリーンアップします。

---

workflow-axa の適用内容

参照用のみ。 このパッケージがこのスキルをそのまま実行することはありません。ローカルへの適用は workflow-execute が担当します（課題トラッカー、ブランチ、マージ、コミットは使用しません）。実装には /workflow を使用してください。