unlazy 快速入门

这是什么？适合谁？

unlazy 是给 AI agent 的反偷懒 skill。v2 的口号：不是请求，是强制——v1 让模型”努力点”，v2 让半成品在结构上无所遁形：验收门（acceptance gates）落在文件里、检查以命令执行、可选 hook 在门未满足时直接阻止 agent 宣告胜利。你不承诺做完了，你对着账本（ledger）证明它。兼容 Claude Code、OpenAI Codex、Cursor 及一切读 SKILL.md 的工具；硬强制（Stop hook）为 Claude Code 专属，其余全是纯 markdown + Node。

适合人群：被 agent”差不多就交差”折磨的开发者、需要任务完成度客观证据的团队、研究 agent 行为强制的提示工程师。 使用前提：任一支持 SKILL.md 的 agent；要用硬强制需 Claude Code。

快速上手（3 步）

第一步：安装

# 按 README 安装到你的 agent（支持 Claude Code / Codex / Cursor 等）

第二步：用 tree 命令启动任务

/unlazy tree 5 refactor the payment module

tree N 决定任务拆解深度：树叶是真实工作单元，每片叶子对着自己的验收门完成。tree 2-3 适合一个特性或 bug 猎杀，tree 4-5 适合一个子系统，tree 6-7 适合整项目用新鲜上下文子代理逐叶构建。

第三步：对账验收

任务结束时 agent 不是”说”完成——它对着 ledger 逐门执行检查命令，全绿才算数。Claude Code 用户可开启 Stop hook：门未满足时 agent 根本无法宣布胜利。

初级用法

• 自然语言触发：不用斜杠命令也行——“build the landing page and do not stop until every gate is checked” 这类表述会自动触发 skill。
• 深度即粒度：N 越大拆得越细，偷懒空间越小；日常开发 2-3 足够。
• ledger 思维：验收门写在文件里而非对话里——可追溯、可复跑、可审查。

高级玩法

1. Stop hook 硬门禁：Claude Code 下开启 hook，agent 在全部验收门通过前被结构性阻止收工——从”君子协定”升级为”物理封锁”。
2. 子代理逐叶构建：tree 6-7 深度下每片叶子交给新鲜上下文的子代理，避免长会话上下文腐化导致的”越干越懒”。
3. 团队验收标准化：把”完成”的宪法写进 gates 文件，新人 agent 与资深成员的 agent 执行同一套标准。

常见踩坑（5 条）

踩坑 1：深度选太高

• 现象：小任务拆出几十片叶子，管理成本爆炸
• 原因：tree N 的 N 是拆解深度不是越多越好
• 解决：特性级 2-3、子系统级 4-5、项目级才上 6-7

踩坑 2：非 Claude Code 期待硬强制

• 现象：agent 仍然”嘴上完成”
• 原因：Stop hook 仅 Claude Code 支持；其他平台是软约束
• 解决：非 Claude Code 平台配合人工对账 ledger

踩坑 3：验收门写得太虚

• 现象：门形同虚设
• 原因：gates 写”代码质量好”这类不可执行描述
• 解决：每道门必须是可执行命令（测试通过、lint 零错、构建成功）

踩坑 4：忘记 hook 配置

• 现象：装了 skill 但没硬强制
• 原因：Stop hook 是可选项
• 解决：按 README 的 Use it 章节启用 hook

踩坑 5：把 unlazy 当万能质量保证

• 现象：门全绿但需求理解错了
• 原因：unlazy 保证”做完”，不保证”做对事”
• 解决：验收门里加一道”需求复述与确认”的产物门

FAQ（5 个常见问题）

Q1：unlazy 免费吗？ A：MIT 开源免费。

Q2：v1 和 v2 的区别？ A：v1 请求模型努力；v2 结构化强制——验收门进文件、检查跑命令、hook 阻止虚假完成。

Q3：什么是 Depth Tree 方法？ A：把任务拆成足够深的原子步骤树，每片叶子是独立可验收的工作单元，从结构上消灭”糊弄着做完”的空间。

Q4：会增加多少开销？ A：拆解与对账有额外回合开销（README 有 Costs 章节）；换来返工率下降，复杂任务净收益为正。

Q5：和 HERO Anti-OverDefense 冲突吗？ A：方向相反但互补：unlazy 防”偷懒少做”，HERO 防”过度多做”；搭配使用时注意 gates 别写过度防御性条款。

小技巧（5 条）

1. gates 先写：开工前把验收门写全，比事后补门有效十倍。
2. 门要可执行：每道门对应一条命令，输出可判定。
3. 复用门模板：把常见门（测试/lint/构建/文档）做成团队模板。
4. 大项目用子代理：tree 6-7 + 新鲜上下文子代理，防长会话腐化。
5. 对账输出存档：ledger 的执行记录是 code review 的最佳输入。

进阶学习建议

• 精读 Depth Tree v2 的方法论文档（How it works / The method），理解”结构化可见性”如何取代”口头承诺”
• 研究 Stop hook 的实现，理解 Claude Code 生命周期钩子如何用于行为强制
• 用一次 tree 3 任务记录前后对比（返工次数、完成质量），建立自己的量化证据
• 把 ledger/gates 模式迁移到任何多 agent 协作系统的验收层

参考链接

• unlazy GitHub 仓库

本文基于公开资料于 2026-08-17 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。