LazyCodex 工作流实战：使用 $ulw-plan 和 $start-work 高效完成复杂任务

【免费下载链接】lazycodex The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex. 项目地址: https://gitcode.com/gh_mirrors/la/lazycodex

想要在复杂代码库中高效完成开发任务吗？LazyCodex 是你的终极解决方案！这个强大的 Codex 代理工具包通过智能规划与执行分离的工作流，让复杂任务变得简单可控。本文将为你详细介绍如何使用 $ulw-plan 和 $start-work 这两个核心工具，构建高效的项目管理流程。无论你是新手还是经验丰富的开发者，都能从中获得实用的工作流技巧。😊

什么是 LazyCodex？

LazyCodex 是基于 OmO (oh-my-openagent) 的 Codex 代理工具包，专为复杂代码库设计。它提供了完整的代理工作流：项目记忆、智能规划、并行执行和验证完成。想象一下，你拥有一个专业的 AI 开发团队，每个成员都有明确的角色分工：

• Sisyphus - 总指挥，协调整个工作流
• Hephaestus - 实施者，负责代码实现
• Oracle - 验证者，确保工作质量
• Librarian - 研究员，负责代码库探索

LazyCodex 将这些角色封装成简单易用的命令，让你能够专注于高层次的规划，而将执行细节交给专业的代理团队处理。

$ulw-plan：智能战略规划工具

$ulw-plan 是你的战略规划顾问（代号 Prometheus）。它负责将模糊的需求转化为可执行的详细计划，但从不直接编写产品代码。

核心工作流程

1. 探索优先 - 首先深入探索代码库，收集所有可发现的事实
2. 聚焦问题 - 仅针对探索无法解决的真正模糊点提问
3. 等待批准 - 在生成计划前必须获得用户明确批准
4. 生成计划 - 将计划保存到 plans/<slug>.md 文件

动态对抗性规划

对于架构工作或无计划的 $start-work 启动，$ulw-plan 采用五阶段动态对抗性工作流：

1. 收集 - 当范围足够广泛时，自动启动5个主机子代理
2. 验证 - 独立验证收集到的声明，确保事实准确
3. 设计 - 将验证后的事实转化为实施步骤
4. 对抗性 - 运行计划审查，拒绝模糊任务和自证检查
5. 合成 - 生成包含完整证据链的决策就绪计划

实际使用示例

# 开始规划一个新功能
$ulw-plan "为项目添加用户认证系统"

# 规划重构任务  
$ulw-plan "重构用户管理模块，支持多租户架构"

$ulw-plan 会与你进行苏格拉底式对话，逐步澄清需求，最终生成一个包含详细 TODO 列表、验收标准和依赖关系的完整计划文件。

$start-work：高效计划执行工具

$start-work 是 $ulw-plan 的完美搭档，专门负责执行计划直到每个复选框都完成。它会在控制台打印 ORCHESTRATION COMPLETE 来宣告任务完成。

执行阶段详解

阶段1：选择计划

• 读取 .omo/boulder.json 状态文件
• 列出 .omo/plans/ 下的所有计划文件
• 智能选择或询问用户确认

阶段2：创建 Boulder 状态

• 为每个工作会话创建持久化状态
• 支持独立的工作树（worktree）模式
• 确保状态在会话间持久化

阶段3：执行下一个复选框

• 找到第一个未完成的顶级复选框
• 分类任务层级（LIGHT 或 HEAVY）
• 关键规则：你是指挥官，不是实施者！
• 将所有实施任务委托给子代理并行执行

阶段4：验证和记录证据

每个复选框在标记完成前必须通过五重验证门：

1. 计划重读 - 确认复选框和验收标准
2. 自动化验证 - 运行测试、类型检查等
3. 手动 QA 通道 - 捕获真实工件，而非模拟运行
4. 对抗性 QA - 测试所有适用的风险类别
5. 清理 - 清理所有 QA 资源并记录收据

阶段5：标记进度

• 将复选框从 - [ ] 改为 - [x]
• 重新读取计划确认剩余数量减少
• 添加 task-completed 到分类账
• 自动继续下一个复选框

Sisyphus 式完成契约

$start-work 采用严格的验证机制：

• 工作者的完成声明从不被视为最终结果
• 不同上下文运行对抗性验证
• 失败会循环回到执行者
• 只有确认的验证结果才成为 FullyDone

