【免费下载链接】claude-code-workflows
Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.
claude-code-workflows 是一套面向 Claude Code 的开源开发工作流(development workflows)插件:它先与你对齐结果和排除项,再对照仓库检查设计,逐任务验证,并在较大改动上做一次独立评审,让 Claude 的广泛探索始终收敛在已批准的结果上。📌 本文针对新手最常问的两个问题逐条解答:docs/plans/目录要不要提交、Lite Mode 到底跳过了哪些检查。
Q1:docs/plans 要不要提交?
结论先行:不要提交。recipe 把docs/plans/视为"临时工作状态"(ephemeral working state)。
为什么它是临时状态?
- Task 文件(
docs/plans/tasks/)会在执行中被消费,成功完成后自动删除 - 中间修复文件(intermediate fix files)同样会在成功后清理
- Work Plan(
docs/plans/{plan-name}.md)可保留用于评审或之后继续构建,不再需要时直接删除即可
recipe-build 的执行流程明确规定:docs/plans/是临时工作状态,不在 recipe 运行之间保留,已消费的任务文件属于本次运行的"Consumed Task Set",完成后删除。
.gitignore 一步配置
在项目根目录的.gitignore中加入这一行,让这些工作状态不进入版本控制:
docs/plans/⚠️ 这些文档才应该提交!
docs/plans/只是"执行草稿区",项目真正的长期资产在各自独立目录中,且应当提交。对照文档标准中的存放位置表:
| 文档 | 路径 | 是否提交 |
|---|---|---|
| PRD(产品需求文档) | docs/prd/ | ✅ 提交 |
| ADR(架构决策记录) | docs/adr/ | ✅ 提交 |
| UI Spec(UI 规格) | docs/ui-spec/ | ✅ 提交 |
| Design Doc(设计文档) | docs/design/ | ✅ 提交 |
| Work Plan(工作计划) | docs/plans/ | ❌ 忽略 |
| Task File(任务文件) | docs/plans/tasks/ | ❌ 忽略(自动清理) |
💡 记忆口诀:PRD、ADR、UI Spec、Design Doc 记录的是"决策与共识",值得留在仓库;Work Plan 和 Task 文件只是"执行草稿",做完即弃。
Q2:Lite Mode 到底跳过了哪些检查?
Lite Mode 是用户主动开启的"提速模式":用更少的中间验证换取更低的成本,但所有阶段和审批停靠点(approval stops)原样保留。
如何开启 Lite Mode
在任意 recipe 请求的开头加上 "Lite mode" 即可:
/recipe-implement "Lite mode. Add rate limiting to the public API"开启后它会保持到当前会话结束,直到你明确要求 Claude 退出 Lite Mode 才会关闭。
Lite Mode 跳过的检查清单
根据官方 Lite Mode 规范,一共省略 4 项子代理调用:
| 子代理 | 正常模式的作用 | Lite Mode 的行为 |
|---|---|---|
code-verifier | 验证每个任务的结果 | 省略;消耗其结果的步骤直接继续,document-reviewer不再收到verification_evidence |
design-sync | 一致性检查(设计文档之间及与仓库对照) | 省略;其后的停靠点改在前置步骤完成时触发 |
security-reviewer | 独立的安全评审 | 省略;实施后评审仅由code-reviewer单独完成 |
每任务quality-fixer | 每次提交前运行一次质量检查 | 省略;任务循环从第 2 步直接进入第 4 步(提交),改由 Final Quality Run 替代 |
Lite Mode 保留了什么?
- ✅ 相同的工作阶段与所有审批停靠点,关键节点仍会暂停征求你的确认
- ✅最终代码评审照常运行(
code-reviewer) - ✅Final Quality Run:最后一个任务提交后、实施后评审前,
quality-fixer按层各运行一次,替代逐任务的质量检查
📌 小改动例外:对于没有 Work Plan 任务集的单循环流程(如 Small 级别改动),Lite Mode 会保留quality-fixer 调用——因为它本来就等价于最后一次运行。
一句话总结:Lite Mode 不是"跳过质量把关",而是把检查从"每次提交前"集中到"最后统一做一次",并去掉非必要的独立验证,最终代码评审与安全评审之外的部分依然兜底。
顺带回答两个高频小问题
- 测试、类型检查、lint、构建报错怎么办?不用担心,工作流会在已批准的结果范围内自行修复这些失败,包括同一职责或契约所要求的相邻改动。
- OpenAI Codex CLI 有对应版本吗?有,姊妹项目
codex-workflows将同样的工作流模型适配到了 Codex CLI 环境。
延伸资料
- 完整 FAQ 与使用指南:README.md
- Lite Mode 完整规则:lite-mode.md
- 文档存放与命名规范:documentation-criteria/SKILL.md
- 任务执行循环(4 步循环与清理逻辑):recipe-build/SKILL.md
【免费下载链接】claude-code-workflows
Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.
相关推荐
AI写代码也要过安检:claude-code-workflows的security-reviewer安全审查深度使用指南
AI写代码也要过安检:claude code workflows的security reviewer安全审查深度使用指南 AI 写的代码会不会埋后门?会不会把密
AI写的代码也要过审:claude-code-workflows的code-reviewer独立审查机制实战指南
AI写的代码也要过审:claude code workflows的code reviewer独立审查机制实战指南 📌 一句话概要 : claude code
大模型都这么强了,还要不要认真写提示词?Claude Code 开发者的反直觉论断
大模型都这么强了,还要不要认真写提示词?Claude Code 开发者的反直觉论断 最近,程序员圈子里因为一句话吵得挺热闹。 一位 Claude Code 的开
开发工具AI 应用人工智能AI Agent
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考