wf：为Claude Code设计的声明式工作流Agent，实现分阶段代码协作

wf是基于tm构建的声明式工作流Agent，通过预定义的阶段门控机制管理Claude Code的工作流程，将AI辅助编程分解为明确阶段（每个阶段有目标和验收标准），为AI辅助编程提供更结构化的人机协作模式，解决复杂任务中AI工作流程管理的问题。

随着Claude Code等AI编程助手能力增强，开发者面临如何有效管理其工作流程的问题。wf项目针对此需求，采用"有主见"的设计，借鉴传统软件开发的阶段门控模型，将AI辅助编程分解为明确阶段，仅当前阶段完成后可进入下一阶段。项目基于tm（task manager）构建，是对现有任务管理能力的增强扩展。

核心概念：声明式阶段门控，开发者定义多阶段流程（如理解、设计、实现、验证、评审），每个阶段有准入条件和退出标准，防止AI未充分理解就编码或方案未定稿就实现。

技术架构：分层设计，tm层负责基础任务管理（创建、状态跟踪、调度）；wf层实现阶段门控逻辑，将声明式配置转化为tm任务序列；Claude Code集成层调用API执行编程任务并监控输出判断阶段完成。

以添加用户认证功能为例，wf定义的工作流包括：

1. 需求澄清：Claude Code分析现有代码库，输出集成点与冲突报告，开发者确认需求；
2. 技术选型：Claude Code研究JWT/Session/OAuth等方案并推荐，开发者选择；
3. 接口设计：Claude Code设计接口和数据结构，生成文档，开发者确认；
4. 实现与测试：Claude Code编写代码及测试，修复失败项；
5. 代码审查：Claude Code生成变更摘要，开发者审查合并。

各阶段需验证后进入下一阶段，支持回退。

对比：

• 比裸用Claude Code：增加结构化约束，避免AI跳跃式工作；
• 比Cursor等IDE集成：更专注流程管理，部署更灵活；
• 比Devin：强调人机协作，保留人工审核节点；
• 比CI/CD：介入开发阶段，管理AI辅助过程而非交付流程。

适用场景：复杂功能开发、遗留代码维护、团队协作标准化、学习培训、高风险变更。

技术亮点：配置驱动阶段定义、灵活条件判断（AI输出标记/文件变更等）、状态持久化（中断恢复）、深度集成Claude Code、可扩展钩子系统（阶段前后执行自定义逻辑）。

局限性：学习曲线（声明式思维需适应）、灵活性约束（强制特定模式）、阶段设计依赖人工、当前主要绑定Claude Code。

未来方向：智能阶段推荐（AI分析任务自动推荐阶段）、多Agent协作、可视化编辑器、模板市场、项目管理工具集成（同步状态到Jira/Linear）。

总结：wf推动AI辅助编程向结构化演进，为开发者提供管理AI工作流程的有效手段，帮助个人建立严谨习惯、团队标准化协作，为AI协作管理领域提供探索方向。