Leonxlnx/unlazy
已整理这个项目帮助使用 AI agent 处理复杂任务的人,把“任务完成”变成可检查、可复核的流程,而不是只依赖模型口头承诺。它适合需要 AI 协助做重构、验证、长任务拆分或多代理协作的开发者和团队。
项目简介
这个项目帮助使用 AI agent 处理复杂任务的人,把“任务完成”变成可检查、可复核的流程,而不是只依赖模型口头承诺。它适合需要 AI 协助做重构、验证、长任务拆分或多代理协作的开发者和团队。
官方仓库资料
- 主要语言
- JavaScript
- 许可证
- MIT
- 默认分支
- main
- Stars
- 4352
- Forks
- 343
- Open Issues
- 11
- 仓库状态
- 正常运行
- 派生仓库
- 非 Fork
- 数据采样
- 2026/11/12 09:19:45
- 资料抓取
- 2026/11/12 09:19:45
- 首次收录
- 2026/11/12 09:17:54
Topics:ai-agents · claude · claude-code · llm · productivity · prompt-engineering · skill
AI 整理 · 基于已抓取的官方资料
核心功能
- 先编写接受标准账本,再执行和复核检查,避免仅凭描述判断任务完成
- 通过 GATES.md 中的 CHECK、EXPECT、CWD、EVIDENCE 定义可运行 gate
- gate-check.mjs 支持状态检查、显式批准、复核、作用域、叶子任务 claim、并发 jobs 等模式
- 自动证据包含定义摘要、退出状态、输出匹配指纹和环境信息,用于检测定义漂移
- 支持 scoped pipeline,将复杂任务拆成 PLAN、父子 gate、leaf 状态和 dispatch wave
- 提供 Depth Tree 分解方法相关文档,用于把复杂任务拆成多层子任务
- 提供可选 Claude Code Stop hook,在 gate 未满足或 dispatch 未完成时阻止结束
- 提供 gate-lint.mjs 对账本中的机械性弱模式进行非执行式检查
- 支持 shell 选择,包括 --shell 和 UNLAZY_SHELL
- Node 16 或更新版本可运行,运行时不依赖第三方包
适用场景
- 要求 AI agent 完成较大规模代码改动并逐项验证结果
- 为重构、迁移、集成测试等任务建立可执行的验收清单
- 将复杂任务拆成多层子任务,并跟踪每个叶子任务的状态和证据
- 在多个独立任务并行执行时协调文件 ownership 和 dispatch wave
- 在 Claude Code 中通过 Stop hook 阻止未验证任务提前结束
- 对 AI agent 返回的工作进行 reverify,确认旧证据仍然满足当前定义
使用方式
install: - npx skills add Leonxlnx/unlazy
-
可加 -g 进行用户级安装,或加 --all 安装到所有检测到的 agent
-
也可手动克隆到 ~/.claude/skills/unlazy 或 ~/.codex/skills/unlazy invoke: - 在支持 slash skills 的环境中使用 /unlazy
-
在 Codex 中使用 $unlazy
-
也可通过 skill description 中的自然语言触发 quick_start: - /unlazy tree 5 refactor the payment module and verify every migration path
-
复制 templates/gates-leaf.md 到 GATES.md,替换所有占位符
-
node <path-to-skill>/scripts/gate-check.mjs --status GATES.md
-
node <path-to-skill>/scripts/gate-check.mjs GATES.md
-
node <path-to-skill>/scripts/gate-check.mjs --approve GATES.md
-
node <path-to-skill>/scripts/gate-check.mjs --reverify GATES.md gate_example: # Gates: pricing behavior
-
G1: pricing fixtures render the expected tiers CHECK: node scripts/verify-pricing.mjs EXPECT: pricing verification passed EVIDENCE: pending tests: - npm test
技术特点
- 项目语言为 JavaScript
- checker 和可选 hook 需要 Node 16 或更新版本
- 运行时不使用第三方包
- 当前源码目标版本为 2.1.0,但 README 明确说明这里未标识为已打 GitHub release;需要不可变安装时应固定具体 commit
- CHECK 行是 shell code,普通运行在批准后可能执行命令
- --status 是始终不执行命令的模式
- 可运行 gate 只有在进程退出码为 0 且 EXPECT 匹配 stdout/stderr 合并输出时才通过
- stdout/stderr 捕获内容和用于 EXPECT 的规范化合并字符串需符合 1 MiB 限制
- approval 记录默认位于 ~/.unlazy/approved,也可通过 UNLAZY_APPROVAL_DIR 指定
- approval 绑定绝对 ledger、gate、CHECK、EXPECT、CWD、shell、timeout、输出和正则限制、平台、PATH 等信息
- approval 是执行同意,不是沙箱;检查命令拥有当前环境下的文件系统、环境变量、凭据和网络访问权限
- checker 的 shell 选择顺序为 --shell、UNLAZY_SHELL、Node 平台默认 shell
- 默认安装 Claude Code Stop hook 会写入 .claude/settings.local.json
- README 建议将 .claude/settings.local.json、.unlazy/ 和 .unlazy-hook-state.json 放入项目忽略规则
- 仓库包含 SECURITY.md、references、templates、scripts、tests 等文档和脚本
限制与边界
- README 明确说明相关研究支持该项目所针对的失败模式,但不证明 unlazy 会产生固定幅度的改进
- checker 只能证明声明的命令 oracle,不能推断英文标题与任意 shell 代码是否语义一致
- 自动证据使用未加密密钥的绑定方式检测结构漂移,不防止可编辑 ledger 的人伪造看似规范的证据
- approval 不会哈希被调用脚本、fixtures、依赖或其他传递输入
- scope 和 ownership lease 只是协作协调机制,不限制进程可以读写什么
- 并行 lease 匹配是保守的,可能拒绝看起来安全的组合
- shell 或 PATH 不匹配会导致验证失败,需要解决后才能视为成功证据
- 旧 README 中提到的内部六轮比较缺少可复现原始 artifacts,README 要求将其视为历史设计输入而不是 benchmark 保证
- 手动 gate 的普通人工证据仍兼容,但自动状态检查不是重新执行;父级验证需要使用 --reverify
README
README 介绍 unlazy 是一个用于 AI agent 复杂工作的完成纪律技能:先写接受标准账本,执行经审查的检查,复核返回结果,并只报告证据支持的内容。安装可通过 skills CLI,也可手动放入 Claude Code 或 Codex CLI 的 skills 目录。核心流程是用 GATES.md 定义 CHECK、EXPECT、CWD、EVIDENCE,通过 gate-check.mjs 查看状态、批准执行、重新验证,并在复杂任务中使用 scoped pipeline、leaf/node gate、dispatch wave 和 ownership lease 协调工作。README 还详细说明了 shell/PATH、approval 存储、安全边界、Claude Code Stop hook、2.1.0 未发布变更、仓库结构、研究依据、贡献和 MIT 许可证。
关联 Wiki 词条
暂无已建立的词条关联。