ドキュメントと実装コードを照合し、古い記述・誤りを特定して修正する。 Use for: "ドキュメント検証", "docs同期", "実装と照合", "ドキュメント更新", "sync-docs"
ドキュメント(docs/)を実装コードと照合し、乖離を検出・修正する。
/sync-docs [target]
target: 対象ディレクトリ(省略時: docs/)find <target> -name "*.md" -type f
ドキュメント数に応じてバッチサイズを決定:
各バッチをExplore agentで並列検証:
Task(subagent_type="Explore", prompt="""
タスク: <対象ドキュメント> を実装と照合
検証項目:
1. クラス名・メソッド名・インターフェース名が実装に存在するか
2. コード例が現在の実装パターンと一致するか
3. 数値・設定値(タイムアウト、閾値等)が実装と一致するか
4. ファイルパス・ディレクトリ構造が正確か
5. 記載機能が実際に実装されているか
期待出力:
[検証レポート]
ファイル: xxx.md
問題点: (箇条書き or "なし")
修正提案: (あれば具体的に)
""")
検証結果を重大度で分類:
| 重大度 | 基準 |
|---|---|
| 高 | 実装が存在しない、シグネチャ不一致、数値誤り |
| 中 | パス誤り、命名不一致、説明が古い |
| 低 | typo、表現の改善 |
修正前に確認:
未実装機能の扱い
修正範囲
general-purpose agent で並列修正:
Task(subagent_type="general-purpose", prompt="""
タスク: <対象ファイル> を修正
修正内容:
- <具体的な修正リスト>
各ファイルを読み込み、修正を適用してください。
""")
検証対象: N ファイル
修正済み: M ファイル
削除: K ファイル
[カテゴリ別の修正サマリ表]