实战工作流示例：添加用户认证系统

让我们通过一个实际案例看看这两个工具如何协同工作：

步骤1：规划阶段

# 启动规划会话
$ulw-plan "为Web应用添加基于JWT的用户认证系统"

规划过程包括：

1. 探索现有代码库结构
2. 识别认证相关依赖
3. 确定技术栈选择
4. 制定分阶段实施计划
5. 生成 plans/user-auth-system.md

步骤2：执行阶段

# 开始执行认证系统计划
$start-work user-auth-system

执行过程包括：

1. 并行实现用户模型和数据库迁移
2. 实现JWT令牌生成和验证中间件
3. 添加登录/注册API端点
4. 实现密码重置功能
5. 添加测试和文档

步骤3：验证和完成

每个子任务完成后：

• 自动运行测试套件
• 手动验证API端点
• 对抗性测试安全漏洞
• 清理测试环境
• 最终打印 ORCHESTRATION COMPLETE

最佳实践和技巧

📋 规划阶段的最佳实践

1. 明确范围 - 在规划前明确任务边界
2. 探索优先 - 让 $ulw-plan 充分探索代码库
3. 关注模糊点 - 只对真正不确定的决策提问
4. 记录假设 - 所有决策和假设都记录在草案中

🚀 执行阶段的优化技巧

1. 最大化并行 - 独立任务同时执行
2. 严格验证 - 不要跳过任何验证门
3. 证据驱动 - 每个完成声明都需要证据支持
4. 及时清理 - 完成后立即清理测试资源

🔧 故障排除指南

问题：$start-work 卡在某个复选框 解决：检查分类账 .omo/start-work/ledger.jsonl 查看验证失败原因

问题：计划过于模糊 解决：重新运行 $ulw-plan 并提供更具体的需求

问题：代理超时或无响应 解决：检查子代理的工作状态，必要时重新启动

高级功能：工作树模式

对于需要隔离环境的复杂任务，可以使用工作树模式：

# 在独立工作树中执行计划
$start-work user-auth-system --worktree /path/to/worktree

这个功能特别适合：

• 大型重构任务
• 实验性功能开发
• 需要保持主分支干净的场景

为什么选择 LazyCodex 工作流？

✅ 优势对比

传统方式	LazyCodex 工作流
手动分解任务	自动智能规划
串行执行	最大化并行执行
主观验证	五重证据门验证
状态易丢失	持久化 Boulder 状态
难以恢复	支持暂停和恢复

🎯 适用场景

1. 复杂功能开发 - 需要多模块协作的任务
2. 大规模重构 - 影响范围广的代码改造
3. 技术债务清理 - 系统性的代码质量提升
4. 架构演进 - 需要谨慎规划的系统升级
5. 紧急修复 - 需要快速验证的紧急任务

开始你的 LazyCodex 之旅

安装指南

# 一键安装
npx lazycodex-ai install

# 验证安装
npx lazycodex-ai doctor

快速上手

1. 初始化项目记忆：$init-deep
2. 规划你的任务：$ulw-plan "你的任务描述"
3. 执行计划：$start-work [计划名称]
4. 监控进度：查看 .omo/ 目录下的状态文件

资源路径

• 官方文档：packages/web/content/docs/
• 技能源码：plugins/omo/skills/
• 工作流示例：plugins/omo/components/ultrawork/skills/ulw-plan/references/full-workflow.md

总结

LazyCodex 的 $ulw-plan 和 $start-work 工作流为复杂代码库任务提供了革命性的解决方案。通过智能规划与严格执行的分离，结合证据驱动的验证机制，你不仅可以提高开发效率，还能确保代码质量。

记住这个黄金法则：让 $ulw-plan 负责思考，让 $start-work 负责执行。你只需要关注高层次的目标，剩下的交给专业的代理团队处理。

无论是小型功能添加还是大规模系统重构，这套工作流都能提供可靠的支持。现在就开始体验 LazyCodex 的强大功能，让你的开发工作流变得更加智能和高效吧！✨

LazyCodex - 复杂代码库的智能代理工具包，让每个任务都有计划、有执行、有验证。

【免费下载链接】lazycodex The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex. 项目地址: https://gitcode.com/gh_mirrors/la/lazycodex