Community寫作與編輯github.com

ohm41321/luciazero

以驗證為首要紀律的編碼代理(Claude Code + Codex CLI)守則:九條規則、六項技能、對抗式審查代理、預設失敗的強制鉤子。完成與否由指令證明,而非主觀認定。

luciazero 是什麼?

Luciazero 是一個為 AI 編碼代理(如 Claude Code 和 Codex CLI)設計的嚴謹技能,旨在透過系統化的驗證流程取代主觀的「完成」判斷。它定義了一套由九條規則和六個步驟組成的紀律框架,強制代理在聲稱任務完成前,必須通過完整的驗證命令、對抗式差異審查、基於風險的獨立審查(聚焦安全性、合約或一般性問題)、範圍核對、經驗教訓記錄,並最終輸出結構化的 JSON 報告。其核心機制包括一個內建的 revert-probe 腳本,用於檢驗測試的真實性,以及一個用於路由風險的獨立審查代理。該技能支援 Claude Code 和 Codex CLI 平台,特別適合需要高可靠性、安全審計或嚴謹合約管理的開發場景。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

完成

1. 完整驗證

執行完整層級的驗證:若存在 verify-full 指令則執行它,否則執行 verify。引用最短且有決斷力的那一行輸出。

  • 紅色 → 你還未達到目標。返回迴圈繼續。
  • 沒有驗證指令存在 → 使用 /ready;不得宣稱完成。
  • 必須此刻實際執行,而非在對話階段中的較早時間點。

2. 懷疑論者差異審查

以敵對審查者的身份重新閱讀最終的差異對比。檢查:

  • 邊界情況:空值、零值、Unicode、邊界條件、並發問題。
  • 錯誤路徑:失敗情況、缺少檔案、網路中斷、清理動作。
  • 變更的合約:API、格式、結構、配置、舊有消費者。
  • 意外內容:無關檔案、除錯程式碼、機密資訊、鬆散依賴固定版本。
  • 測試真實性:如果實作被還原,這些測試是否會失效?

在適用時執行 <this-skill-dir>/scripts/revert-probe.sh "<verify-cmd>"。被削弱的檢查即為發現的問題。修正問題並重複完整驗證。

3. 風險導向的獨立審查

選擇焦點:

  • security:認證、權限、輸入、路徑、指令、機密、端點。
  • contract:公開 API/CLI、結構、配置、遷移、消費者。
  • general:金錢、並發、資源,或範圍廣泛且不確定的差異。

優先使用工具內建的審查指令;否則使用一個審查代理。如果安全性和合約兩者都適用,則要求兩次獨立的聚焦審查。 審查者需閱讀呼叫者與消費者端。

修正並重新驗證每一個 blocker 或 major 問題,除非使用者明確接受該命名的風險。minor 問題只有在記錄回報後才能被推遲。一個小型、理解透徹且無路由風險的差異,可在懷疑論者審查後停止。

4. 範圍核對

重新閱讀原始請求。每一項要求都必須交付,或者明確說明遺漏的項目及其原因。絕不能無聲無息地縮小範圍。一個你透過 /lucia-bus 認領的總線任務必須設定為 completed 或 blocked,並發布其結果,除非使用者取消了它。

5. 經驗教訓

對於死胡同、陷阱或已被推翻的方案,執行 /retro。如果未完成的狀態需要轉移,則改用 /lucia-relay。

6. 報告

完成項目:<變更內容,一行概括>
證明:<驗證指令> → <有決斷力的行>
未涵蓋:<驗證缺口>
遺漏項目:<省略的範圍 + 原因,或無>

不允許含糊其辭:只有在每個步驟都通過後才能報告完成。機器產出需反映相同的事實;受阻的產出使用 "status": "blocked" 及失敗的行。

{
  "status": "done",
  "verify": {"command": "./test.sh", "exit_code": 0, "decisive_line": "PASS  所有檢查通過"},
  "not_covered": "<驗證缺口>",
  "left_out": "無"
}

相關技能