메뉴
テストの追加・補強・作り直し。TDDモード（実装前テスト先行生成）にも対応。 Playwright・Jest等のE2Eテスト、ユニットテスト、APIテストの新規作成・補強を行う。 「テストを書いて」「カバレッジを上げて」「テストを作り直して」「E2Eテストを作って」 「自動テストを作成して」「Playwrightでテストして」「操作テストを作って」 「○○のテストを実装して」「バックエンドテストを作って」などのリクエストで使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
ClaudeDesign（claude.ai/design）とClaude Codeの連携。DesignSyncツールで デザインプロジェクトからプロトタイプHTML等を取得（インポート）、または ローカルのコンポーネントをデザインシステムプロジェクトへ同期（プッシュ）する。 「ClaudeDesignからデザインを取得して」「claude.ai/design のURLを取り込んで」 「デザインプロジェクトに同期して」「デザインシステムをプッシュして」 などのリクエスト、または claude.ai/design のURLが渡されたときに使用する。 取得したデザインのコード実装への適用は apply-design を使う。
詳細設計書の一括生成。2つのモードを自動判定する: (A) コード分析モード: 既存コードから詳細設計書を逆生成する（init-spec + spec-all 完了後） (B) 設計書ファーストモード: 要件定義書から詳細設計書を新規作成する（コードなし） 「詳細設計を作って」「設計書を完成させて」「実装に必要な設計書を全部作って」 「他のエンジニアに渡せる設計書にして」などのリクエストで使用する。
既存プロジェクトの初期セットアップ（初回のみ）。コードリポジトリを分析してCLAUDE.md、要件概要、 基本設計書（アーキテクチャ、DB設計、API設計）、OpenAPI仕様、MkDocs設定を自動生成する。 「このプロジェクトをセットアップして」「既存コードを分析して」「設計書を初期化して」 「プロジェクトの構造を把握して」などのリクエストで使用する。 既にドキュメントがある場合は移行モードで差分だけ補完する。 ※ 既存Specの全更新・再生成には spec-all を使う。
全機能の一括Spec化・一括更新。PM として並列サブエージェントにコード分析を委任し、 結果を統合して全機能の要件定義書を一括生成・更新する。 「全部のSpecを作って」「設計書を全部作って」「全機能をドキュメント化して」 「要件定義を全て更新して」「Specを全部更新して」などのリクエストで使用する。 個別のSpec化には spec-feature を使う。init-specは初期セットアップ専用。
既存機能のSpec化。実装済みコードを分析して要件定義書を逆生成する。 spec-map.yml にコードとSpecの対応関係を記録する（コード変更なし）。 「ツイート機能のSpecを作って」「認証周りをドキュメント化して」「既存の○○機能を設計書にして」 「この機能の要件を整理して」「○○の仕様を分析して」などのリクエストで使用する。 既に動いているコードからドキュメントを起こすときに使う。新規機能にはdraft-specを使う。 コード変更後のドキュメント追従にはupdate-docsを使う。
コード変更からドキュメントを追従更新する。設計書ファースト原則の例外措置。 やむを得ず先にコードを変更した場合にのみ使用する。 「さっきの変更をドキュメントに反映して」「設計書を最新にして」 「コードと設計書がズレてるから直して」「ドキュメントを最新化して」 「ドキュメント更新して」「設計書を現状に合わせて」などのリクエストで使用する。 通常はドキュメントを先に更新してからコードを修正すること（revise-specを使う）。
| name | gen-tests |
| description | テストの追加・補強・作り直し。TDDモード（実装前テスト先行生成）にも対応。 Playwright・Jest等のE2Eテスト、ユニットテスト、APIテストの新規作成・補強を行う。 「テストを書いて」「カバレッジを上げて」「テストを作り直して」「E2Eテストを作って」 「自動テストを作成して」「Playwrightでテストして」「操作テストを作って」 「○○のテストを実装して」「バックエンドテストを作って」などのリクエストで使用する。 |
| context | {"required":["_shared/spec-map-operations.md","_shared/code-search-2stage.md","_shared/finish-impl.md","_shared/tech-stack-guide.md"]} |
以下の優先順で判定する：
再生成モードの場合：
以下のテストファイルを削除して作り直します：
- tests/auth.test.ts
- e2e/auth.spec.ts
よろしいですか？
以下のテンプレートを参照し、テスト仕様書の生成時にセクション構成を合わせる：
| テンプレート | 用途 |
|---|---|
docs/templates/phase4/unit-test-spec.md | 単体テスト仕様書の構成 |
docs/templates/phase4/integration-test-spec.md | 結合テスト仕様書の構成 |
テンプレートが存在しない場合は、テスト仕様書の生成をスキップしてテストコードのみ生成する。
テスト設計書（docs/design/test-design.md）が存在し、かつ実装コードがまだない場合に動作する。
テストを先に書き、全てREDの状態（テスト失敗）でコミットする。 implement-spec の coder がこのテストを GREEN にするコードを書く。
docs/design/test-design.md の対象REQ-IDのテストケース一覧を読むjest.mock() でスタブ化test.skip() でマークしておく（実装後に有効化）test: [REQ-ID] テストコードを先行生成（RED状態）test.skip() にする（実行時エラーを回避）npx playwright install でブラウザもインストール済みか確認CLAUDE.md の test_e2e を確認し、E2Eフレームワークに応じたテストを生成する。
test_e2e: none の場合はこのセクション全体をスキップする。
技術スタック対応ガイド のE2Eテストフレームワーク別対応表を参照。
waitForSelector/waitForResponse, Cypress=cy.wait/cy.intercept）を使う。固定sleepは使わないdocs/tests/unit-test-spec.md):
docs/templates/phase4/unit-test-spec.md）のセクション構成に従うdocs/tests/integration-test-spec.md):
docs/templates/phase4/integration-test-spec.md）のセクション構成に従うdocs: テスト仕様書を追加/更新.claude/skills/_shared/finish-impl.md の共通仕上げ手順を実行[機能名].spec.ts, Cypress=[機能名].cy.ts）