mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-01 15:03:57 +08:00
c3ddf7e322
- Add docs directory with VitePress configuration - Add GitHub Actions workflow for docs build and deploy - Support bilingual (English/Chinese) documentation - Include search, custom theme, and responsive design
3.8 KiB
3.8 KiB
工作流最佳实践
优化您的 CCW 工作流以获得最高效率和质量。
规格说明阶段
应该做的
- 从明确的目标开始: 提前定义成功标准
- 让利益相关者参与: 从所有利益相关者收集需求
- 记录假设: 将隐性知识显式化
- 及早识别风险: 评估技术和项目风险
不应该做的
- 跳过研究阶段
- 未经验证就假设需求
- 忽略技术约束
- 过度设计解决方案
规划阶段
应该做的
- 分解任务: 细粒度的任务更容易估算
- 映射依赖: 及早识别任务关系
- 现实估算: 使用历史数据进行估算
- 规划迭代: 为未知因素预留缓冲
不应该做的
- 创建单体任务
- 忽略任务依赖
- 低估复杂度
- 提前规划所有内容
实现阶段
应该做的
- 遵循计划: 相信规划过程
- 边写边测: 与代码同步编写测试
- 记录变更: 保持文档同步
- 频繁验证: 每次变更后运行测试
不应该做的
- 未经讨论偏离计划
- 为了速度跳过测试
- 推迟文档编写
- 忽略反馈
验证阶段
应该做的
- 全面测试: 覆盖正常路径和边界情况
- 审查代码: 使用代码审查指南
- 衡量质量: 使用自动化指标
- 记录发现: 创建测试报告
不应该做的
- 跳过边界情况测试
- 忽略审查反馈
- 仅依赖手动测试
- 隐藏测试失败
团队协调
沟通
- 使用 SendMessage: 始终通过协调器沟通
- 具体明确: 清晰的消息减少来回沟通
- 报告进度: 定期更新状态
- 上报阻塞: 不要等待阻塞问题
协作
- 尊重边界: 每个角色有特定职责
- 信任流程: 工作流确保质量
- 分享知识: 贡献智慧文件
- 从失败中学习: 事后分析改进未来工作流
常见陷阱
规格说明
| 陷阱 | 影响 | 预防措施 |
|---|---|---|
| 模糊的需求 | 返工 | 使用验收标准 |
| 缺少约束 | 实现失败 | 明确列出非功能性需求 |
| 范围不清 | 范围蔓延 | 定义范围内/范围外 |
规划
| 陷阱 | 影响 | 预防措施 |
|---|---|---|
| 乐观估算 | 延误 | 使用不确定性锥 |
| 未知依赖 | 任务阻塞 | 先探索代码库 |
| 单线程规划 | 瓶颈 | 识别并行机会 |
实现
| 陷阱 | 影响 | 预防措施 |
|---|---|---|
| 跳过测试 | 生产环境 Bug | 测试优先方法 |
| 忽略反馈 | PR 被拒绝 | 处理审查意见 |
| 镀金 | 交付延迟 | 遵循需求 |
工作流优化
减少周期时间
- 批量处理相似任务: 减少上下文切换
- 自动化验证: 持续集成
- 并行执行: 识别独立任务
- 快速推进: 对简单继任跳过协调器
提高质量
- 早期验证: 测试优先开发
- 同行审查: 多审查者视角
- 自动化测试: 全面的测试覆盖
- 指标跟踪: 衡量质量指标
有效扩展
- 史诗分解: 大项目 → 史诗 → 任务
- 团队专业化: 基于角色的智能体分配
- 知识共享: 智慧积累
- 流程改进: 持续改进
示例
良好的工作流
[Specification]
↓ Clear requirements with acceptance criteria
[Planning]
↓ Realistic estimates with identified dependencies
[Implementation]
↓ Tests pass, documentation updated
[Validation]
↓ All acceptance criteria met
[Complete]
有问题的工作流
[Specification]
↓ Vague requirements, no acceptance criteria
[Planning]
↓ Optimistic estimates, missed dependencies
[Implementation]
↓ No tests, incomplete documentation
[Validation]
↓ Failed tests, missing requirements
[Rework]
::: info 另见