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向けのルール文書を書く時の心得
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일 업데이트