mcpField
C
correct

correct

github.com/ericlitman開発53213 回インストール1 週間前に更新
リポジトリ

correct について

correctは、リポジトリ内でエージェントが同じミスを繰り返さないようにするpstackスキルです。繰り返し起きる問題を調べ、アーキテクチャ、型、チェック、テスト、ドキュメントで対処し、各ルールの適用方法を記録します。

主な機能

  1. 01リポジトリの証拠から反復ミスを分類
  2. 02アーキテクチャ修正と単一の情報源を優先
  3. 03型、Lint、CIによる制約の追加
  4. 04過去のミスを使ったチェックのテスト
  5. 05ルールと適用方法の表を維持

活用シーン

  1. 01コードベースでのエージェントの反復ミス防止
  2. 02レビュー指摘を適用可能なチェックに変換
  3. 03過去のミスを使った新規チェックの検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ericlitman/open-pstack --skill correct

インストール後、Claude Code で/correctを入力して読み込まれたか確認します。

詳細

修正する

このリポジトリでは、オペレーターがエージェントに同じミスを何度も指摘しています。次のエージェントが同じミスをしないように、リポジトリを変更してください。

すべてのコントリビューターは、開いたファイルだけを参照し、最も近い例をコピーして、コンパイルできる最短の道を選ぶエージェントだと想定してください。あるファイルだけを見れば正しそうな変更が、リポジトリ全体でも正しくなるように設計してください。

ミスの種類を特定する

まず、最近のコミット、リバート、レビューコメント、エージェント向け指示ファイル、回避策の理由を説明するコメントを読んでください。ミスを種類ごとに分類してください。同じ種類のミスが2回発生していれば、分類対象とします。

各種類を、機能する最も高いレベルで修正する

  1. アーキテクチャで排除します。 各状態に単一の所有者を設け、各タスクにサポートされる方法を一つだけ用意します。内部実装を隠し、誤ったインポートは失敗するようにします。手動で同期しているリストを単一の信頼できる情報源に置き換えます。古いやり方や、エージェントがコピーしそうな不要なコードは削除します。
  2. 誤った状態を書き込めないよう、型で強制します。 不適切なコードがまだコンパイルできる場合は、代わりに使うべきファイル、型、関数をエラーに明記するリンターまたは CI チェックを追加します。そのパターンがすでに広く使われている場合は、変更によって増えたときだけ失敗するようにします。
  3. 動作をテストします。 確認対象の動作が壊れても通るテストや、内部実装だけを変更した場合に失敗するテストは、修正するか削除します。
  4. ドキュメントやエージェント向けルールを書くのは最後にし、判断が必要な場合だけにします。 エージェントがそれらを無視しても、何も失敗しません。

修正して証明する

次に、最も頻度の高い種類から今すぐ修正し、それぞれを個別のコミットにします。新しい各チェックが、実際に過去にあったミスで失敗することを証明してください。同じコマンドをローカルと CI の両方で実行してください。例外は該当する行に、理由、期限、人間の承認を添えて記載します。

ルール表を維持する

最後に、エージェント向け指示ファイルに、各ルールとそれを強制する仕組みを対応付けた表を維持してください。オペレーターから指摘を受けたら、ミスを修正してルールを追加します。そのルールがすでに記載されているのに、何も強制する仕組みがない場合は、再発です。同じ変更の中で、機能する最も高いレベルで修正してください。そのミスが起こり得なくなったら、そのルールを削除します。

回答: 各種類のミスについて、根拠、選んだレベル、およびそれより高いレベルが機能しなかった理由を示してください。

コメント