unlazy

unlazy 是一个专为大型 AI 代理工作流设计的“反惰性”技能（Skill），解决 AI 在处理复杂任务时常见的痛点：过早宣布完成、仅实现 70%-80% 的功能、忽略边缘情况或缺乏严谨的验证。它通过引入可运行的关卡（Gates）和验收分类账（Acceptance Ledger），强制 AI 在报告任务完成前提供确凿的证据。

核心理念：证据胜于雄辩

unlazy 不依赖 AI 的自我评估，而是基于一套严格的契约：

1. 先编写验收分类账：明确定义什么是“完成”。
2. 执行已审查的检查：运行具体的 Shell 命令或脚本进行验证。
3. 重新验证返回的工作：确保修改没有破坏现有功能。
4. 仅报告证据支持的内容：只有当检查通过且输出匹配预期时，才标记为完成。

核心组件：关卡契约 (Gates)

unlazy 的核心是 GATES.md 文件，它是一个结构化的验收清单。每个关卡包含：

• CHECK: 可执行的 Shell 代码（如运行测试脚本、检查文件存在性）。
• EXPECT: 预期的标准输出或退出码。
• EVIDENCE: 记录执行结果、SHA-256 指纹等，确保证据不可篡改。

# Gates: pricing behavior

- [ ] G1: pricing fixtures render the expected tiers
  CHECK: node scripts/verify-pricing.mjs
  EXPECT: pricing verification passed
  EVIDENCE: pending

- [ ] G2: checkout integration succeeds from its package
  CHECK: node scripts/verify-checkout.mjs
  EXPECT: checkout verification passed
  CWD: packages/checkout
  EVIDENCE: pending

⚙️ 工作流程与工具

1. 安装与触发

• 安装：npx skills add Leonxlnx/unlazy
• 触发：在 Claude Code 中使用 /unlazy，在 Codex 中使用 $unlazy，或通过自然语言描述触发。

2. 验证流程

• 状态检查 (--status)：解析关卡但不执行，用于预览计划。
• 批准 (--approve)：用户审查 CHECK 命令的安全性后，批准执行。
• 执行与验证：运行命令，比对 EXPECT 输出，记录证据。
• 重新验证 (--reverify)：在代码变更后，重新运行所有关卡以确保回归测试通过。

3. 安全边界

• 批准记录：存储在 ~/.unlazy/approved 下的私有目录中，包含命令、路径、Shell 环境等的哈希值。任何输入变更都需要重新批准。
• 非沙盒环境：unlazy 在用户的真实环境中运行，拥有完整的文件系统、网络和凭证访问权限。因此，批准即同意，用户需自行确保命令的安全性。

高级功能：编排与并行

• 范围限定流水线：在 .unlazy/<scope>/ 下管理复杂项目的多个关卡文件。
• 并行执行：支持 --jobs <N> 参数，对独立的叶子关卡进行并行验证，加速大型项目的验收过程。
• Claude Code Stop 钩子：可选安装一个钩子，当关卡未满足时阻止 Claude Code 结束会话，强制 AI 继续工作直到所有验收标准达成。

为什么需要 unlazy？