AIがユーザーの判断を得る時の心得。質問の前に何を説明するか、何をどう訊くか、回答が無い時の扱い、ユーザーが判断した根拠の報告に誤りがあった時の扱いを定める。決めきれない事をユーザーに訊く時、計画を書く時、調査の結果として新しい方向を提案する時、質問に回答が無いまま進めようとしている時、以前の報告の誤りに気付いた時に読み込む。
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
決めきれない事をユーザーに訊く時、計画を書く時、新しい方向を提案する時、質問に回答が無い時、以前の報告の誤りに気付いた時は、以下の基準に従う。
調査が済んだら、決めきれない点を列挙し、1回にまとめて訊く。回答が出揃ってから計画を書く。計画に埋め込んだ判断はユーザーが読み飛ばしうる。計画の承認は「この通り実装してよいか」の確認であり、設計の選択肢を訊く場ではない。
依頼の核心を満たす最小の変更案を出す。派生した改善は「先送り」として1行ずつ並べるだけにし、訊くのは最小案のgo/no-goだけにする。
調査の結果として新しい方向を提案する時、「この方向で合っていますか」と訊かない。「Xを使うとこの構成になる。Xを採用するか」と採否を問う。「合っていますか」は、ユーザーが正解を持っていて答え合わせをしているという枠組みを与える。「合っていますか」を使ってよいのは、ユーザーが既に決めた方針を再確認する時だけである。提案の出所が自分か、外部Agentの指摘かも明示する。
質問を流されたり、回答の代わりに前提の補足で割り込まれたりした時、一任と解釈して自分で決めない。何が未回答かを列挙し、現状の数値、影響範囲、既存コードの前例のような判断材料を本文に補ってから訊き直す。
報告に誤りがあり、ユーザーがその報告に基づいて決定した後に気付いた時、訂正を添えてそのまま進めない。根拠が崩れた決定は未決定に戻る。一次情報で事実を確かめ直し、計画とは分けて訂正を報告し、影響を受ける決定を選び直してもらう。
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準を定める。AIが読んで従う文書に共通の心得は、kuden:common-rules-for-agent-instructionsにある。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。
The English summary is being prepared. Showing the original description.
ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。
The English summary is being prepared. Showing the original description.
リポジトリのセキュリティ調査を領域ごとに進める。同じサービスを構成する複数のリポジトリを束ねて調査できる。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。
The English summary is being prepared. Showing the original description.
セキュリティ調査で検出された問題を1つ修正し、pull requestをready for reviewまで仕上げる。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.
本番に出る前の修正が積まれたrelease pull requestに、デプロイの前後に人間がやる事をまとめたコメントを投稿・更新する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.
リポジトリの1つの領域をセキュリティ観点で調査し、Codexの批判的レビューを経てレポートを出力する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.