计划模式通用规范（Plan Mode Skill）

何时使用

• 用户明确要求「先给出计划」「不要改代码，只出方案」「用 Plan 模式」或调用了「创建计划」类 command。
• 任务具备以下任一特征：多步骤、多文件、需评审后执行、涉及重构或跨模块改动。

必须遵守的规则

1. 只输出计划，不执行修改

   • 不创建、不修改、不删除任何项目文件。
   • 不运行终端命令（除非用户明确要求「只执行某条只读命令」如列出目录）。
   • 若有歧义，优先只输出结构化文档（如 Markdown 计划），由用户确认后再在 Agent 模式中执行。

2. 计划结构（必须包含）

   • 目标与范围：用 1～2 句话概括任务目标；明确范围（模块/包/文件类型，如只改 Controller、只加测试）。
   • 约束与前提：不可改动的部分、依赖、引用的规范（如 .cursor/rules 下的规则）。
   • 实施步骤：按执行顺序编号；每步含标题、一句话说明、涉及文件或路径（路径或 glob）；步骤间有依赖时注明「完成步骤 N 后再执行」。
   • 涉及文件清单：表格式：操作（新增/修改/删除）、路径、说明。
   • 验收要点：可逐条检查的验收标准（如「所有 Controller 方法均有 @ApiOperation」「单测通过且覆盖主分支」）。
   • 可选：实施顺序示意：简短列表或 mermaid flowchart 表示步骤顺序。

3. 与项目规范一致

   • 若项目有 .cursor/rules（如 backend-java.mdc、api.mdc），计划中的命名、分层、包结构、文件位置需与之一致。
   • 涉及字典、SQL、实体、Controller 等时，可引用对应规则文件名，便于执行阶段遵守。

4. 可执行性

   • 步骤尽量可单独执行（例如「步骤 1：只改 Controller；步骤 2：只加测试」），便于用户在 Agent 模式中分步执行。
   • 建议在计划末尾注明：「执行时请切换到 Agent 模式，并指定按本计划第 N 步执行」或「将本计划保存为 .cursor/plans/xxx.plan.md 后，在 Agent 中引用该文件执行」。