用途
plan-feature 用于系统化地搭建一个新功能,覆盖从规划到实现结构的全过程。当用户输入 /plan-feature 时使用。
主要能力
- 目标先行:在规划开始前捕获并展示功能目标,便于用户对齐。输出 ## Goals 部分,包含 3–7 条要点,概括范围、成功标准和约束,并在继续前与用户确认或调整。
- 收集上下文:匹配 glob 规则与技能,然后读取 apps/docu/content/docs/ 下的主题 MDX。规则优先于技能。
- 定义需求:明确范围、识别用户故事与验收标准、规划技术方案。
- 汇总假设:在详细规划前列出 3–5 条要点。
- 创建功能分支:从 main/develop 拉出分支,设置本地开发,配置依赖。
- 规划架构:设计数据模型与 API、规划 UI 组件与流程、考虑测试策略、记录需求。
- 添加图表:针对架构、数据流或组件关系生成 Mermaid 图表。可使用 flowchart(流程)、sequenceDiagram(API/请求流)、classDiagram(结构)、erDiagram(数据库模式)、stateDiagram-v2(生命周期)。要求标签清晰、用子图分组、包裹在 mermaid 代码块中;复杂时拆分为多个图表。
使用方式
用户输入 /plan-feature 触发。流程依次为:列出目标并与用户确认、收集上下文、定义需求、汇总假设、创建功能分支、规划架构、按需添加 Mermaid 图表。
输出结构
先输出 ## Goals,然后是正文,最后是 ## References。References 中列出所使用的每条规则、技能和 MDX 页面的路径(纯路径,不带 @)。示例:apps/docu/content/docs/architecture/api.mdx、.cursor/rules/backend/fastify.mdc、.agents/skills/fastify-v5。
适用场景
适用于需要从规划到实现结构系统化搭建新功能的开发场景,尤其适合需要先对齐目标、明确需求、规划架构并记录决策的功能开发工作。
限制
遇到不确定情况时应提问;对于模糊、高风险的决策,交由用户决定。