Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準を定める。AIが読んで従う文書に共通の心得は、kuden:common-rules-for-agent-instructionsにある。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。
中文简介正在准备中。当前显示原文说明。
shokai/agent-skills302026年10月19日 更新
免费在 GitHub 公开
persistent-instructions
CLAUDE.mdやAGENTS.mdのように、AIが作業の前に毎回読む行動のルール文書を書く時の心得。何を書き、何を書かないか、制約の文体、置き場所を定める。ルール文書を作る時、編集する時、他所から規則を取り込む時、レビュー指摘の採否を決める時に読み込む。
中文简介正在准备中。当前显示原文说明。
查看安装方法包含的文件（1）
- SKILL.md2.6 KB
SKILL.md（原文）
安装前可以查看交给 AI 代理的指令内容。
AI向けのルール文書を書く時の心得
CLAUDE.mdやAGENTS.mdのように、AIが作業の前に毎回読む行動のルール文書を作る時、編集する時、他所から規則を取り込む時は、kuden:common-rules-for-agent-instructions skillを読み込み、その基準に加えて、以下の基準に従う。Agent Skillは、kuden:agent-skill skillの基準に従う。
心得1. 制約だけを書く
既定の挙動を制限・誘導する規則だけを書く。禁止が無ければ当然できる事を、許可として書かない。
心得2. 制約の文体は、提案を求めるかどうかで選ぶ
- 必要になった時にAIから提案してほしい操作は、「勝手に行わない。必要だと判断した時は、実行せずに提案して指示を仰ぐ」と書く。commit済みの履歴を書き換える操作がこれに当たる
- ユーザーの発意に委ねる操作は、「ユーザーの指示を待つ」と書く。pushがこれに当たる
心得3. 制約を作業の一場面に限定しない
操作全体に効かせる制約を、「Zの後のXは指示を待つ」のように作業の一場面に限定しない。開発の流れは一様ではなく、特定の場面を前提にした規則は、その前提から外れた流れで噛み合わなくなる。
心得4. 背景説明・理由を書かない
- 他所の文書から規則を取り込む時は、元に無い文を足さない
- 「〜しないと古くなる」のような理由を書かない。規則の効力を増やさず、逸脱した読み手への説教にしかならない
- 見出しや参照元で既に示したスコープを、冒頭で繰り返さない
- draftは仕上げている途中の状態、ready for reviewは人間にレビューを依頼できる状態、のような状態の定義は書いてよい。規則の意味を定める
心得5. 同じrepoの中で、制約を2箇所に書かない
repoの中の制約は、毎回読まれるルール文書の1箇所に書く。そのルール文書と一緒に読まれる、そのrepoの中だけで使う手順の文書に、同じ制約を再掲しない。
评价
还没有评价。欢迎分享你的使用感受。
评论
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
同一仓库的技能
ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。
中文简介正在准备中。当前显示原文说明。
shokai/agent-skills302026年10月19日 更新
リポジトリのセキュリティ調査を領域ごとに進める。同じサービスを構成する複数のリポジトリを束ねて調査できる。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。
中文简介正在准备中。当前显示原文说明。
shokai/agent-skills302026年10月19日 更新
セキュリティ調査で検出された問題を1つ修正し、pull requestをready for reviewまで仕上げる。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
中文简介正在准备中。当前显示原文说明。
shokai/agent-skills302026年10月19日 更新
本番に出る前の修正が積まれたrelease pull requestに、デプロイの前後に人間がやる事をまとめたコメントを投稿・更新する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
中文简介正在准备中。当前显示原文说明。
shokai/agent-skills302026年10月19日 更新
リポジトリの1つの領域をセキュリティ観点で調査し、Codexの批判的レビューを経てレポートを出力する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
中文简介正在准备中。当前显示原文说明。
shokai/agent-skills302026年10月19日 更新