从需求到交付全流程:cc-use-exp 的 /new-feature、/design、/review 工作流完整实战
从需求到交付全流程:cc-use-exp 的 /new-feature、/design、/review 工作流完整实战
cc-use-exp 是一套让 Claude Code、Gemini CLI、Codex、Cursor 开箱即用的分层配置模板,把十多年日常开发经验沉淀成可直接调用的 AI 编码工作流。本文带你完整跑通 /new-feature(新功能开发)、/design(技术设计)、/review(代码审查)三大命令,实现从需求到交付的闭环实战。
为什么值得用工作流:告别"一段提示词打天下"
直接用 AI 编码时,新手最常遇到这三个问题:
- 需求靠猜:一句话需求丢给 AI,它按自己的理解开干,边界条件、异常处理全靠运气
- 进度靠记:对话一断,改到哪一步、改过哪些文件,全得从头回忆
- 质量靠刷:代码写完没人把关,字段映射、条件分支这类隐蔽错误溜进生产环境
cc-use-exp 的解决思路是把协作约定分层:规则常驻保护、技能按需加载、命令显式调用执行标准工作流。本文聚焦第三层——输入 /命令名 就能启动的三大工作流,命令定义位于 commands/ 目录:
| 命令 | 作用 | 适合场景 | 定义文件 |
|---|---|---|---|
/design |
生成技术设计文档 / 质量检查清单 | 动手前先定方案 | commands/design.md |
/new-feature |
需求审问 → 设计 → 实现 → 自审,一站式开发 | 完整功能开发 | commands/new-feature.md |
/review |
full / quick / security 三种代码审查 | 提交前把关 | commands/review.md |
下面是装了 cc-use-exp 之后的真实开发环境,AI 编码助手在会话中接管整个开发流程:
第一步:使用 /design 命令生成设计文档
/design 命令支持两种模式(见 commands/design.md):
模式 1:/design doc 功能描述(默认)——生成技术设计文档框架
文档框架覆盖十个章节,从需求背景一路排到部署迁移:
| 章节 | 内容要点 |
|---|---|
| 一、需求背景 | 业务背景和目标 |
| 二、核心原则 | 3-5 条指导设计决策的原则 |
| 四、数据库设计 | 新增/修改表、字段说明 |
| 五、功能设计 | 界面设计、处理逻辑 |
| 六、接口设计 | 请求/响应格式、实现位置 |
| 八、影响范围评估 | 改动范围 + 风险评估 |
| 九、测试要点 | 功能测试清单、测试用例 |
| 十、部署/迁移说明 | 数据库迁移、配置变更 |
模式 2:/design checklist 功能描述——生成设计质量检查清单
该模式对标 S-Tier SaaS 设计标准(参考 Stripe、Airbnb、Linear),从核心设计原则、视觉设计、交互设计、响应式、可访问性(WCAG 2.1 AA)、性能六大维度逐项检查,最后输出一份带星级评分的设计检查报告:通过项、建议改进项、必须修复项一目了然。
💡 实战建议:中小功能可以跳过独立设计,直接用 /new-feature(它内部自带设计环节);跨模块、动数据库的功能,先跑 /design doc 把方案定下来再开发。
第二步:/new-feature 一键跑通需求到实现
/new-feature 是核心工作流:在 Claude Code 会话中输入 /new-feature 你的功能描述,例如 /new-feature 支持批量导出对账报表,它会按四步自动推进(完整流程见 commands/new-feature.md):
第 1 步:需求审问 —— 针对你的功能描述,AI 快速提出 3-5 个关键问题,聚焦:
- 边界条件(数据量上限、并发场景)
- 异常处理(失败重试、回滚策略)
- 依赖关系(涉及哪些模块和接口)
比如开发"批量导出报表",它可能会问:单次导出上限是多少条?导出失败怎么通知用户?是否依赖异步任务模块?回答完才继续,从源头消灭"AI 按自己的理解开干"。
第 2 步:技术设计 + 创建任务文件 —— 基于你的回答输出涉及文件(3-5 个)、数据结构、关键步骤(3-5 步),你确认后自动创建任务文件 .claude/tasks/{功能名}-{日期}.md,记录需求摘要、关键决策和实现计划清单。
第 3 步:实现 + 同步更新 —— 按步骤实现,每完成一步就把任务文件里的步骤标记为 [x]、当前步骤标记为 [~],并追加"已修改文件"清单。进度不再只留在对话里,随时可见。
第 4 步:自审 + 归档 —— 自动执行 /review quick 快速审查,更新任务状态为"已完成",并将任务文件移入 .claude/tasks/archived/ 归档。
中断恢复:网络断了也不怕
这是新手最容易忽略的亮点。如果任务中途被网络断开、上下文超限或手动停止打断,下次执行 /new-feature 或 /new-feature --resume 时会自动检测到 .claude/tasks/ 下的未完成任务,列出任务名和状态询问你是否继续——选择继续就会读取任务文件,从未完成的步骤接着做,不用重新交代背景。
⚠️ 流程主权:该命令声明了对"需求到实现"全流程的控制权,执行期间不会被外部 skill 抢走设计/实现流程,任务文档也只会写入
.claude/tasks/,避免产物散落在各处。
第三步:/review 三种审查模式收尾把关
开发完成后,/review 提供三种审查模式(见 commands/review.md):
| 命令 | 模式 | 特点 |
|---|---|---|
/review 或 /review full |
全量审查 | 八维度深度审查,输出结构化报告 |
/review quick |
快速审查 | 一键 diff + 结论,不啰嗦 |
/review security |
安全专项 | 只报高置信度漏洞,宁缺毋滥 |
支持追加 commit hash 审查指定提交,如 /review quick a1b2c3d,参数顺序灵活。
full 模式的八维审查框架按优先级依次检查(详见 commands/review.md):
- 架构设计:是否符合现有架构模式,有无不必要复杂度
- 功能正确性:业务逻辑、边界条件、并发与状态管理
- 安全性:输入验证、认证授权、敏感信息处理
- 可维护性:命名、注释意图、错误信息可读性
- 测试:关键路径、边界与错误场景覆盖
- 性能:N+1 查询、内存分配、缓存策略
- 文件规模:对照语言阈值(Java 300 / Go 400 / Vue 200 行等)给出拆分建议
- 重构与字段映射安全:列/字段/枚举是否遗漏,条件分支是否全覆盖,循环依赖检测
审查结果按 <a href="https://link.gitcode.com/i/0043bad3f633b672424761ee87d8a02f" target="_blank">Critical] 严重问题、[Improvement] 建议改进、[Nit] 细节建议分级,结论分为"通过 / 需修改后通过 / 需重新设计"。若结论不是直接通过,命令会询问你选择修复范围(只修严重问题 / 全部修复 / 跳过),并自动调用 [/fix 命令 执行修复——此时修复被严格约束在变更范围内:只改 diff 涉及的文件、禁止重构、禁止改变现有行为、最小修改,防止"顺手优化"引入新 bug。
💡 新手建议:日常小改动用 /review quick 即可;涉及数据库、支付、权限的代码,务必加跑一次 /review security。
收尾:/commit-msg 生成规范提交信息
审查通过后,执行 /commit-msg 会自动分析未提交的变更,按 Conventional Commits 规范生成结构化的 commit message(见 commands/commit-msg.md):自动判断 feat / fix / refactor 等类型,subject 不超过 50 字符,正文用列表列出变更点,且不加 emoji、不加 AI 生成声明。提交信息从此告别"update code"。
实战小贴士:让工作流效果最大化
- 推荐执行顺序:
/design doc(定方案)→/new-feature(开发 + 自审)→/review(深度把关)→/commit-msg(规范提交)。小功能可从第二步直接开始 - 配合需求命令:需求复杂时,先用 /requirement 命令 生成需求文档框架或用
interrogate模式做"极刑审问",挖出逻辑漏洞再进入设计 - 跨工具复用:同样的工作流在 Codex 中以
$cc-new-feature、$design、$cc-review等 workflow skill 调用,Gemini CLI、Cursor 也有对应命令,一套经验多端通用 - 关注 token 消耗:工作流的任务文件持久化机制大幅减少了"重新交代背景"的重复对话。长会话中可以留意 Claude Code 会话里的 Token 明细面板,评估实际成本:
总结
cc-use-exp 把"需求审问 → 技术设计 → 分步实现 → 审查修复 → 规范提交"这条完整的软件交付链路,固化成三个可以随时调用的命令:
/design:动手前先定方案,文档框架十章节齐活/new-feature:任务文件持久化,中断了还能--resume接着跑/review:八维度把关 + 修复闭环,提交前最后一道防线
更多配置细节可参考 docs/guides/claude-code.md 与 docs/guides/installation-verification.md,安全类技能(如 skills/refactor-safety、skills/field-mapping-safety)会在你操作对应文件时自动加载,与三大工作流形成完整的质量防线。

