Agent SkillやCLAUDE.md・AGENTS.mdのように、AIが読んで従う文書を書く時に共通の心得。読み手の前提、何を書かないか、編集の仕方、レビュー指摘の採否を定める。kuden:agent-skillとkuden:persistent-instructionsの両方から参照される。
AIが読んで従う文書を作る時、編集する時、レビュー指摘の採否を決める時に読み込む。
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
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にある。
文書を読んで実行するのは、文脈を読んで自分で判断できるmodelである。書くのは、modelが推論では到達できない事だけにする。プロジェクトや作者に固有の方針、隠れた制約、外からは見えない前提、やってみないと分からないgotchaがこれに当たる。
その方法を選んだ経緯や、試して却下した案は、commit messageやPR概要欄に書く。
既存の文書に手を入れる時、変更差分を小さく保とうとしない。足す内容を既存の節の末尾に継ぎ足すのではなく、その内容が最初からあったらどう書いたかを考える。構成を大きく変えて構わない。
外部Agentやsubagentの指摘は、事実として正しくても、文書に書く価値があるとは限らない。指摘が正しいかの検証とは別に、採否を以下の問いで決める。
問1から問3に当たる指摘は採用しない。問4に当たる指摘は採用する。
採用しなかった指摘は、理由を添えてユーザーに報告する。
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.