implement-spec について
チケットを依存関係グラフとして扱い、1つの統合ブランチで仕様を実装するスキルです。実装作業の並行化、完了分のマージ、最終レビューとチケットの解決を進めます。
主な機能
- 01チケットとブロッカーの把握
- 02個別の worktree でチケットを実装
- 03完了した作業を統合ブランチへマージ
- 04ブロック解除に応じた後続作業の開始
- 05実装全体のレビュー
活用シーン
- 01依存関係のあるチケット群で仕様を実装
- 02並行可能なコーディング作業の分担
- 03統合と最終レビューの調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ hu3rror/ my-skills --skill implement-specインストール後、Claude Code で/implement-specを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
仕様が提供されています。この仕様には、実装方法を記述したチケットが関連付けられているはずです。
課題トラッカーも提供されているはずです。提供されていない場合は、ユーザーに /setup-matt-pocock-skills を実行するよう伝えてください。
目標は、仕様全体を単一の統合ブランチに実装し、課題トラッカーの作業完了方法に従ってすべてのチケットを解決することです。
チケットは手順の一覧ではありません。ブロック関係を持つタスクグラフです。そのため、常に着手可能なチケットのフロンティアがあります。
サブエージェントとのやり取りは最小限にしてください。主に、仕様、チケット、調査メモ、過去のコミットへのコンテキストポインターを使って連携してください。ポインターから確認できる情報を重複して伝えないでください。
可能な場合は、並行処理を最大化するため、実装サブエージェントをバックグラウンドで実行してください。
手順
-
仕様とチケットを読み、タスクグラフを把握します。
-
(任意)チケットに必要な調査(関連するコードベースのファイルや外部ドキュメントの確認)を行うため、調査サブエージェントを使用します。調査サブエージェントがファイルを保存できることを確認してください。すべての後続サブエージェントがアクセスできる、リポジトリ外のディレクトリに Markdown のメモを保存させます。これにより、実装サブエージェントは調査ではなく実装に集中できます。
-
統合ブランチを作成します。課題トラッカーが PR によって作業を完了する場合、またはユーザーが PR を求めている場合は、手順 5 で最初のマージを行った後にドラフト PR を作成します(main より先行するコミットがないブランチでは PR を作成できません)。仕様とチケットを完了する PR として設定します。
-
実装サブエージェントを使って各チケットを実装します。各サブエージェントはそれぞれ独自の作業ツリーとブランチを使用します。各実装サブエージェントは次のことを行います。
- 作業開始前に、自分の作業ツリーが統合ブランチをベースにしていることを確認し、そうでなければ統合ブランチにリセットします。
tddスキルを読み込みます(SKILL.md を読みます)。- 作業完了を報告する前に、統合ブランチの最新の変更を自分のブランチにマージします。
-
実装サブエージェントの作業が完了したら、マージサブエージェントを使って統合ブランチにマージします。
-
チケットのフロンティアが変わった場合は、新たに着手可能になったチケットに取り組むため、さらに実装サブエージェントを起動します。これにより、並行処理を最大化できます。
-
すべてのチケットが完了したら、統合ブランチで
code-reviewスキルを読み込みます(SKILL.md を読みます)。コードレビューで指摘された問題は、単一の実装サブエージェントですべて修正します。 -
ドラフト PR が存在する場合は、レビュー可能な状態にします。存在しない場合は、課題トラッカーの作業完了方法に従って各チケットを解決し、統合ブランチを報告します。
-
すべての実装サブエージェントの作業ツリーをクリーンアップします。