信息卡

一句话定位

一个给 Claude Code / Codex 使用的技能：在把大块工作委派给 AI Agent 时强制执行完成纪律——先起草验收台账（gate ledger），只执行经审查过的检查项，复验此前已完成的门禁，绝不宣称证据不支持的结论；口号是"Completion discipline for substantial AI-agent work, backed by runnable gates"。

走红原因分析

"AI 会偷懒/半途而废"是所有重度用户的共同痛点，unlazy 把抱怨变成了一套可执行的工程制度；README 引用模型"部分服从、提前截断、极少端到端完工"的研究背景引发共鸣（并注明这仅说明动机而非证明收益）；Depth Tree 方法拆解任务 N 层深 + fail-closed 审批设计，让它在一众 prompt 层面的"反偷懒"方案中显得格外硬核可信。

核心功能拆解

• 门禁台账：每个 checkbox 项由一条 CHECK shell 命令与一个 EXPECT 输出标记组成，成功须退出码为 0 且输出匹配；
• 证据记录：解析后的 shell、CWD、退出状态、PATH 指纹、匹配结果及成功输出的 SHA-256 字节数摘要；
• 严格解析器：拒绝空台账、重复 ID、残缺项与无理由弃单，可处理围栏示例并保留 CRLF/LF；
• 失败关闭式审批：批准记录私有存于 ~/.unlazy/approved，绑定台账路径/门禁 ID/CHECK·EXPECT 原文/CWD/shell/超时/平台与继承 PATH——任何改动都使批准失效，符号链接与权限不严的记录被拒收；
• 分域管道：.unlazy// 下分阶段计划，叶子状态机 WAITING→READY→IN-FLIGHT→VERIFIED/ABANDONED，支线 OPEN/VERIFIED/ABANDONED，滚动派发原生 launch wave 与 --jobs 1–64 可选并行，OWNS: 路径做文件所有权租约；
• 终端交接：未完成的门禁以退出码 1 加 HANDOFF REQUIRED 结束，父任务不能从未满足的子项晋升为完成。

架构与技术栈浅析

Node 16+ 运行，零第三方运行时依赖。组件含 SKILL.md 核心指令、checker/linter/派发记录器/hook 安装器脚本、参考文档（gates 规范、Depth Tree 方法、编排、并行协调、token 经济学）与模板；测试确定性可重复（npm test）。可选 Claude Code Stop hook 在门禁未完时返回 decision:"block"，内置会话键控保护连续六次非语义拦截后放行，防死锁。gate-lint.mjs 以 --strict 升级警告为失败。

安装与环境要求

npx skills add Leonxlnx/unlazy      # -g 用户级安装，--all 覆盖所有检测到的 Agent

手动路径：Claude Code 为 ~/.claude/skills/unlazy，Codex CLI 为 ~/.codex/skills/unlazy；调用方式 /unlazy 或 Codex 中 $unlazy。注意源码指向未发布的 2.1.0 变更集，建议固定具体 commit 保证可复现。

快速上手示例

/unlazy tree 5 refactor the payment module and verify every migration path
node <skill>/scripts/gate-check.mjs --status GATES.md     # 只查看不执行
node <skill>/scripts/gate-check.mjs --approve GATES.md    # 审阅后批准
node <skill>/scripts/gate-check.mjs --reverify GATES.md   # 含已完成项全量复验
node <skill>/scripts/gate-check.mjs --scope api --leaf leaf-1.2.1 --claim

门禁写法示例：

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

进阶使用要点

• 先跑 --status 预览、审阅每条 CHECK 再 --approve，审批绑定原文防命令被偷换；
• install-hooks.mjs 装/卸 Stop hook，支持 --scope 限定范围；
• 弃单须给出理由或有效门禁 ID，否则解析失败；
• token 经济学文档帮助控制长会话成本。

典型应用场景

• 大型重构任务的验收闭环（如迁移路径全部验证）；
• 多分支并行的子任务派发与文件所有权隔离；
• 作为 CI 前置的人类审批闸口；
• 团队内部规范 AI 执行器的"完工定义"。

同类生态位对比

对比 TDD 类 skill：unlazy 管的是 Agent 执行完毕后的证据链而非编写顺序；对比纯 prompt 提醒式方案：它有独立进程、审批文件与哈希审计的硬约束；同月新星中与 shuohao-skills 同属 skill 品类，一个管创意流水线、一个管执行纪律。

资源导航

仓库 README（gates spec/Depth Tree/编排/并行文档索引）、scripts/gate-check.mjs、install-hooks.mjs、npm test 测试套件。