# Workflow Template：为 AI 编码助手打造的规划-执行工作流脚手架

> workflow-template 是一个项目脚手架工具，为 Claude Code 和 Codex 等 AI 编码助手安装规划-执行工作流，包含共享技能、子代理和任务追踪系统，提升 AI 辅助开发的结构化程度。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-11T04:44:39.000Z
- 最近活动: 2026-06-11T04:53:59.488Z
- 热度: 114.8
- 关键词: AI编码助手, Claude Code, Codex, 工作流, 规划执行, 任务追踪, 子代理, 开发效率
- 页面链接: https://www.zingnex.cn/forum/thread/workflow-template-ai
- Canonical: https://www.zingnex.cn/forum/thread/workflow-template-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：jsiovn
- 来源平台：github
- 原始标题：workflow-template
- 原始链接：https://github.com/jsiovn/workflow-template
- 来源发布时间/更新时间：2026-06-11T04:44:39Z

## 原作者与来源\n\n- **原作者/维护者**: jsiovn\n- **来源平台**: GitHub\n- **原始标题**: workflow-template\n- **原始链接**: https://github.com/jsiovn/workflow-template\n- **发布时间**: 2026-06-11\n\n---\n\n## 项目背景：AI 编码助手的组织难题\n\n随着 Claude Code、GitHub Copilot、Codex 等 AI 编码助手的普及，开发者发现单纯依赖对话式的交互存在明显局限：\n\n- **缺乏规划**：AI 容易陷入"边做边想"的模式，导致代码结构混乱\n- **上下文丢失**：长对话中重要信息被淹没，AI 遗忘关键约束\n- **任务追踪困难**：无法直观了解 AI 完成了什么、正在做什么、还有什么待办\n- **技能无法复用**：每个项目都要重新教会 AI 项目的特定规范\n- **协作混乱**：多轮修改后代码库状态难以追踪\n\nworkflow-template 正是为了解决这些问题而设计的项目脚手架。\n\n## 什么是 Workflow Template\n\nworkflow-template 是一个专为 AI 编码助手设计的工作流模板系统。它通过一套预定义的文件结构和约定，为任何代码仓库安装规划-执行（planner→executor）工作模式。\n\n需要特别注意的是，这里的 "workflow" 不是指 CI/CD 或 GitHub Actions 工作流，而是指 AI 代理的工作流程模式。\n\n### 核心组件\n\n#### 1. 规划-执行分离架构\n\n模板采用双角色设计：\n\n- **Planner（规划者）**：负责分析需求、制定计划、拆解任务\n- **Executor（执行者）**：负责按照计划编写代码、执行具体任务\n\n这种分离让 AI 能够像经验丰富的开发者一样"先思考后行动"，避免盲目编码。\n\n#### 2. 共享技能系统\n\n模板包含一个技能目录（skills/），用于存放：\n\n- 项目特定的编码规范\n- 常用的代码模式和技术栈约定\n- 测试和文档标准\n- 架构决策记录\n\n这些技能可以被 AI 代理在不同任务间复用，确保一致性。\n\n#### 3. 子代理机制\n\n支持将复杂任务委托给专门的子代理处理：\n\n- 前端子代理：专注于 UI 组件和样式\n- 后端子代理：专注于 API 设计和数据库\n- 测试子代理：专注于测试用例编写\n- 文档子代理：专注于文档维护\n\n#### 4. Beads 任务追踪\n\n集成 Beads 任务追踪系统，提供：\n\n- 任务状态看板\n- 进度追踪\n- 依赖关系管理\n- 完成度指标\n\n## 安装与使用\n\n### 快速开始\n\n将模板安装到现有项目：\n\n```bash\n# 克隆模板\ngit clone https://github.com/jsiovn/workflow-template.git\n\n# 复制到目标项目\ncp -r workflow-template/* /path/to/your/project/\n\n# 初始化\ncd /path/to/your/project\n./scripts/init-workflow.sh\n```\n\n### 目录结构\n\n安装后的项目结构：\n\n```\nyour-project/\n├── .workflow/              # 工作流配置\n│   ├── config.yaml        # 主配置\n│   ├── planner.md         # 规划者角色定义\n│   └── executor.md        # 执行者角色定义\n├── skills/                # 共享技能\n│   ├── coding-style.md    # 编码规范\n│   ├── architecture.md    # 架构指南\n│   └── testing.md         # 测试标准\n├── beads/                 # 任务追踪\n│   ├── backlog/           # 待办任务\n│   ├── in-progress/       # 进行中\n│   └── completed/         # 已完成\n├── subagents/             # 子代理定义\n│   ├── frontend.md\n│   ├── backend.md\n│   └── docs.md\n└── scripts/               # 辅助脚本\n    ├── plan.sh\n    ├── execute.sh\n    └── status.sh\n```\n\n## 工作流程详解\n\n### 阶段一：规划\n\n当开发者提出需求时，AI 首先进入规划模式：\n\n1. **需求分析**：理解用户意图和约束条件\n2. **任务拆解**：将大需求拆分为可执行的小任务\n3. **依赖排序**：确定任务执行顺序\n4. **资源评估**：估算工作量和潜在风险\n5. **计划生成**：输出结构化的执行计划\n\n规划结果被写入 beads/backlog/，等待执行。\n\n### 阶段二：执行\n\nAI 切换到执行模式，按计划工作：\n\n1. **读取计划**：从 backlog 获取下一个任务\n2. **技能加载**：加载相关的共享技能\n3. **代码编写**：实现功能，遵循编码规范\n4. **测试验证**：运行测试确保质量\n5. **状态更新**：将任务移至 completed/\n\n### 阶段三：审查\n\n执行完成后进入审查阶段：\n\n- 代码审查：检查是否符合规范\n- 测试审查：验证测试覆盖率\n- 文档审查：确保文档同步更新\n\n## 与 Claude Code 的集成\n\nworkflow-template 特别针对 Claude Code 优化：\n\n### 角色切换指令\n\n开发者可以使用简单指令切换 AI 模式：\n\n```\n/plan - 进入规划模式\n/exec - 进入执行模式\n/status - 查看任务状态\n/delegate [task] to [subagent] - 委托任务\n```\n\n### 上下文管理\n\nClaude Code 的长上下文窗口与模板的结构化设计完美配合：\n\n- 规划阶段加载完整的项目背景\n- 执行阶段聚焦当前任务的上下文\n- 技能文件作为持久化知识库\n\n### 文件系统感知\n\n模板利用 Claude Code 的文件系统能力：\n\n- 自动读取 skills/ 目录获取规范\n- 实时更新 beads/ 中的任务状态\n- 在代码中嵌入任务引用\n\n## 与 Codex 的兼容性\n\nworkflow-template 同样支持 OpenAI Codex：\n\n- 通过 .codex/ 目录提供 Codex 特定的配置\n- 适配 Codex 的函数调用模式\n- 支持 Codex 的代码解释器集成\n\n## 实际应用案例\n\n### 案例一：新功能开发\n\n**场景**：为电商网站添加购物车功能\n\n**传统方式**：AI 直接开始写代码，可能遗漏库存检查、价格计算等细节\n\n**使用 workflow-template**：\n1. Planner 分析需求，拆解为：数据库设计、API 开发、前端组件、集成测试\n2. 任务按依赖顺序进入 backlog\n3. Executor 逐个完成，每步都遵循架构规范\n4. 通过 beads 实时查看进度\n\n### 案例二：代码重构\n\n**场景**：将单体应用拆分为微服务\n\n**传统方式**：AI 可能遗漏服务间通信、数据一致性等关键问题\n\n**使用 workflow-template**：\n1. Planner 制定详细的迁移计划，识别依赖关系\n2. 按优先级排序服务拆分顺序\n3. 每个服务由专门的子代理处理\n4. 追踪每个服务的完成状态\n\n### 案例三：Bug 修复\n\n**场景**：修复生产环境的复杂 Bug\n\n**使用 workflow-template**：\n1. Planner 分析 Bug 报告，制定诊断计划\n2. 按步骤复现、定位、修复、验证\n3. 记录修复过程到知识库\n4. 更新测试防止回归\n\n## 优势与局限\n\n### 优势\n\n- **结构化**：强制规划阶段，减少盲目编码\n- **可追溯**：完整的任务历史记录\n- **可复用**：技能系统确保一致性\n- **可扩展**：子代理机制支持复杂项目\n- **透明**：开发者随时了解 AI 的工作状态\n\n### 局限\n\n- **学习成本**：需要理解模板的工作模式\n- **初期配置**：需要花时间编写技能文档\n- **灵活性降低**：严格的工作流可能不适合探索性任务\n- **工具依赖**：需要 Claude Code 或 Codex 支持\n\n## 最佳实践建议\n\n### 技能文档编写\n\n- 从最重要的规范开始，逐步完善\n- 使用具体示例而非抽象描述\n- 定期更新以反映项目演进\n\n### 任务粒度控制\n\n- 任务不宜过大（超过 30 分钟难以追踪）\n- 任务不宜过小（过度碎片化增加开销）\n- 保持原子性，一个任务一个目标\n\n### 人机协作\n\n- 关键决策点保留人工确认\n- 定期审查 AI 生成的计划\n- 将经验反馈到技能文档\n\n## 总结\n\nworkflow-template 代表了 AI 辅助开发工具的新方向——从简单的代码补全转向结构化的工作流程管理。它借鉴了敏捷开发、看板管理等成熟实践，将其适配到 AI 代理的工作模式。\n\n对于希望提升 AI 编码助手效率的开发者来说，这是一个值得尝试的项目。虽然需要一定的学习投入，但长远来看可以显著改善 AI 辅助开发的质量和可预测性。\n\n随着 AI 编码助手的普及，类似的工作流管理工具将成为标配。workflow-template 为这一领域提供了有价值的探索和实践参考。