القائمة
Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام 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 の成果物は：
