implement-next-phase について
sketch プランの次の未完了フェーズを実装するためのコーディングエージェント向けスキルです。読み取り専用で準備し、明示的な承認後に対象フェーズだけを変更して状態を更新します。
主な機能
- 01最初の未完了フェーズを選択
- 02フェーズ見出しと todo ラベルを照合
- 03承認前は読み取り専用で準備
- 04変更を承認済みフェーズに限定
- 05編集後にフェーズを完了扱いにする
- 06新規テストの追加を禁止
活用シーン
- 01sketch プランに沿った段階的な変更の実装
- 02承認待ちのフェーズの準備
- 03合意したフェーズ範囲内での実装
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jasonharmongit/ skills --skill implement-next-phaseインストール後、Claude Code で/implement-next-phaseを入力して読み込まれたか確認します。
詳細
このスキルの呼び出し
パートナーがこのスキルを添付し、sketch plan のパスを提示した場合に使用します。このプランには、フェーズごとに1つずつの YAML todos(各 content は ## Sketch の対応する ### Phase N - … 見出しと一致します)と、ファイル本文の ## Sketch セクションが含まれています。
必ず守ること: パートナーが続行を明示的に承認するまで(例:「進めて」「実装して」「Phase 2 に進んで」)、この作業に関するアプリケーションコード、テスト、設定、アセットを編集してはいけません。準備(読み込み、検索、分析、質問)は許可されていますが、承認されるまでは実装してはいけません。
準備中のチャット: 調査レポート、調査結果のまとめ、学んだ内容の要約を提示してはいけません。sketch、プラン、コードベースの内容をチャットで言い換えたり、要約したりしてはいけません。パートナーはすでにプランを把握しています。チャットには、作業を進めるうえで妨げになる点や不明点がある場合の簡潔な質問、プランや todos の修正が必要な場合の短い依頼、そして、これ以上質問がない場合は、実装の承認を求める短い一文のみを記載します。その一文では、アクティブなフェーズを todo の content で示してください(例:承認いただければ Phase 1 - … の実装を開始できます)。準備に関するその他の文章はチャットに書いてはいけません。
Git のステージング(各フェーズサイクルの前)
このスキルで新しいフェーズサイクルを開始するたびに(プランで最初に保留中のフェーズを開始するとき、または前のフェーズを実装した後に次の保留中のフェーズを開始するとき)、git add -A を実行してから読み込みと準備を行います。コミットしてはいけません。ステージングが完了するまで、以下の手順1を開始してはいけません。
これにより、前のフェーズの作業(またはその他のステージングされていない変更)を、新しい準備や実装を始める前にチェックポイントします。
最初に行うこと(順番どおり)
-
パートナーから提示された sketch plan ファイルを読む。 YAML frontmatter を解析し、ファイル本文の
## Sketchセクションを読みます。 -
todosからアクティブなフェーズを選ぶ: ステータスがpending(または未設定/completed以外)の最初の todo を選びます。その todo のcontentがアクティブなフェーズのラベルです。todosが存在しない、空である、または保留中の項目がない場合は、そこで停止し、プランの修正または適切な solutionize sketch の提示をパートナーに依頼します。 -
sketch を確認する:
## Sketchで、アクティブな todo のcontentと見出しテキストが一致する### Phase N - …セクションを開き、そのセクションの Objective と実装範囲を示す箇条書きを読みます。一致する見出しがない場合は、そこで停止し、todos と sketch の整合をパートナーに依頼します。順序と依存関係を把握するため、sketch の先行フェーズにも目を通します。 -
コンテキストを収集する(読み取り専用):
- パートナーが指定した完了済みフェーズの資料、または実施内容が記録されている場合は同じプランの前のセクションを読みます。
- このフェーズについて sketch でリンクまたは名前が示されているファイルを開き、必要に応じて呼び出し元/呼び出し先をたどります。
- 推測せずに実装できる状態になるまで、検索とリポジトリの読み込みを行います。把握した内容は内部に留め、チャットには書きません。
-
照合して質問する: 調査によって sketch と矛盾する点、コード上必要なのに記載されていない点、または不審な点(シンボルの欠落、誤ったパス、現状に合わないテストなど)が見つかった場合は、前後の説明を加えず、チャットで要点を絞った質問を1つ(または最小限の質問)します。フェーズの内容が曖昧または不明確な場合も、推測せず同様に質問します。
-
準備ができたら引き継ぐ: 未解決の質問がある場合は手順5を続け、解決するまで承認を求めてはいけません。これ以上質問がなければ、「準備中のチャット」にある、todo の
contentでフェーズを示した短い承認依頼文のみを送ります。そこで停止します。パートナーが明示的に承認するまでは実装してはいけません。
承認後
パートナーの承認を得たら、スケッチとこれまでの回答に従って、そのフェーズのみを実装し、スコープを絞ります。特定のフェーズ番号について承認された場合は、このスキルを新たに実行するか、明示的な指示がない限り、次のフェーズに進まないでください。
新しいテストは禁止: フェーズを実装する際、新たなテストを追加しないでください。動作の変更に応じて必要な場合に限り、既存のテストを更新してください。
フェーズをまたぐ足場作りは禁止: スケッチで後のフェーズに先送りされている作業を、このフェーズだけで完結させるためにコードを変更しないでください。このフェーズと将来のフェーズの間にある不足を取り繕うために、デフォルト値、プレースホルダー、一時的なチェック、スタブ、何もしない処理、または同様のつなぎの作業を追加しないでください。ただし、スケッチでこのフェーズに明示的に要求されている場合を除きます。
このフェーズの実装編集が終わったら、直ちにスケッチの計画ファイルを編集し、YAML フロントマター内で、アクティブなフェーズの todo の status を completed に設定してください。計画やコードベースに対するその他のフォローアップ作業より先に行ってください。