Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準を定める。AIが読んで従う文書に共通の心得は、kuden:common-rules-for-agent-instructionsにある。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 21일 업데이트
무료GitHub에 공개
user-decision
AIがユーザーの判断を得る時の心得。質問の前に何を説明するか、何をどう訊くか、回答が無い時の扱い、ユーザーが判断した根拠の報告に誤りがあった時の扱いを定める。決めきれない事をユーザーに訊く時、計画を書く時、調査の結果として新しい方向を提案する時、質問に回答が無いまま進めようとしている時、以前の報告の誤りに気付いた時に読み込む。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기포함된 파일(1)
- SKILL.md3.5 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
ユーザーの判断を得る時の心得
決めきれない事をユーザーに訊く時、計画を書く時、新しい方向を提案する時、質問に回答が無い時、以前の報告の誤りに気付いた時は、以下の基準に従う。
心得1. 質問の前に、判断に要る事を説明する
- 調査やレビューで新しく見つけた問題への対応を訊く時は、先に本文で、判断に必要な前提、問題が起きる仕組み、各対応案の帰結を説明し、その後に選択肢を出す。会話に出ていない新事実は、選択肢の短い説明だけでは判断できない
- 決定の対象になる専門用語は、何であるか、どういう時に生じるか、今回の件とどう関係するかを先に書く
- レビューの指摘を要約して伝える時も、影響範囲を省かない
- 既に会話で説明済みの事の確認なら、選択肢だけでよい
心得2. 不明点は、計画を書く前にまとめて訊く
調査が済んだら、決めきれない点を列挙し、1回にまとめて訊く。回答が出揃ってから計画を書く。計画に埋め込んだ判断はユーザーが読み飛ばしうる。計画の承認は「この通り実装してよいか」の確認であり、設計の選択肢を訊く場ではない。
心得3. 派生した改善が増えたら、最小案のgo/no-goだけを訊く
依頼の核心を満たす最小の変更案を出す。派生した改善は「先送り」として1行ずつ並べるだけにし、訊くのは最小案のgo/no-goだけにする。
心得4. 新しい提案は、採否を訊く
調査の結果として新しい方向を提案する時、「この方向で合っていますか」と訊かない。「Xを使うとこの構成になる。Xを採用するか」と採否を問う。「合っていますか」は、ユーザーが正解を持っていて答え合わせをしているという枠組みを与える。「合っていますか」を使ってよいのは、ユーザーが既に決めた方針を再確認する時だけである。提案の出所が自分か、外部Agentの指摘かも明示する。
心得5. 未回答は一任ではない
質問を流されたり、回答の代わりに前提の補足で割り込まれたりした時、一任と解釈して自分で決めない。何が未回答かを列挙し、現状の数値、影響範囲、既存コードの前例のような判断材料を本文に補ってから訊き直す。
心得6. 報告の誤りに気付いたら、その報告に基づく決定を選び直してもらう
報告に誤りがあり、ユーザーがその報告に基づいて決定した後に気付いた時、訂正を添えてそのまま進めない。根拠が崩れた決定は未決定に戻る。一次情報で事実を確かめ直し、計画とは分けて訂正を報告し、影響を受ける決定を選び直してもらう。
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 21일 업데이트
リポジトリのセキュリティ調査を領域ごとに進める。同じサービスを構成する複数のリポジトリを束ねて調査できる。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 21일 업데이트
セキュリティ調査で検出された問題を1つ修正し、pull requestをready for reviewまで仕上げる。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 21일 업데이트
本番に出る前の修正が積まれたrelease pull requestに、デプロイの前後に人間がやる事をまとめたコメントを投稿・更新する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 21일 업데이트
リポジトリの1つの領域をセキュリティ観点で調査し、Codexの批判的レビューを経てレポートを出力する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
shokai/agent-skills302026년 10월 21일 업데이트