既存機能のSpec化。実装済みコードを分析して要件定義書を逆生成する。spec-map.yml にコードとSpecの対応関係を記録する（コード変更なし）。
「ツイート機能のSpecを作って」「認証周りをドキュメント化して」「既存の○○機能を設計書にして」 「この機能の要件を整理して」「○○の仕様を分析して」などのリクエストで使用する。既に動いているコードからドキュメントを起こすときに使う。新規機能にはdraft-specを使う。
コード変更後のドキュメント追従にはupdate-docsを使う。
The English summary is being prepared. Showing the original description.
Review the instructions the agent will receive before you install.
本スキルは親 Opus = コード分析・方針・レビュー / spec-writer(Sonnet) = 執筆の分担で進める。
コード分析（フェーズ1〜2）は精度担保のため親が直接実行する。 spec-writer は「親が抽出した情報を文書化するだけ」の役割に限定する。
Spec 統一基盤確認 を実施する。
親エージェントが直接実行する。
overview.md の依存関係も更新する構造把握だけでは仕様書にならない。このフェーズでコードの中身を正確に把握する。 Task エージェントに仕様書作成を丸投げしない。ファイル探索の補助には使ってよいが、コードの中身は親が直接読んで把握すること。
対象機能のサービスファイルをReadツールで先頭から末尾まで読む。ファイルが大きい場合は500行ずつoffset/limitで分割する。grepで断片的に読んで推測してはならない。
エントリポイントから末端まで呼び出し先を追跡し、ファイル名:シンボル名を記録する。
processPayment()
→ validateOrder() order.service.ts:120
→ calculateTotal() pricing.service.ts:200
→ applyDiscount() pricing.service.ts:250
コード探索中に、複数機能で再利用されている共通コンポーネントを特定する:
各コンポーネントについて以下を記録する:
各メソッドについて以下を抽出する:
フェーズ2の分析結果をもとに、spec-writer へ渡す委任プロンプトを組み立てる。
整理する内容:
REQ-[機能]-[連番] 形式）ファイル名:シンボル名）のリストAgent(subagent_type: spec-writer) に以下のプロンプトで委任する。
委任プロンプト形式:
あなたは spec-writer です。以下のドキュメントを生成してください。
## 生成対象
docs/requirements/features/[グループ名].md
## 参照テンプレート
（存在する場合）docs/templates/phase1/requirements-spec.md
## 埋める情報
- REQ-ID: [採番値]
- 担当者: [名前 or 未定]
- ステータス: [値]
- 受入条件: [親が整理した条件リスト]
- 関連Spec: [特定済みREQ-IDリスト]
- 活用する共通コンポーネント: [リスト]
## コード根拠リスト（全記述の根拠。独自にgrepして補完しないこと）
[フェーズ2で抽出したコールチェーン・ビジネスルール・DBスキーマ等を根拠付きで列挙]
## ビジネスロジック図（Mermaid）
[フェーズ2で把握した処理フロー・分岐をMermaidフォーマットで渡す]
## 厳守事項
- 渡されたコード根拠リストのみを使う。独自にコードを grep / Read して情報を補完しない
- 根拠（ファイル名:シンボル名）がない記述は書かない
- 要件定義書にはWHAT（何を作るか）だけ記載。HOW（API/DB/画面遷移図）は記載しない
- 不明点は「※ 要確認」マーカーを残し、推測で埋めない
- index系ファイル（overview.md / spec-map.yml / mkdocs.yml / dependency-graph.md）は触らない（親が更新）
- 完了時に軽量セルフチェックを実行し、結果を報告すること
共通コンポーネント設計書の更新が必要な場合は、要件定義書と並列で別委任する:
あなたは spec-writer です。以下の共通コンポーネント設計書を更新してください。
## 生成/更新対象
docs/design/shared-components.md
## 参照テンプレート
（存在する場合）docs/templates/phase2/shared-components.md
## 追加するコンポーネント情報
[フェーズ2で洗い出したコンポーネント一覧（名前・種別・ファイルパス・シグネチャ・利用箇所・コード根拠）]
## 厳守事項
- 渡されたコンポーネント情報のみを記載する。独自に grep して情報を補完しない
- 既存エントリは変更しない。新規コンポーネントの追記のみ行う
- 完了時に軽量セルフチェックを実行し、結果を報告すること
spec-writer は index 系に触らないため、親が責任を持って更新する:
docs/requirements/overview.md の機能一覧・依存関係セクションを更新mkdocs.yml の nav を更新docs/design/dependency-graph.md が存在する場合、新規Specの依存関係を追記spec-writer が生成したドキュメントを本体が直接レビューする（Agent委任不可）:
統一性レビュー（既存Specが1つ以上ある場合）: Spec 統一性レビュー に従い、サブエージェントに横断チェックを実行させる。
docs/requirements/glossary.md を更新※ 初回の Spec（他に既存 Spec がない場合）は統一性レビューをスキップする
機械的整合性チェック:
Agent(subagent_type: integrity-checker) を起動する。
.claude/skills/_shared/doc-integrity-check.md 参照変更を git add してコミット（探索で見つけた全ファイル一覧をコミットメッセージに記録）。
次のステップを提案する（例: 「他の機能グループもSpec化しますか？」「detail-design で基本設計書を生成しますか？」）。
コード分析時の注意: .claude/rules/doc-accuracy.md「ドキュメント生成の正確性ルール」を厳守すること。
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
既存プロジェクトに新しいリポジトリを追加する。Workspaceにリポを追加した後、 CLAUDE.md・設計書・ドメイン構成を差分更新する。 「モバイルリポを追加した」「新しいリポを取り込んで」「リポを追加したので設計書を更新して」 「Workspaceにリポを足した」などのリクエストで使用する。 init-spec の移行モードではファイル存在チェックしか行わないため、 既存ドキュメントの内容を新リポに合わせて拡張するにはこのスキルを使う。
The English summary is being prepared. Showing the original description.
既存プロジェクトをサブエージェントで並列分析し、 精度の高い overview.md を生成する。init-spec の前処理として使う。 「既存プロジェクトを分析して」「コードベースを理解して設計書を作って」 「overview.mdを作って」などのリクエストで使用する。 ファイル数が200を超えるプロジェクトで特に有効。 200以下の場合は単一エージェントで全体を読む方が精度が高いため、 init-spec をそのまま実行することを提案する。
The English summary is being prepared. Showing the original description.
デザインの差し替え。ロジックは一切触らず見た目（HTML/CSS/テンプレート）だけを更新する。 「このデザインに差し替えて」「UIをFigmaの通りに変えて」「見た目だけ変えて」 「デザインを更新して」「CSSだけ直して」などのリクエストで使用する。 ロジック変更を伴う場合はrevise-specを使う。
The English summary is being prepared. Showing the original description.
ブラウザで画面を確認する。agent-browser CLI を使って画面のスクリーンショット撮影、 アクセシビリティツリー取得、フォーム操作、画面遷移などを行う。 「画面見て」「ブラウザ確認して」「スクショ撮って」「現状把握して」「画面開いて」 「ログインして確認して」「画面の状態を教えて」「UIを確認して」などのリクエストで使用する。 E2Eテストの作成・実行には gen-tests（Playwright）を使うこと。本スキルはテスト実行ではなく 「AIの目」としてブラウザを操作し、画面状態を把握するためのもの。
The English summary is being prepared. Showing the original description.
ClaudeDesign（claude.ai/design）とClaude Codeの連携。DesignSyncツールで デザインプロジェクトからプロトタイプHTML等を取得（インポート）、または ローカルのコンポーネントをデザインシステムプロジェクトへ同期（プッシュ）する。 「ClaudeDesignからデザインを取得して」「claude.ai/design のURLを取り込んで」 「デザインプロジェクトに同期して」「デザインシステムをプッシュして」 などのリクエスト、または claude.ai/design のURLが渡されたときに使用する。 取得したデザインのコード実装への適用は apply-design を使う。
The English summary is being prepared. Showing the original description.
詳細設計書の一括生成。2つのモードを自動判定する: (A) コード分析モード: 既存コードから詳細設計書を逆生成する（init-spec + spec-all 完了後） (B) 設計書ファーストモード: 要件定義書から詳細設計書を新規作成する（コードなし） 「詳細設計を作って」「設計書を完成させて」「実装に必要な設計書を全部作って」 「他のエンジニアに渡せる設計書にして」などのリクエストで使用する。
The English summary is being prepared. Showing the original description.