write-skill

エージェント向けの文章作成は、テキストにテストファースト開発を適用することです。スキル、AGENTS.md、CLAUDE.md、システムプロンプトなど、エージェントが読むすべてのドキュメントは、同じループで作成します。

1. まずベースラインを実行します。ドキュメントが対象とするシナリオを、そのドキュメントを読み込ませずにエージェントで実行します。どのように失敗したのか、あるいはどんな言い訳をしたのかを正確に記録します。AGENTS.md などのスキルやコンテキストファイルを一切読み込まない、新しいサブエージェントでベースラインを実行します。エージェントのベースシステムプロンプトはそのままにします。エージェントでそのようなサブエージェントを開始できない場合は、スキルやコンテキストファイルを読み込まない新しいセッションを使います。失敗が見られない場合、そのドキュメントに教えるべきことはありません。
2. 具体的な失敗を修正するために必要な最小限のテキストを書きます。マニュアルは書かず、動作を変える最短の手順を書きます。
3. ドキュメントを読み込ませて、もう一度シナリオを実行します。成功しなければ、ドキュメントに問題があります。
4. 抜け穴を塞ぎます。新しい実行で新たな言い訳が見つかったら、テキストでそれを防ぎ、再度確認します。

ルール：

• 評価スクリプトが変えるのは実行方法であり、ループではありません。評価スクリプトがある場合は、ベースラインと2回目の実行を行います。
• ユーザーが同じ修正を2回行った場合、その教訓は定着していません。教訓を構造に組み込むを読んでください。その問題を解決できる最も高いレベルで修正します。テキストより先に仕組みを見直します。どの仕組みでも防げないものだけが、手順1〜4の対象です。
• このリポジトリのスキルについてドキュメントを作成する場合は、このリポジトリのスキル規約に従います。
• 一度限りの作業や、標準的な慣行がすでに十分に文書化されている場合は、このスキルを使いません。リンターやフックでルールを適用できる場合も使いません。その場合は、教訓を構造に組み込むの説明に従って、リンターやフックを作成します。