【非推奨】要求の整合性チェックは requirement-management の reqctl.py validate に統合された。既存の docs/sdd/ を保守する場合にのみ使用する。SDDドキュメントの整合性チェック、実装同期確認、アーカイブ（CLAUDE.md同期含む）、ファイル最適化を行う。
Do NOT use for 要求の矛盾検出（requirement-management を使用すること）。
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
⚠️ このスキルは非推奨です。
要求の整合性チェックは
requirement-managementのreqctl.py validateに統合されました。人手のレビューではなく機械検証で無矛盾性を保証できます。
本スキルの機能 移行先 整合性チェック（要求間の矛盾検出） reqctl.py validate（数値・事実の矛盾、循環、参照切れを機械検出）検証手段の実在確認 reqctl.py validate --check-tests（verificationが指すテストファイルの存在確認。実装コードと要求の乖離は検査しない）アーカイブ 物理削除を禁止し deprecated/supersededの墓標として残す運用ファイル最適化 レジストリのドメイン単位分割（ references/change_workflow_ja.md）移行手順は
sdd/requirement-management/references/migration_from_sdd_ja.mdを参照してください。 既存のdocs/sdd/を保守する場合にのみ、以下の手順を使用します。
SDDワークフローで作成されたドキュメントのメンテナンス・整理を行い、品質と一貫性を維持します。
| 問題 | 解決機能 |
|---|---|
| ドキュメント間の仕様矛盾 | 整合性チェック |
| 実装とドキュメントの乖離 | 実装同期チェック |
| 完了済みタスクの蓄積 | アーカイブ |
| ファイルの肥大化 | ファイル最適化 |
| CLAUDE.mdと実装の乖離 | CLAUDE.md同期（定期的に実装コードと比較して乖離を検出） |
| アーカイブ後の仕様散逸 | アーカイブ時CLAUDE.md同期（完了プロジェクトの仕様をCLAUDE.mdに転記） |
タスク管理先の前提: SDDタスクはデフォルトで GitHub Issue（
label:sdd:task）で管理される。ファイルモード（オプション）時のみdocs/sdd/tasks/にファイルが存在する。各機能はモードに応じて参照先を切り替えること。
- 整合性/実装同期チェック: タスク一覧は
mcp__github__list_issues（labels:sdd:task）で取得（ファイルモードは docs/sdd/tasks/）- アーカイブ: Issueモードでは「DONE＝closed Issue」で表現されるため、closeによりアーカイブ相当が完結する（
docs/sdd/archive/tasks/への移動はファイルモードのみ）。完了プロジェクトの仕様をCLAUDE.mdへ転記するステップはIssueモードでも必須。- 本SKILL・テンプレート中の
docs/sdd/tasks/...の記載はファイルモードの例。Issueモードでは対応するIssue操作に読み替える。
すべての操作でユーザー承認を必須とする
チェック実行 → レポート出力 → ★ ユーザー承認 ★ → 修正/アーカイブ実行
フルスキャン時はAgent toolで並列実行する（必須）
フルスキャン選択時:
→ Agent tool（isolation: worktree）で5機能を並列実行
→ 各サブエージェントがレポートを作成
→ メインセッションで結果を統合・サマリー作成
→ ★ ユーザー承認 ★
→ 修正は順次実行（ファイル競合回避）
| ドキュメント | 役割 | 説明 |
|---|---|---|
| CLAUDE.md | 生きた仕様書 | 「今動いているもの」の現在形の記録。常にコンテキストに入る最重要ドキュメント |
| アクティブSDD | 計画書 | 「これから作るもの」の仕様。実装時にのみ参照 |
| アーカイブSDD | 過去の記録 | 「過去の計画」の考古学的資料。参照頻度は極低 |
核心原則: SDDは計画書、CLAUDE.mdは仕様書。プロジェクト完了時に計画書の内容を仕様書に転記するステップが必須。
SDD完了 = archive移動 + CLAUDE.md更新（セット）
| セクション | 内容 |
|---|---|
| API Endpoints | 全APIエンドポイントの一覧 |
| DB Schema | テーブル定義と重要カラム |
| Services | サービス一覧と責務 |
| Pages | 画面一覧と主要機能 |
| WebSocket Message Types | メッセージ種別と方向（該当する場合） |
| State Machines | session_state等の状態遷移（該当する場合） |
| Business Rules | 環境選択ロジック等の重要なビジネスルール |
| Environment Variables | 環境変数の一覧 |
requirements、design、tasks間の矛盾や不整合を検出します。
詳細: references/consistency_check_ja.md
実装コードとドキュメントの乖離を検出します。
詳細: references/sync_check_ja.md
完了済みタスクや古い決定事項をアーカイブディレクトリに移動し、実装結果をCLAUDE.mdに反映します。
アーカイブフロー:
archive移動 → インデックス更新 → ★ CLAUDE.md更新 ★（セット）
CLAUDE.mdへの反映対象:
- 新規API → API Endpointsセクション
- 新規テーブル/列 → DB Schemaセクション
- 新規サービス → Servicesセクション
- 新規ページ → Pagesセクション
- 新規WebSocket → WebSocket Message Typesセクション
- 新規環境変数 → Environment Variablesセクション
- 状態遷移 → State Machinesセクション
- ビジネスルール → Business Rulesセクション
肥大化したファイルの分割や重複内容の統合を提案します。
CLAUDE.mdの仕様記載と実装コードの乖離を検出し、CLAUDE.mdを最新状態に更新します。
src/app/api/（または該当するルーティングディレクトリ）の実ファイルsrc/services/（または該当するディレクトリ）の実ファイルsrc/db/schema.ts（またはスキーマ定義ファイル）の実定義src/app/（または該当するページディレクトリ）の実ファイル実行手順:
1. CLAUDE.mdの各仕様セクションを解析
2. 対応する実装コードをスキャン
3. 乖離を検出しレポートを作成
4. ★ ユーザー承認 ★
5. CLAUDE.mdを更新
詳細: references/claude_md_sync_ja.md
SDDドキュメント管理を開始します。
どの機能を実行しますか？
1. 整合性チェック - ドキュメント間の矛盾を検出
2. 実装同期チェック - 実装とドキュメントの乖離を検出
3. アーカイブ - 完了タスク・古い決定事項を整理 + CLAUDE.md更新
4. ファイル最適化 - 肥大化ファイルの分割・重複統合
5. CLAUDE.md同期 - CLAUDE.mdと実装コードの乖離を検出・更新
6. フルスキャン - 上記すべてをAgent toolで並列実行
フルスキャンが選択された場合、必ずAgent tool（isolation: worktree）で5機能を並列実行する。1つのメッセージで5つのAgent toolを同時に呼び出す:
【Agent tool 呼び出し1】 整合性チェック
subagent_type: general-purpose
isolation: worktree
prompt: 整合性チェックを実行し、レポートを docs/sdd/reports/consistency/ に作成
【Agent tool 呼び出し2】 実装同期チェック
subagent_type: general-purpose
isolation: worktree
prompt: 実装同期チェックを実行し、レポートを docs/sdd/reports/sync/ に作成
【Agent tool 呼び出し3】 アーカイブ対象検出
subagent_type: general-purpose
isolation: worktree
prompt: アーカイブ対象を検出し、レポートを docs/sdd/reports/archive/ に作成
【Agent tool 呼び出し4】 ファイル最適化分析
subagent_type: general-purpose
isolation: worktree
prompt: ファイル最適化を分析し、レポートを docs/sdd/reports/optimize/ に作成
【Agent tool 呼び出し5】 CLAUDE.md同期チェック
subagent_type: general-purpose
isolation: worktree
prompt: CLAUDE.mdと実装コードの乖離を検出し、レポートを docs/sdd/reports/claude-md-sync/ に作成
各サブエージェントはレポート作成のみ行い、修正は実行しない。メインセッションで結果を統合後にユーザー承認を得る。
並列処理パターンの詳細: sdd-documentation/references/agent_teams_guide_ja.md
修正内容をリスト化してユーザーに提示し、承認を得てから実行する。
docs/sdd/reports/
├── consistency/[YYYY-MM-DD].md
├── sync/[YYYY-MM-DD].md
├── archive/[YYYY-MM-DD].md
├── optimize/[YYYY-MM-DD].md
└── claude-md-sync/[YYYY-MM-DD].md
| タイミング | 推奨機能 |
|---|---|
| フェーズ完了時 | アーカイブ（CLAUDE.md同期含む）、ファイル最適化 |
| リリース前 | フルスキャン |
| 仕様変更後 | 整合性チェック |
| 大規模実装後 | 実装同期チェック、CLAUDE.md同期 |
| プロジェクト完了時 | アーカイブ（CLAUDE.md同期は必須） |
**フルスキャン時はAgent tool（isolation: worktree）で5機能を並列実行する。**各サブエージェントが独立したworktreeでチェック・レポート作成を行い、メインセッションが結果を統合する。
メインセッション（結果統合・ユーザー承認）
├── Agent tool + worktree: 整合性チェック → docs/sdd/reports/consistency/
├── Agent tool + worktree: 実装同期チェック → docs/sdd/reports/sync/
├── Agent tool + worktree: アーカイブ対象検出 → docs/sdd/reports/archive/
├── Agent tool + worktree: ファイル最適化分析 → docs/sdd/reports/optimize/
└── Agent tool + worktree: CLAUDE.md同期チェック → docs/sdd/reports/claude-md-sync/
[TASK-XXX] [DocFix] 修正内容 の形式でTodoWriteにpendingとして追加references/management_guide_ja.mdreferences/consistency_check_ja.mdreferences/sync_check_ja.mdreferences/archive_ja.mdreferences/optimize_ja.mdreferences/claude_md_sync_ja.mdassets/templates/consistency_report_template_ja.mdassets/templates/sync_report_template_ja.mdassets/templates/archive_report_template_ja.mdassets/templates/optimize_report_template_ja.mdNo 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.
指定されたPRを6観点（セキュリティ、ドキュメント乖離、可読性、ライブラリ選定、PR説明、既知脆弱性）でレビューし、人間向け・AI向けの2形式でPRにコメントする。初回レビューおよび修正後の再レビューに使用する。Do NOT use for レビューコメントへの修正適用（pr-comment-fixerを使用すること）。
The English summary is being prepared. Showing the original description.
キャリア設計のためのデプスインタビューを実施し、本人の価値観・強み・動機を引き出す。5 Whys、ラダリング法を用いてキャリアビジョンの明確化を支援する。転職相談、自己理解、キャリアカウンセリング、1on1面談の深掘りに使用する。Do NOT use for 製品・サービスのユーザーリサーチ（depth-interviewing-productを使用すること）。
The English summary is being prepared. Showing the original description.
サービス開発のためのデプスインタビューを実施し、ユーザーの真のニーズ・課題・動機を引き出す。5 Whys、ラダリング法を用いてプロダクト開発に活かせるインサイトを発見する。ユーザーリサーチ、課題発見、ペルソナ構築、プロダクト仮説検証に使用する。Do NOT use for キャリア相談やキャリアカウンセリング（depth-interviewing-careerを使用すること）。
The English summary is being prepared. Showing the original description.
インフラメトリクスの定期調査を体系的に実施し、サービスの健全性を評価する。2層アプローチで11カテゴリのメトリクスを確認し、構造化レポートを作成する。定期的なサービス監視、障害予兆の検出、パフォーマンス評価に使用する。Do NOT use for 個別インシデントの根本原因分析（incident-rcaを使用すること）。
The English summary is being prepared. Showing the original description.
インシデント調査で根本原因を特定するためのなぜなぜ分析ファシリテーター。推測を避け、ユーザーの発言を記録し、マインドツリーで全体を可視化する。障害発生後の原因究明、ポストモーテム、再発防止策の策定に使用する。Do NOT use for 定期的なサービス健全性チェック（health-checkを使用すること）。
The English summary is being prepared. Showing the original description.
IPA非機能要求グレード2018（可用性・性能拡張性・運用保守性・移行性・セキュリティ・システム環境）の記入済み要件を入力として、運用設計書を生成する。非機能要件定義が完了しているプロジェクトの運用設計フェーズで使用する。Do NOT use for 非機能要件の定義自体（requirement-managementを使用すること）。Do NOT use for 業界調査やヒアリングから始める運用設計（operations-designを使用すること）。
The English summary is being prepared. Showing the original description.