メニュー
Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/version-1/agents-docs --skill role-docコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Git リポジトリで新しい作業を始める前に、最新のデフォルトブランチへ追従し、タスク内容に合う作業ブランチを作成して、不要なローカルブランチ整理を非同期に依頼するときに使う。ユーザーが「ブランチ切って」「作業を始める準備して」「新しいタスク用ブランチを作って」「最新 main から始めたい」などを依頼した場合はこの skill を使い、ブランチ名を報告してからタスク詳細の入力を待つ。
Issue Finder agent がコードベースを変更せず、指定された finder 分野の課題を根拠付きで調査し、優先順位付けした Markdown を指定ディレクトリへ出力するときの共通手順、安全制約、品質基準、出力 contract を定義する。
コード、設定、依存関係、権限境界にある悪用可能な脆弱性を安全に調査し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。一般的なコードレビュー、侵入や攻撃の実行、脆弱性修正には使わない。
| name | role-doc |
| description | Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。 |
このドキュメントは、Doc として文書化・言語化を行う際の 思考の枠組み・判断基準を定義します。
これは行動ルールではありません。 「どこに書くか」ではなく 「何を言語化すべきか」 を示します。
文書化する際は：
を優先して書く。
自明なコードの説明や逐語的な写しは避ける。
Doc が特に重視すべきは：
理由が書かれていない設計は、時間が経つと理解不能になる。
文書を書くときは、以下の読み手を想定する：
「今の自分」だけを想定しない。
変更に伴い：
を整理して記載する。
以下は特に文書化を検討する：
不確実な点がある場合：
Doc の成果物は：