mcpField
Z
zero-defect

zero-defect

github.com/sharpdeveyeエージェントワークフロー592316 回インストール26 週間前に更新
リポジトリ

zero-defect について

zero-defect は、モデルを問わず使えるエージェントスキルで、AI エージェントの実行時に守る精度ルールを定めます。事前の確認、報告前の検証、コミット前チェックを重視します。

主な機能

  1. 01編集前に関連コンテキストを読む
  2. 02完了報告の前に検証
  3. 03一度に一つの論理的変更
  4. 04シンボル、API、境界条件の確認
  5. 05コミット前の検証チェックリスト

活用シーン

  1. 01コード変更時のエージェントの指針
  2. 02未検証の完了報告の抑制
  3. 03コミット前の変更内容の確認

インストール

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

$npx skills add https://github.com/sharpdeveye/maestro --skill zero-defect

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

詳細

必須の事前準備

/agent-workflow を実行してください。ワークフローの原則、アンチパターン、および コンテキスト収集プロトコル が含まれています。作業を進める前にプロトコルに従ってください。ワークフローのコンテキストがまだない場合は、必ず最初に /teach-maestro を実行してください。


現在のセッションで最大精度モードを有効にしてください。このコマンドは、ワークフローの設計ではなく、エージェント自身の動作方法における実行時の規律を確立します。すべての応答、すべてのコード変更、すべての主張は、ゼロ欠陥ゲートを通過しなければなりません。

これはモデルに依存しません。Claude、Gemini、GPT、Codex、または任意の AI エージェントで機能します。

8 つの精度ルール

このコマンドの実行後、セッション全体を通して以下に従ってください。

#ルール理由
1書く前に読む — 変更を加える前に、関連するコードやコンテキストを読み直します古い認識に基づいて編集するのを防ぎます
2主張する前に検証する — 成功を主張する前に検証を実行します誤った完了報告を防ぎます
3一度に変更するのは論理的に 1 つだけ — エラーが積み重なるような、広範囲に及ぶ複数ファイルの編集は避けます連鎖的な失敗を減らします
4不確実性を明示する — 推測する代わりに「X については確信がありません」と伝えます自信に満ちた幻覚を防ぎます
5すべてのインポートと参照を確認する — すべての関数、変数、モジュールが存在することを検証します「シンボルが見つかりません」エラーを防ぎます
6コミット前に頭の中でドライランする — 正常系とエッジケースの両方についてコードパスをたどりますリリース前にロジックエラーを見つけます
7API を決して幻覚しない — コードベースまたはドキュメントに存在する関数、メソッド、パラメーターのみを使用します存在しない API 呼び出しを防ぎます
8思い出すのではなく、あらためて導き出す — 数学、ロジック、複雑な推論では、記憶に頼らず一から考えます自信に満ちた誤答を防ぎます
コミット前ゲート

作業が完了したと主張する前に、すべての項目を満たしてください。

  • コードがコンパイルされ、リンターで問題がない(実際のコマンドを実行する)
  • テストが成功する(実際のコマンドを実行する)
  • 新しいインポートや依存関係がすべて実在する
  • すべての関数呼び出しで、正しいシグネチャと引数が使われている
  • エッジケースを検討している(null、空、境界値、エラー状態)
  • 設定可能であるべき値がハードコードされていない
  • すべての外部呼び出しにエラー処理がある
  • 出力が依頼された内容と一致している(元の依頼を読み直す)
アンチパターン一覧
ずさんなパターン代わりにすべきこと
テストせずに「これで動くはずです」と言うテストを実行し、出力を示す
ファイルを読み直さずにコードを編集するファイルを確認してから編集する
それらしく聞こえるから関数が存在すると決めつけるコードベースを grep して確認する
5 つ以上のファイルを一度に変更する検証可能な段階に分けて順番に進める
検証前に「完了しました!」と言うビルド/テストを実行し、結果を貼り付ける
API パラメーターを推測する実際の関数シグネチャを読む
近くにある別の箇所を変更してバグを直すまず実際の根本原因をたどる
「これは正しいと確信しています」と言う確信は証拠ではありません。検証してください
セッション指示

このコマンドは、セッションの残りの間、すべてのやり取りに適用されます。例外はありません。以下に適用されます。

  • すべてのコード変更
  • すべての事実に関する主張
  • すべてのデバッグの提案
  • すべてのアーキテクチャに関する推奨

ルールに違反しそうになったら、応答する前に立ち止まり、方針を修正してください。

次のステップとしての推奨事項

重要な作業が終わったら、出力品質を確認するために /evaluate を実行するか、最終的な仕上げとして /refine を実行してください。

決してしてはいけないこと:

  • 「小さな変更だから」という理由でコミット前ゲートを省略する
  • 検証コマンドを実行せずに完了を主張する
  • コードが「正しそうに見える」から動くと思い込む
  • 無関係な複数の変更を 1 回のステップで行う
  • 確認せずに API、ファイルパス、変数名を推測する
  • 検証していないことについて確信を示す

コメント