AI向けマークダウンドキュメント（SKILL.md、AGENTS.md、.agent/*.md など）の健全性チェックと修正を支援するスキル。「ドキュメントの整合性を確認」「SSOT違反を探す」「スキル定義をメンテしたい」「PRの概要を更新したい」と依頼されたときに使用する。
The English summary is being prepared. Showing the original description.
Review the instructions the agent will receive before you install.
AI向けドキュメントの SSOT 違反・表記ゆれ・構造問題を検出・修正する。PR概要とコミット差分の乖離チェックも行う。
exec-plan-runner から呼ばれたときは、このスキルの確認と Status の扱いより、.claude/skills/exec-plan-runner/SKILL.md の「確認を省く範囲」を優先する（「スキップ禁止」と書かれた確認も、表にあれば省く。runner の「省かないもの」は省かない）。
AGENTS.md.agent/PLANS.md.agent/roadmap.mdSKILL.md / AGENTS.md / .agent/*.md.github/codex-pr-rules.md/doc-audit 対象）| 種別 | 内容 | 例 |
|---|---|---|
| SSOT違反 | 同じ内容が複数ファイルに存在する | awk スクリプトが SKILL.md と参照先 docs の両方にある |
| パス表記ゆれ | ファイル名のみ・短縮パス vs リポジトリルートからのフルパスが混在 | doc-maintainer/SKILL.md vs .claude/skills/doc-maintainer/SKILL.md |
| 構造問題 | 番号付きリストの途中に見出しが入る | 手順3の補足として H3 を置いてリストが途切れる |
| 無効参照 | 記述されたファイルパスや見出し名が存在しない | ExecPlan パスが archive 前のまま、削除した見出しへの参照が残る |
| バージョン表記ゆれ | 同一ドキュメント内でバージョン形式が混在 | vX.X.X と release-1.3.0J が同じファイルに混在 |
| フォーマット違反 | ロードマップ項目の必須フィールド欠落 | 完了日: 行がないタスク |
| 言語一貫性 | LLM制約ファイル内で記述言語が混在する | codex-pr-rules.md が英語ベースで日本語箇条書きが混在 |
| Decision Log 齟齬 | ExecPlan の Decision Log が実装済み内容と矛盾する | 「PRマージ後に対応」と記載されているが既に実装済み |
/doc-audit [対象]対象ディレクトリ・ファイルを走査してチェック項目を検査し、問題を一覧表示する。
対象省略時は .claude/skills/、AGENTS.md、CLAUDE.md、.agent/roadmap.md、.agent/PLANS.md を対象とする。
推奨タイミング: ドキュメントファイルを変更したコミット前に実行し、Copilot レビューで指摘される前に問題を解消する。
手順:
/doc-fix <問題番号|説明>/doc-audit で検出した問題を修正する。
手順:
/pr-sync <PR番号>PR概要（Summary・Test plan）と実際のコミット差分を照合し、乖離を検出・更新する。
コミットを重ねるうちに概要が古くなった場合や、PR作成後に方針が変わった場合に使う。
手順:
/pr-sync <PR番号> を実行するか？ はい・いいえ」で確認するはい の場合のみ、gh pr view <PR番号> --json body で現在の PR 概要を取得するgh pr diff <PR番号> または git log <base>..HEAD --oneline で実際の変更内容を確認するgh pr edit <PR番号> --body "..." で更新する推奨タイミング: PR 作成後、追加コミットのたびに実行する。作成直後は本文と差分がずれようがないので実行しない。
/doc-audit は問題一覧を重大度順に並べ、種別 / 重大度 / ファイル:行番号 / 内容 / 修正方針 を含める。/doc-fix は修正対象、適用内容、残件有無、必要ならコミットメッセージ案を簡潔に示す。/pr-sync は乖離箇所、更新案、ユーザー確認要否を分けて示す。No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
改修後の動作確認を、AIが自分で環境を立てて最後まで進めるための検証スキル。CLI（curl / php evo / DB）を優先し、画面操作でしか判定できないときだけ Playwright（既定はヘッドレス）に切り替える。Docker の検証環境の起動、インストール、テスト用ユーザー作成、mailpit でのメール確認、main との比較、後片付けまでを扱う。「動作確認」「自走で確認」「実環境で確かめる」「ブラウザで確認」「再現を確認」「Playwright」と依頼されたとき、または修正のあとに実機での裏付けが必要なときに使う。
The English summary is being prepared. Showing the original description.
非公開のセキュリティアドバイザリ（下書き）で扱う修正を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → 一時的な非公開フォークへの push → フォーク内の PR」まで進めるスキル。`/run-advisory <GHSA-ID> <計画のパス>` を提供する。ユーザーが「/run-advisory」「アドバイザリを自走で直して」「非公開フォークで修正を進めて」と依頼したときに使う。公開の Issue や ExecPlan を回すなら exec-plan-runner を使う。
The English summary is being prepared. Showing the original description.
`.agent/agents/` のエージェント定義を入口に、タスクを調査・計画・実装・レビュー・検証へ分担するスキル。ユーザーが「エージェント」「マルチエージェント」「orchestrator」「役割分担」「複数担当」などを求めたとき、または大きな変更で担当境界を決める必要があるときに使う。
The English summary is being prepared. Showing the original description.
ExecPlan（実行計画）の作成・検証・更新を支援するスキル。複雑なタスク（新機能開発、リファクタリング、バグ修正）の設計フェーズで使用します。`/create-plan`でプラン作成を開始。
The English summary is being prepared. Showing the original description.
Issue または ExecPlan を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → push → PR」まで進めるスキル。`/run-issue <番号>`・`/run-plan <ExecPlan のパス>`・`/finish-task` を提供する。ユーザーが「/run-issue」「/run-plan」「Issue を自走で直して」「ExecPlan を最後まで進めて」「0 節の Issue を順に片付けて」と依頼したときに使う。ExecPlan を作るだけなら exec-plan、次のタスクを選ぶだけなら roadmap-manager を使う。
The English summary is being prepared. Showing the original description.
Issue または ExecPlan を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → push → PR」まで役割を分けて進めるスキル。`/run-issue <番号>`・`/run-plan <ExecPlan のパス>`・`/finish-task` を提供する。ユーザーが「/run-issue」「/run-plan」「Issue を自走で直して」「ExecPlan を最後まで進めて」「0 節の Issue を順に片付けて」と依頼したときに使う。ExecPlan を作るだけなら exec-plan、次のタスクを選ぶだけなら roadmap-manager を使う。
The English summary is being prepared. Showing the original description.