AI向けマークダウンドキュメント（SKILL.md、AGENTS.md、.agent/*.md など）の健全性チェックと修正を支援するスキル。「ドキュメントの整合性を確認」「SSOT違反を探す」「スキル定義をメンテしたい」「PRの概要を更新したい」と依頼されたときに使用する。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
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 は乖離箇所、更新案、ユーザー確認要否を分けて示す。아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
改修後の動作確認を、AIが自分で環境を立てて最後まで進めるための検証スキル。CLI（curl / php evo / DB）を優先し、画面操作でしか判定できないときだけ Playwright（既定はヘッドレス）に切り替える。Docker の検証環境の起動、インストール、テスト用ユーザー作成、mailpit でのメール確認、main との比較、後片付けまでを扱う。「動作確認」「自走で確認」「実環境で確かめる」「ブラウザで確認」「再現を確認」「Playwright」と依頼されたとき、または修正のあとに実機での裏付けが必要なときに使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
非公開のセキュリティアドバイザリ（下書き）で扱う修正を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → 一時的な非公開フォークへの push → フォーク内の PR」まで進めるスキル。`/run-advisory <GHSA-ID> <計画のパス>` を提供する。ユーザーが「/run-advisory」「アドバイザリを自走で直して」「非公開フォークで修正を進めて」と依頼したときに使う。公開の Issue や ExecPlan を回すなら exec-plan-runner を使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
`.agent/agents/` のエージェント定義を入口に、タスクを調査・計画・実装・レビュー・検証へ分担するスキル。ユーザーが「エージェント」「マルチエージェント」「orchestrator」「役割分担」「複数担当」などを求めたとき、または大きな変更で担当境界を決める必要があるときに使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
ExecPlan（実行計画）の作成・検証・更新を支援するスキル。複雑なタスク（新機能開発、リファクタリング、バグ修正）の設計フェーズで使用します。`/create-plan`でプラン作成を開始。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Issue または ExecPlan を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → push → PR」まで役割を分けて進めるスキル。`/run-issue <番号>`・`/run-plan <ExecPlan のパス>`・`/finish-task` を提供する。ユーザーが「/run-issue」「/run-plan」「Issue を自走で直して」「ExecPlan を最後まで進めて」「0 節の Issue を順に片付けて」と依頼したときに使う。ExecPlan を作るだけなら exec-plan、次のタスクを選ぶだけなら roadmap-manager を使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Issue または ExecPlan を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → push → PR」まで進めるスキル。`/run-issue <番号>`・`/run-plan <ExecPlan のパス>`・`/finish-task` を提供する。ユーザーが「/run-issue」「/run-plan」「Issue を自走で直して」「ExecPlan を最後まで進めて」「0 節の Issue を順に片付けて」と依頼したときに使う。ExecPlan を作るだけなら exec-plan、次のタスクを選ぶだけなら roadmap-manager を使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.