# 计划模式通用规范（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 中引用该文件执行」。