Menu
実装コードとドキュメントの差異を調査し、ドキュメントを実装に合わせて更新する。仕様書のメンテナンスに使用
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
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` | ⚠️ 内容不一致 |