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

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

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

原作者与来源

• 原作者/维护者：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\n1. 规划-执行分离架构\n\n模板采用双角色设计：\n\n- Planner（规划者）：负责分析需求、制定计划、拆解任务\n- Executor（执行者）：负责按照计划编写代码、执行具体任务\n\n这种分离让 AI 能够像经验丰富的开发者一样"先思考后行动"，避免盲目编码。\n\n2. 共享技能系统\n\n模板包含一个技能目录（skills/），用于存放：\n\n- 项目特定的编码规范\n- 常用的代码模式和技术栈约定\n- 测试和文档标准\n- 架构决策记录\n\n这些技能可以被 AI 代理在不同任务间复用，确保一致性。\n\n3. 子代理机制\n\n支持将复杂任务委托给专门的子代理处理：\n\n- 前端子代理：专注于 UI 组件和样式\n- 后端子代理：专注于 API 设计和数据库\n- 测试子代理：专注于测试用例编写\n- 文档子代理：专注于文档维护\n\n4. Beads 任务追踪\n\n集成 Beads 任务追踪系统，提供：\n\n- 任务状态看板\n- 进度追踪\n- 依赖关系管理\n- 完成度指标\n\n安装与使用\n\n快速开始\n\n将模板安装到现有项目：\n\nbash\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 为这一领域提供了有价值的探索和实践参考。