用途
workflows-plan 用于为新的功能、缺陷修复或改进想法创建项目计划。它把功能描述、缺陷报告或改进想法转化为结构良好的 Markdown 计划文件,使其符合项目约定与最佳实践。该命令提供灵活的详细程度,以匹配不同需求。
主要能力
- 想法细化:在提问前先检查 docs/brainstorms/ 中是否有匹配的头脑风暴文档。相关性标准为:主题(来自文件名或 YAML frontmatter)与功能描述语义匹配,且创建于最近 14 天内。若存在多个候选,使用最新的一个。若找到相关头脑风暴,会通读全文并宣布“Found brainstorm from [date]: [topic]. Using as foundation for planning.”,同时将关键决策及其理由、选定方案与被拒替代方案、约束与需求、待解决问题、成功标准与范围边界、具体技术选择或模式全部带入计划,并在计划中通过 (see brainstorm: docs/brainstorms/<filename>) 引用具体决策。若没有相关头脑风暴,则通过 AskUserQuestion 工具进行协作式对话,一次一个问题地理解目的、约束与成功标准,直到想法清晰或用户表示“proceed”。
- 本地研究:并行运行 repo-research-analyst 与 learnings-researcher 两个代理,收集仓库现有模式、CLAUDE.md 指导、技术熟悉度、模式一致性,以及 docs/solutions/ 中可能适用的已记录解决方案(陷阱、模式、经验教训)。
- 研究决策:根据信号决定是否进行外部研究。高风险主题(安全、支付、外部 API、数据隐私)始终研究;本地上下文充分则跳过外部研究;存在不确定性或不熟悉领域则研究。会宣布决定并简要说明。
- 外部研究(条件性):仅在需要时并行运行 best-practices-researcher 与 framework-docs-researcher 两个代理。
- 研究整合:记录相关文件路径、机构经验、外部文档 URL 与最佳实践、相关 issue 或 PR、CLAUDE.md 约定。可选地简要总结并询问是否有遗漏。
- 问题规划与结构:使用常规格式拟定清晰可搜索的标题(如 feat: Add user authentication、fix: Cart total calculation),确定类型(enhancement、bug、refactor),将标题转为文件名(加日期前缀、去掉前缀冒号、kebab-case、加 -plan 后缀),例如 feat: Add User Authentication → 2026-01-21-feat-add-user-authentication-plan.md。进行利益相关者分析与内容规划。
- SpecFlow 分析:运行 compound-engineering:workflow:spec-flow-analyzer,审查结果并将发现的缺口或边界情况纳入 issue,更新验收标准。
- 选择实现详细程度:提供三档。MINIMAL(快速 issue)适合简单缺陷、小改进、清晰功能,包含问题陈述或功能描述、基本验收标准、必要上下文。MORE(标准 issue)适合大多数功能、复杂缺陷、团队协作,在 MINIMAL 基础上增加详细背景与动机、技术考量、成功指标、依赖与风险、基本实现建议,并包含 System-Wide Impact 等章节。A LOT(综合 issue)适合大型功能、架构变更、复杂集成,在 MORE 基础上增加分阶段详细实现计划、考虑过的替代方案、大量技术规格、资源需求与时间线、未来考量与可扩展性、风险缓解策略、文档需求。
- 问题创建与格式化:使用清晰描述性标题与层级、带语言高亮的代码块、任务列表、可折叠的 <details> 区块、适当 emoji;进行交叉引用(#number、commit SHA、GitHub permalink、@username);并考虑 AI 时代因素(AI 结对编程、记录有效提示、注明使用的 AI 工具、强调全面测试、标记需人工审查的 AI 生成代码)。
- 最终审查与提交:若计划源自头脑风暴,重新阅读并核对每项关键决策、选定方案、约束与需求、待解决问题、origin frontmatter 字段与 Sources 章节。提交前检查清单包括标题可搜索、标签准确、模板章节完整、链接有效、验收标准可衡量、在伪代码示例与待办列表中写明文件名、如涉及新模型变更则添加 ERD mermaid 图。
- 写入计划文件:必需步骤,先执行 mkdir -p docs/plans/,再用 Write 工具将完整计划保存到 docs/plans/YYYY-MM-DD-<type>-<descriptive-name>-plan.md。此步骤强制且不可跳过,即使在 LFG/SLFG 或其他自动化流水线中运行也一样。完成后确认“Plan written to docs/plans/[filename]”。
使用方式
该技能以命令形式调用,接受功能描述作为参数(<feature_description> #$ARGUMENTS </feature_description>)。若功能描述为空,会询问用户“What would you like to plan? Please describe the feature, bug fix, or improvement you have in mind.”,在获得清晰描述前不会继续。注意:当前年份为 2026 年,用于标注计划日期和搜索近期文档。
适用场景
适用于需要将功能想法、缺陷报告或改进建议转化为结构化项目计划的开发工作流,尤其适合遵循项目约定、需要研究支撑与验收标准的团队协作场景,也可用于自动化流水线(LFG、SLFG 等)。
限制
资料未提供该技能的收费、价格、平台支持范围或具体效果数据。计划文件必须写入 docs/plans/ 目录,此步骤不可跳过。外部研究仅在满足条件时运行。