ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

claude-code-workflows常见问题FAQ:docs/plans要不要提交?Lite Mode到底跳过了哪些检查?

claude-code-workflows常见问题FAQ:docs/plans要不要提交?Lite Mode到底跳过了哪些检查?

【免费下载链接】claude-code-workflows

Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.

项目地址:https://gitcode.com/gh_mirrors/cla/claude-code-workflows
点击查看免费下载

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.

项目地址:https://gitcode.com/gh_mirrors/cla/claude-code-workflows
点击查看免费下载

相关推荐

上一篇:JASP统计分析软件:从数据探索到科学决策的免费开源桥梁
下一篇:py12306购票助手:三分钟快速上手与高效抢票实战指南

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进