W
AI-Wiki
← 开源项目

Leonxlnx/unlazy

已整理
https://github.com/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 词条

暂无已建立的词条关联。