Menu
実装コードとドキュメントの差異を調査し、ドキュメントを実装に合わせて更新する。仕様書のメンテナンスに使用
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
E2Eテスト（Large Tests）をPlaywrightで実行します。特定のアプリやテストファイルを指定可能。
MSWを使用したAPIモックを生成します。
統合テスト（Medium Tests）を実行します。シーケンス図と1:1で対応するテストです。
コードレビューを実行します。
OWASP Top 10に基づくセキュリティチェックを実行し、隔週レポートを作成します。
ユニットテスト（Small Tests）を実行します。特定のファイルやパッケージを指定できます。
| name | sync-docs |
| description | 実装コードとドキュメントの差異を調査し、ドキュメントを実装に合わせて更新する。仕様書のメンテナンスに使用 |
| argument-hint | [対象ディレクトリ: sequence|specs|user-stories|architecture|development|skills]（省略時は全体） |
プロジェクトの仕様ドキュメントを実装コードと比較し、差異を修正します。
docs/
├── sequence/ # シーケンス図（実装フロー）
│ ├── api/ # APIエンドポイント別
│ ├── web/ # Webフロントエンド
│ └── admin/ # 管理画面
├── specs/ # API・DB仕様書
│ ├── api/ # API仕様
│ └── db/ # DB仕様
├── user-stories/ # ユーザーストーリー
├── architecture/ # アーキテクチャ設計
├── development/ # 開発ガイドライン ← スキルが参照
└── testing/ # テスト戦略・ガイド
.claude/
├── skills/ # スキルファイル（docs/を参照）
├── rules/ # 開発ルール ← テンプレート・エージェント参照を含む
└── templates/ # テンプレートファイル
logs/
└── deployment/ # デプロイ手順書（deployment.mdの移行先）
| 引数 | 対象ディレクトリ | 対応する実装 |
|---|---|---|
sequence | docs/sequence/ | apps/api/src/, apps/web/, apps/admin/ |
specs | docs/specs/ | apps/api/src/interface/rest/, packages/db/prisma/schema/ |
user-stories | docs/user-stories/ | apps/web/e2e/large/, apps/admin/e2e/ |
architecture | docs/architecture/ | プロジェクト全体構成 |
development | docs/development/ | 開発規約・ツール設定 |
testing | docs/testing/ | テスト戦略・ガイド |
skills | .claude/skills/ | docs/ との整合性 |
rules | .claude/rules/ | テンプレート・エージェント参照の整合性 |
| （省略） | docs/ 全体 + .claude/ | 全実装コード |
skills 引数または省略時に実行されます。
| スキル | 参照ドキュメント |
|---|---|
/commit | docs/development/git-commit.md |
/pr | docs/development/git-commit.md, ci-cd-tools.md |
/review | docs/development/coding-standards.md |
/build | docs/development/monorepo-management.md, ci-cd-tools.md |
/lint | docs/development/coding-standards.md |
/format | docs/development/coding-standards.md |
/typecheck | docs/development/coding-standards.md |
/unit-test | docs/testing/testing-strategy.md, testing-guide.md |
/integration-test | docs/testing/testing-strategy.md, testing-guide.md |
/e2e-test | docs/testing/testing-strategy.md, testing-guide.md, docs/development/e2e-docker.md |
/gen-mock | docs/testing/testing-guide.md |
/sequence-diagram | docs/development/api-design.md |
.claude/rules/チェック対象| ルールファイル | 参照ドキュメント | チェック内容 |
|---|---|---|
auto-assign.md | .claude/agents/, .claude/skills/ | エージェント・スキル名の存在確認 |
templates.md | .claude/templates/ | テンプレートファイルパスの存在確認 |
spec-driven.md | docs/sequence/, docs/specs/ | 仕様書ディレクトリ参照の正確性 |
testing.md | docs/testing/ | テスト戦略ドキュメント参照の正確性 |
# 1. 各スキルの参照ドキュメントを抽出
grep -r "docs/development" .claude/skills/*/SKILL.md
# 2. 参照先ファイルの存在確認
ls docs/development/
# 3. 差異がある場合は報告
docs/sequence/)| チェック | 実装参照先 |
|---|---|
| エンドポイントパス | apps/api/src/interface/rest/*.ts |
| リクエスト/レスポンス形式 | packages/validation/src/ |
| UseCase呼び出しフロー | apps/api/src/application/usecases/ |
| Repository操作 | apps/api/src/infrastructure/repositories/ |
docs/specs/api/)| チェック | 実装参照先 |
|---|---|
| エンドポイント一覧 | apps/api/src/interface/rest/ |
| HTTPメソッド・パス | Honoルーター定義 |
| バリデーションルール | packages/validation/src/ |
| エラーレスポンス | apps/api/src/interface/error-handler.ts |
docs/specs/db/)| チェック | 実装参照先 |
|---|---|
| テーブル定義 | packages/db/prisma/schema/*.prisma |
| リレーション | Prismaスキーマの @relation |
| インデックス | Prismaスキーマの @@index |
docs/user-stories/)| チェック | 実装参照先 |
|---|---|
| シナリオの実装状態 | apps/web/e2e/large/, apps/admin/e2e/ |
| 受け入れ条件 | E2Eテストのアサーション |
| 優先度 | 説明 | 例 |
|---|---|---|
| クリティカル | 実装と完全に矛盾 | エンドポイントパスの相違、存在しないファイル参照、リンク切れ |
| 中 | 情報の欠落・不足 | 新規追加されたパラメータ未記載 |
| 低 | 表記揺れ・軽微な差異 | バージョン番号、フォーマット |
## 今後の拡張 セクションに移動## sync-docs 実行結果
### クリティカル（即修正）
- [ ] `docs/sequence/api/crm/customer-create.md`: エンドポイント `/api/crm/customers` → `/api/customers` に修正
- [ ] `.claude/skills/build/SKILL.md`: 参照先 `docs/development/deployment.md` が存在しない
### 中（要確認）
- [ ] `docs/specs/api/post.md`: `publishedAt` パラメータの記載漏れ
- [ ] `.claude/skills/unit-test/SKILL.md`: カバレッジ閾値の記載が `docs/development/testing.md` と異なる
### 低（任意）
- [ ] `docs/architecture/overview.md`: Node.jsバージョン 20.x → 22.x
### スキル↔ドキュメント整合性
| スキル | 参照ドキュメント | 状態 |
| ------ | ---------------- | ---- |
| `/commit` | `git-commit.md` | ✅ |
| `/lint` | `coding-standards.md` | ✅ |
| `/build` | `deployment.md` | ⚠️ 内容不一致 |