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