Skip to content
cccskills
FreePublished on GitHub

persistent-instructions

CLAUDE.mdやAGENTS.mdのように、AIが作業の前に毎回読む行動のルール文書を書く時の心得。何を書き、何を書かないか、制約の文体、置き場所を定める。ルール文書を作る時、編集する時、他所から規則を取り込む時、レビュー指摘の採否を決める時に読み込む。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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の中だけで使う手順の文書に、同じ制約を再掲しない。

Reviews

No reviews yet. Tell others what you thought.

Comments

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.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準を定める。AIが読んで従う文書に共通の心得は、kuden:common-rules-for-agent-instructionsにある。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。

The English summary is being prepared. Showing the original description.

shokai/agent-skills30Updated Oct 19, 2026

ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。

The English summary is being prepared. Showing the original description.

shokai/agent-skills30Updated Oct 19, 2026

リポジトリのセキュリティ調査を領域ごとに進める。同じサービスを構成する複数のリポジトリを束ねて調査できる。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。

The English summary is being prepared. Showing the original description.

shokai/agent-skills30Updated Oct 19, 2026

セキュリティ調査で検出された問題を1つ修正し、pull requestをready for reviewまで仕上げる。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。

The English summary is being prepared. Showing the original description.

shokai/agent-skills30Updated Oct 19, 2026

本番に出る前の修正が積まれたrelease pull requestに、デプロイの前後に人間がやる事をまとめたコメントを投稿・更新する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。

The English summary is being prepared. Showing the original description.

shokai/agent-skills30Updated Oct 19, 2026

リポジトリの1つの領域をセキュリティ観点で調査し、Codexの批判的レビューを経てレポートを出力する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。

The English summary is being prepared. Showing the original description.

shokai/agent-skills30Updated Oct 19, 2026

See all skills by shokai

Report a problem with this skill