Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準を定める。AIが読んで従う文書に共通の心得は、kuden:common-rules-for-agent-instructionsにある。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 19일 업데이트
무료GitHub에 공개
common-rules-for-agent-instructions
Agent SkillやCLAUDE.md・AGENTS.mdのように、AIが読んで従う文書を書く時に共通の心得。読み手の前提、何を書かないか、編集の仕方、レビュー指摘の採否を定める。kuden:agent-skillとkuden:persistent-instructionsの両方から参照される。
AIが読んで従う文書を作る時、編集する時、レビュー指摘の採否を決める時に読み込む。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기포함된 파일(1)
- SKILL.md3.1 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
AI向けの文書に共通の心得
Agent SkillやCLAUDE.md・AGENTS.mdのように、AIが読んで従う文書を書く時は、以下の基準に従う。kuden:agent-skill skillとkuden:persistent-instructions skillに共通の心得で、Agent Skillに固有の基準はkuden:agent-skill skillに、ルール文書に固有の基準はkuden:persistent-instructions skillにある。
心得1. 読み手は賢いmodelである
文書を読んで実行するのは、文脈を読んで自分で判断できるmodelである。書くのは、modelが推論では到達できない事だけにする。プロジェクトや作者に固有の方針、隠れた制約、外からは見えない前提、やってみないと分からないgotchaがこれに当たる。
- 考えれば分かる判断を、防御的に明文化しない。edge caseの除外規定や、誤読を防ぐための但し書きを足さない
- 読解力の低いmodelに合わせて設計しない。文脈を読み取れないmodelは、文書が求める他の作業も実行できない
- 手順か例で目的が達成できるなら、背景説明を書かない。インシデントの話や、避けたい結果の説明がこれに当たる。gitの一般的な性質のように、考えれば分かる理由も書かない
- 比喩を書かない。読み手が比喩の別の側面を推論し、文の意味が曖昧になる
心得2. 実行するmodelに向けた事だけを書く
その方法を選んだ経緯や、試して却下した案は、commit messageやPR概要欄に書く。
心得3. 編集する時は、全体としての最善を目指す
既存の文書に手を入れる時、変更差分を小さく保とうとしない。足す内容を既存の節の末尾に継ぎ足すのではなく、その内容が最初からあったらどう書いたかを考える。構成を大きく変えて構わない。
心得4. レビュー指摘の採否
外部Agentやsubagentの指摘は、事実として正しくても、文書に書く価値があるとは限らない。指摘が正しいかの検証とは別に、採否を以下の問いで決める。
- 問1. 賢いmodelなら、その場で判断できる事ではないか
- 問2. 対象の文書の種類に固有の心得が、書かないと定めた物ではないか
- 問3. 実行するmodelではなく、将来の編集者に向けた事ではないか
- 問4. それが無いと、modelが実行に行き詰まる事ではないか
問1から問3に当たる指摘は採用しない。問4に当たる指摘は採用する。
採用しなかった指摘は、理由を添えてユーザーに報告する。
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
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일 업데이트