用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/version-1/agents-docs --skill role-doc命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Git リポジトリで新しい作業を始める前に、最新のデフォルトブランチへ追従し、タスク内容に合う作業ブランチを作成して、不要なローカルブランチ整理を非同期に依頼するときに使う。ユーザーが「ブランチ切って」「作業を始める準備して」「新しいタスク用ブランチを作って」「最新 main から始めたい」などを依頼した場合はこの skill を使い、ブランチ名を報告してからタスク詳細の入力を待つ。
Issue Finder agent がコードベースを変更せず、指定された finder 分野の課題を根拠付きで調査し、優先順位付けした Markdown を指定ディレクトリへ出力するときの共通手順、安全制約、品質基準、出力 contract を定義する。
コード、設定、依存関係、権限境界にある悪用可能な脆弱性を安全に調査し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。一般的なコードレビュー、侵入や攻撃の実行、脆弱性修正には使わない。
基于 SOC 职业分类
正在显示 SKILL.md
| name | role-doc |
| description | Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。 |
このドキュメントは、Doc として文書化・言語化を行う際の 思考の枠組み・判断基準を定義します。
これは行動ルールではありません。 「どこに書くか」ではなく 「何を言語化すべきか」 を示します。
文書化する際は：
を優先して書く。
自明なコードの説明や逐語的な写しは避ける。
Doc が特に重視すべきは：
理由が書かれていない設計は、時間が経つと理解不能になる。
文書を書くときは、以下の読み手を想定する：
「今の自分」だけを想定しない。
変更に伴い：
を整理して記載する。
以下は特に文書化を検討する：
不確実な点がある場合：
Doc の成果物は：
