Communityライティング&編集github.com

odem41321/luciazero

検証第一の規律をコーディングエージェント(Claude Code + Codex CLI)にもたらす:9つのルール、6つのスキル、敵対的レビューアエージェント、フェイルオープンな強制フック。「完了」はコマンドで証明され、意見ではありません。

luciazero とは?

LuciaZeroは、Claude CodeやCodex CLIなどのAIコーディングエージェント向けに設計された「検証第一」の規律を実装したスキルです。9つのルール(Done Doctrine)から成る厳格なフレームワークを通じて、エージェントがタスクを完了したと宣言する前に、自動テスト、スコープ確認、敵対的コードレビュー、リスク評価を必須とします。 主な特徴: - フル検証の強制:`verify-full`または`verify`コマンドを実際に実行し、その出力の決定的な行を証明として提示します。 - 懐疑的差分レビュー:エッジケース、エラーパス、変更された契約、偶発的な変更、テストの誠実性を検証するための専用スクリプト`revert-probe.sh`を提供。 - リスクに応じた独立レビュー:セキュリティ、契約、一般の3つのカテゴリから適切な重点レビューを選択し、`blocker`や`major`な問題を強制的に修正します。 - スコープ確認とレトロスペクティブ:元のリクエストを再読し、未対応項目を明示。行き詰まりや失敗から学び、`/retro`コマンドで教訓を記録します。 - 機械可読なJSON出力:`done`または`blocked`ステータスと共に、検証コマンド、終了コード、決定的な行を構造化して報告します。 このスキルは、エージェントが「やった気になる」のではなく、実際にシステムが正しいことを自動化された証明で確認する文化を促進します。特に、継続的インテグレーションやコード品質が重要なプロジェクトで効果を発揮します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add ohm41321/luciazero

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

完了

1. フル検証

完全な階層を今すぐ実行: verify-full があればそれ、なければ verify を使用。最も短い決定的な行を引用すること。

  • 赤 → まだここに到達していません。ループに戻ってください。
  • 検証コマンドが存在しない → /ready を使用してください。「完了」と主張してはいけません。
  • それは今、実際に実行されていなければなりません。セッションの前の方で実行したものではありません。

2. 懐疑的差分パス

敵意を持ったレビュアーとして、最終的な差分を読み直してください。確認すること:

  • エッジケース: 空、ゼロ、Unicode、境界、並行性。
  • エラーパス: 失敗、ファイル欠落、ネットワーク切断、クリーンアップ。
  • 変更された契約: API、フォーマット、スキーマ、設定、既存のコンシューマ。
  • 偶発的な内容: 無関係なファイル、デバッグコード、シークレット、緩んだピン。
  • テストの誠実性: 実装を元に戻した場合、変更されたテストは失敗するか?

該当する場合は実行 <このスキルのディレクトリ>/scripts/revert-probe.sh "<検証コマンド>"。弱められたチェックは発見事項です。発見事項を修正し、フル検証を繰り返してください。

3. リスクに応じた独立レビュー

焦点を選択:

  • security: 認証、権限、入力、パス、コマンド、シークレット、エンドポイント。
  • contract: 公開API/CLI、スキーマ、設定、マイグレーション、コンシューマ。
  • general: 金銭、並行性、リソース、または広く不確かな差分。

ハーネスに組み込まれたレビューコマンドを優先します。それ以外の場合は1つのレビューアエージェントを使用します。セキュリティと契約の両方が該当する場合、2つの独立した焦点を絞ったパスを要求します。レビューアは呼び出し元とコンシューマを読みます。

すべての blocker または major は、ユーザーが明示的にその名前のリスクを受け入れない限り、修正して再検証します。minor は報告された場合にのみ延期しても構いません。ルーティングされたリスクのない、小さくよく理解された差分は、懐疑的パスの後に停止しても構いません。

4. スコープ確認

元のリクエストを読み直してください。すべての項目が提供されているか、理由とともに除外されていることが明記されています。決して黙ってスコープを削ってはいけません。/lucia-bus を通じてあなたが引き受けたバスタスクは、ユーザーがキャンセルしない限り、completed または blocked の状態で、その結果が公開されていなければなりません。

5. 教訓

行き詰まり、落とし穴、または反証されたアプローチについては、/retro を実行してください。未完了の状態を引き継ぐ必要がある場合は、代わりに /lucia-relay を使用してください。

6. 報告

Done: <何が変わったか、1行で>
Proof: <検証コマンド> → <決定的な行>
Not covered: <検証のギャップ>
Left out: <除外されたスコープ + 理由、またはなし>

曖昧さはありません。すべてのステップが成功した後にのみ「完了」と報告してください。機械出力は同じ事実を反映します。ブロックされた出力は "status": "blocked" とその失敗した行を使用します。

{
  "status": "done",
  "verify": {"command": "./test.sh", "exit_code": 0, "decisive_line": "PASS  すべてのチェックがグリーン"},
  "not_covered": "<検証のギャップ>",
  "left_out": "なし"
}

関連スキル