コード変更からドキュメントを追従更新する。設計書ファースト原則の例外措置。やむを得ず先にコードを変更した場合にのみ使用する。
「さっきの変更をドキュメントに反映して」「設計書を最新にして」 「コードと設計書がズレてるから直して」「ドキュメントを最新化して」 「ドキュメント更新して」「設計書を現状に合わせて」などのリクエストで使用する。通常はドキュメントを先に更新してからコードを修正すること（revise-specを使う）。
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
※ これは「設計書ファースト」原則の例外措置です。通常はrevise-specでドキュメントを先に更新してからコードを修正する。
本スキルは親=変更箇所特定・方針・レビュー / spec-writer(Sonnet)=ドキュメント書き換え / integrity-checker=機械的整合性検査の三者分担で進める。
HEAD~1 → 直前のコミットとの差分HEAD~3 → 直近3コミット分の差分git diff --cached）Spec 統一基盤確認 を実施する。
git diff を実行し、変更内容を把握するspec-map.yml を読み、変更されたファイルパスに一致するエントリからSpec IDを特定する
Agent(subagent_type: spec-writer) に更新を委任する:
委任プロンプト形式:
あなたは spec-writer です。以下のドキュメントを差分更新してください。
## 更新対象
docs/requirements/features/[REQ-ID].md
## 更新箇所
- セクション名: [XXX]
- 変更前: [値]
- 変更後: [値]
- コード根拠: [ファイル名:シンボル名]
## 更新方針
- 差分更新が基本。既存文書の全面書き換えはしない
- 変更箇所のセクションだけを更新し、周辺は触らない
- 不明点は「※ 要確認」マーカーを残し、推測で埋めない
## ヒアリング結果サマリ
[フェーズ1で整理した変更内容]
## 厳守事項
- index系ファイル（overview.md / spec-map.yml / mkdocs.yml / dependency-graph.md）は触らない（親が更新）
- 完了時に軽量セルフチェックを実行し、結果を報告すること
spec-writer は index 系に触らないため、親が責任を持って更新する:
mkdocs.yml の nav に追加するspec-map.yml を同期するdocs/requirements/overview.md も更新するdocs/design/dependency-graph.md が存在し変更対象に新規Specがある場合、依存関係を追記するAgent(subagent_type: integrity-checker) を起動して機械的整合性チェック
.claude/skills/_shared/doc-integrity-check.md 参照git add してコミット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.