ousiass/skills/impl

impl

前提条件

• Claude Code 環境
• git, gh CLI

引数

• Issue 番号 (例: /impl #123): GitHub Issue から要件を取得
• Issue URL (例: /impl https://github.com/owner/repo/issues/123): 同上
• テキスト (例: /impl ユーザー認証機能を追加): テキストを要件として扱う
• 引数なし: ユーザーに要件をヒアリング

禁止行動（最重要）

以下に該当した場合はそのフェーズをやり直す。コンテキスト節約や軽微変更を理由にした省略は認めない。

• 「あとで実装」「TODO で残す」「別 PR で対応」を理由にサブステップ（2-1〜2-6）を省く
• ユーザーへの宣言なしにフェーズ・サブステップを飛ばす（サイレントスキップ）
• テストを未実装・ダミー（expect(true).toBe(true) 等）のままコミットする
• review エージェントを呼ばずに自己レビューで済ませる
• lint/format を試行せずスキップする（実行 → 該当設定なしを確認した場合のみスキップ可）

スコープを縮小したい場合は、フェーズの省略ではなくフェーズ1のスコープ分割からやり直し、ユーザーに確認する。

フェーズ1: 要件分析とスコープ分割

1. 引数から要件を取得する
   • Issue: gh issue view で本文・コメントを読み取る
   • テキスト: そのまま要件として扱う
   • 引数なし: ユーザーにヒアリング
2. 仕様書を確認する
   • CLAUDE.md に仕様書の格納場所が記載されていればそれに従う
   • 記載がなければ Glob で探す（**/SPEC.md, **/spec/**, docs/** 等を幅広く検索）
   • Issue 本文にリンクされたドキュメントがあれば読む
   • 見つかった仕様書の内容を要件と照合し、実装の入力とする
   • 仕様書が見つからない場合はそのまま進める
3. 現在のブランチをベースブランチとして記録する（PR のマージ先）
   • git branch --show-current を実行し、結果をユーザーに「ベースブランチ: <ブランチ名>」と明示的に表示する
   • このブランチ名をフェーズ3のPR作成時まで保持する
4. 作業ブランチを決定する（命名規則は references/branch-naming.md を参照）
5. 要件を「独立して実装・テストできる単位」に分割
6. 依存関係を整理し実装順を決定
7. TaskCreate でタスクを作成

• コードベースの探索・理解を行い要件を正確に把握する
• 不確定な仕様はユーザーに確認する
• 破壊的変更がある場合は下位互換性についてユーザーに確認する

フェーズ2: 実装サイクル（各スコープで繰り返し）

各スコープ開始時に TaskUpdate で該当タスクを in_progress にする。

2-1: Plan

• Plan エージェントで実装計画を立てる
• 変更箇所、影響範囲、テスト要件を明確にする

2-2: Develop

• develop エージェントで実装（テスト含む）
• 最小限の変更で要件を満たす
• 本番動作するコードを書くこと。以下は実装完了とみなさない：
  • モック・スタブ・ダミーだけのテスト（実コードなし）
  • TODO, NotImplementedError, pass, throw new Error("not implemented") で埋めた関数
  • インターフェース・型定義だけで中身がない実装

2-3: Review

• review エージェントでコードレビュー
• 要件適合、コード品質、テスト十分性を評価
• 未実装チェック: モック/スタブのみ、TODO/NotImplementedError、空の関数本体がないか確認

2-4: 改善サイクル

• レビュー指摘あり → develop で修正 → review で再レビュー → 指摘なしまで繰り返す

2-5: Format & Lint

• プロジェクト設定に従い変更ファイルに format/lint を実行
• 設定が見つからない場合はスキップ

2-6: Commit（必須）

• 各スコープ完了時に必ずコミットする。スキップ不可。
• コミットメッセージは CLAUDE.md の規約に従う
• コミット後に TaskUpdate で該当タスクを completed にする

フェーズ3: 完了確認とPR作成

1. 全スコープの実装完了を確認
2. 全体テストを実行
3. gh pr create --base <ベースブランチ> でPRを作成
   • ベースブランチはフェーズ1で記録した開始時のブランチを指定する。main や master にフォールバックしないこと。
   • 不明な場合は git log --oneline --graph HEAD...main 等で分岐元を確認する
   • Issue 指定時: タイトルに Issue 番号を含め、PR作成後に gh pr edit <PR番号> --add-issue <Issue URL> でリンクする（Closes は使わない）
   • PR本文: 変更サマリー + 手動チェックリスト（templates/pr-checklist.md を参照）
4. 実装サマリーをユーザーに報告

ルール

• 各スコープは独立して実装・テスト可能な単位にする
• 各スコープ完了時に必ずコミットする。 コミットせずに次へ進まない
• レビュー指摘はすべての重大度（🔴🟠🟡🟢）で修正する
• TaskCreate/TaskUpdate で進捗を管理する
• フェーズ宣言: 各サブステップ（2-1〜2-6）の開始時に ▶ 2-X 開始: <名称>、完了時に ✓ 2-X 完了 を1行表示する。これによりサイレントスキップを防ぐ
• セルフチェック: 各フェーズ完了前に本 SKILL.md の該当セクションを再読し、未実施手順がないか確認してから次フェーズへ進む
• コンパクト（コンテキスト圧縮）発生時は TaskList で現在の進捗を確認してから作業を再開する