| name | doc-maintainer |
| description | AI向けマークダウンドキュメント（SKILL.md、AGENTS.md、.agent/*.md など）の健全性チェックと修正を支援するスキル。「ドキュメントの整合性を確認」「SSOT違反を探す」「スキル定義をメンテしたい」「PRの概要を更新したい」と依頼されたときに使用する。 |
Doc Maintainer
このファイルは Codex 実行用の入口とメタデータを管理する。
手順本文の正本は .claude/skills/doc-maintainer/SKILL.md に置く。
AI向けドキュメントの SSOT 違反・表記ゆれ・構造問題を検出・修正する。
PR 概要とコミット差分の乖離チェックも扱う。
参照順
AGENTS.md.claude/skills/doc-maintainer/SKILL.md.agent/PLANS.md.agent/roadmap.md- 関連する
SKILL.md / AGENTS.md / .agent/*.md
- PR 関連作業では
.github/codex-pr-rules.md
実行ルール
- ドキュメントの正本を尊重し、重複修正ではなく SSOT へ寄せる。
- 修正前に参照元と参照先の責務分担を確認する。
- パス表記はリポジトリルート基準で統一し、既存ルールがある場合はそれに従う。
- 番号付き手順は途中で見出しを挟まず、補足が必要なら本文へ吸収する。
- PR 更新系操作は、必ずユーザー確認を取った場合のみ実行する。
コマンド
/doc-audit [対象]
詳細な手順は .claude/skills/doc-maintainer/SKILL.md の /doc-audit を参照。
/doc-fix <問題番号|説明>
詳細な手順は .claude/skills/doc-maintainer/SKILL.md の /doc-fix を参照。
/pr-sync <PR番号>
詳細な手順は .claude/skills/doc-maintainer/SKILL.md の /pr-sync を参照。
/pr-sync <PR番号> は、実行前に必ず はい・いいえ で確認し、はい の場合のみ進める。
出力形式
/doc-audit は問題一覧を重大度順に並べ、種別 / 重大度 / ファイル:行番号 / 内容 / 修正方針 を含める。/doc-fix は修正対象、適用内容、残件有無、必要ならコミットメッセージ案を簡潔に示す。/pr-sync は乖離箇所、更新案、ユーザー確認要否を分けて示す。
