从需求到交付全流程:cc-use-exp 的 /new-feature、/design、/review 工作流完整实战

原创2026-10-15 06:08:411,335 阅读

从需求到交付全流程: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 编码助手在会话中接管整个开发流程:

cc-use-exp 工作流实战环境:Claude Code 与浏览器联动进行 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):

  1. 架构设计:是否符合现有架构模式,有无不必要复杂度
  2. 功能正确性:业务逻辑、边界条件、并发与状态管理
  3. 安全性:输入验证、认证授权、敏感信息处理
  4. 可维护性:命名、注释意图、错误信息可读性
  5. 测试:关键路径、边界与错误场景覆盖
  6. 性能:N+1 查询、内存分配、缓存策略
  7. 文件规模:对照语言阈值(Java 300 / Go 400 / Vue 200 行等)给出拆分建议
  8. 重构与字段映射安全:列/字段/枚举是否遗漏,条件分支是否全覆盖,循环依赖检测

审查结果按 <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 明细面板,评估实际成本:

Claude Code 会话中的 Token 消耗明细面板,控制 AI 编码工作流成本

总结

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)会在你操作对应文件时自动加载,与三大工作流形成完整的质量防线。

登录后查看全文
cc-use-exp