correct について
Correctは、エージェントが同じミスを繰り返すリポジトリ向けの保守スキルです。再発する誤りを、アーキテクチャ、型、Lint、CI、テストによる防止策に変え、規則と検証結果を記録します。
主な機能
- 01繰り返すミスのパターンを分類
- 02有効な最上位レベルで修正
- 03型・チェック・テストを追加
- 04過去のミスを検出できるか検証
- 05規則と適用方法の表を維持
活用シーン
- 01エージェントの同じミスを防止
- 02レビュー指摘をリポジトリの防止策に反映
- 03既知の回帰でチェックを検証
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ q-qp-p/ pstack --skill correctインストール後、Claude Code で/correctを入力して読み込まれたか確認します。
詳細
修正する
このリポジトリでは、オペレーターがエージェントに同じミスを何度も指摘しています。次のエージェントが同じミスをしないように、リポジトリを変更してください。
すべてのコントリビューターは、開いたファイルだけを参照し、最も近い例をコピーして、コンパイルできる最短の道を選ぶエージェントだと想定してください。あるファイルだけを見れば正しそうな変更が、リポジトリ全体でも正しくなるように設計してください。
ミスの種類を特定する
まず、最近のコミット、リバート、レビューコメント、エージェント向け指示ファイル、回避策の理由を説明するコメントを読んでください。ミスを種類ごとに分類してください。同じ種類のミスが2回発生していれば、分類対象とします。
各種類を、機能する最も高いレベルで修正する
- アーキテクチャで排除します。 各状態に単一の所有者を設け、各タスクにサポートされる方法を一つだけ用意します。内部実装を隠し、誤ったインポートは失敗するようにします。手動で同期しているリストを単一の信頼できる情報源に置き換えます。古いやり方や、エージェントがコピーしそうな不要なコードは削除します。
- 誤った状態を書き込めないよう、型で強制します。 不適切なコードがまだコンパイルできる場合は、代わりに使うべきファイル、型、関数をエラーに明記するリンターまたは CI チェックを追加します。そのパターンがすでに広く使われている場合は、変更によって増えたときだけ失敗するようにします。
- 動作をテストします。 確認対象の動作が壊れても通るテストや、内部実装だけを変更した場合に失敗するテストは、修正するか削除します。
- ドキュメントやエージェント向けルールを書くのは最後にし、判断が必要な場合だけにします。 エージェントがそれらを無視しても、何も失敗しません。
修正して証明する
次に、最も頻度の高い種類から今すぐ修正し、それぞれを個別のコミットにします。新しい各チェックが、実際に過去にあったミスで失敗することを証明してください。同じコマンドをローカルと CI の両方で実行してください。例外は該当する行に、理由、期限、人間の承認を添えて記載します。
ルール表を維持する
最後に、エージェント向け指示ファイルに、各ルールとそれを強制する仕組みを対応付けた表を維持してください。オペレーターから指摘を受けたら、ミスを修正してルールを追加します。そのルールがすでに記載されているのに、何も強制する仕組みがない場合は、再発です。同じ変更の中で、機能する最も高いレベルで修正してください。そのミスが起こり得なくなったら、そのルールを削除します。
回答: 各種類のミスについて、根拠、選んだレベル、およびそれより高いレベルが機能しなかった理由を示してください。