Menú
md ドキュメントの陳腐化・欠落・矛盾を 4 Layer 構造で検出し、ユーザー承認後に修正する。 depends-on 検証、coverage チェック、business-rule/architecture の未文書化知識検出、 readme/CLAUDE.md のメタ整合検査を行う。/doc-audit で起動、または大規模なコード変更後に ドキュメント整合性を確認したい時に使用する。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
AI が実装した変更の「受け入れ判定」を1画面で行うためのレビューパックを生成する。 diff 要約・テスト/リンタ実行証跡・リスクフラグ・Verification Contract 準拠状況を 1つのレポートに集約し、APPROVE / REWORK の判断材料を揃える。 実装完了後・コミット前・PR 作成前のレビュー依頼時、または /review-pack で起動。
現在のセッションで行った作業・決定事項・アーキテクチャ変更を project-state.json に記録し、 handover.md を生成する。コンテキスト圧縮の直前、/handover の明示呼び出し、 ツール呼び出し累計 50 回超過時、または応答が遅延した時に使用する。
Linear チケットの棚卸し・構造整理・未登録ソース発見を Collect/Discover/Analyze/Approve/Execute の 5 ステップで一気通貫実行する。 既存の外部リンク探索に加え、Slack/GitHub のキーワード検索と逆引きで未紐付きの 外部ソースも発見する。定期的な Linear メンテナンス、または「棚卸し」「リフレッシュ」 「整理」の依頼時に使用する。
Slack CLI: Send messages, read conversations, search, and manage Slack workspaces from the terminal. Use when the user asks anything related to Slack — sending messages, checking unreads, searching conversations, or managing workspaces. Also trigger when a Slack URL is provided (e.g., https://*.slack.com/archives/*, app.slack.com/*) or when the conversation context mentions Slack threads, channels, or messages.
前セッションの project-state.json から未完了タスク（in_progress/blocked）を特定し、 ユーザー承認後に作業を再開する。/continue の明示呼び出し、"continue from handover" のような継続指示、handover.md への言及を検出した時に使用する。worktree 切り替えと Pipeline Detection も含む。
URL（Slack/GitHub/その他）から情報収集→周辺コンテキスト探索→分析→Linear Issue 登録を行う初動対応ワークフロー。 問い合わせやバグ報告のトリアージに使用する。
| name | doc-audit |
| description | md ドキュメントの陳腐化・欠落・矛盾を 4 Layer 構造で検出し、ユーザー承認後に修正する。 depends-on 検証、coverage チェック、business-rule/architecture の未文書化知識検出、 readme/CLAUDE.md のメタ整合検査を行う。/doc-audit で起動、または大規模なコード変更後に ドキュメント整合性を確認したい時に使用する。 |
ドキュメント監査スキル。4 Layer 構造でドキュメントの陳腐化・欠落・矛盾を検出し、ユーザー承認後に修正する。
/doc-audit の引数で実行モードを指定する。
| 引数 | 動作 |
|---|---|
| (なし) | Scope B（全体棚卸し）で全 Layer 実行 |
--deps | depends-on 検証のみ（Layer 1 + deps-analyzer） |
--hygiene | 衛生チェックのみ（Layer 1 + coherence-analyzer） |
--coverage | ドキュメント欠落検出のみ（Layer 0 + Layer 1 + coverage-analyzer） |
--knowledge | 未文書化知識検出のみ（Layer 0 + business-rule + architecture） |
--meta | メタドキュメント検査のみ（readme-analyzer + claude-md-analyzer） |
--range <commit>..<commit> | commit 範囲に限定（Scope A 相当） |
--full | 全 md 対象（デフォルト） |
--swarm | エージェントチーム構成で実行 |
既存の並列探索エージェントをドキュメント観点の入力スコープで起動する:
code-explorer: git diff 変更ファイル起点のコードフロー → 公開インターフェース特定
code-architect: プロジェクト構造 + CLAUDE.md → アーキテクチャパターン全体像
impact-analyzer: git diff 逆依存 → depends-on 未宣言のドキュメント候補
--swarm 有効時は Exploration Team（TeamCreate）で実行。--deps/--hygiene モードではスキップ。
スキルディレクトリからの相対パスで実行:
# 全 md 対象
bash "$(dirname "$SKILL_PATH")/scripts/doc-audit.sh" --full --json
# commit 範囲指定
bash "$(dirname "$SKILL_PATH")/scripts/doc-audit.sh" --range HEAD~5..HEAD --json
# undeclared チェックのみ（Audit Gate 再検証用）
bash "$(dirname "$SKILL_PATH")/scripts/doc-audit.sh" --check-undeclared --json
Layer 1 の JSON 結果 + Layer 0 の探索結果をエージェントにフィードする。
構造系:
知識系:
--swarm 有効時は7エージェントを Audit Team（TeamCreate）で実行し、メンバー間相互検証を行う。
非 swarm 時は並列 Agent 呼び出し。
統合レポートをユーザーに提示し、各 finding について:
deps_fix: depends-on を Edit で修正content_update: /doc-check に委譲new_doc: feature-implementer エージェントでドキュメント新規作成delete: ユーザー確認後にファイル削除merge: ユーザー確認後にドキュメント統合depends-on 修正後、自動的に /doc-check を実行して内容更新を行う:
depends-on 修正完了
↓
/doc-check 実行（修正済み depends-on で影響検出）
↓
影響ドキュメントの内容更新
↓
新規ドキュメント作成（fix_type=new_doc の findings）
↓
doc-audit.sh --check-undeclared（新規ドキュメントの整合性確認）
one-shot 実行時は doc-check 連携は推奨のみ（自動実行しない）。
/feature-dev --doc で doc-audit フェーズとして実行される。詳細は feature-dev SKILL.md を参照。