---
title: "计划规则"
description: "根据你的角色和专业背景，自定义澄清与计划的呈现方式"
---

计划规则通过个性化 Verdent 呈现需求、澄清和实现计划的方式，为 **Plan** 阶段提供支持。你可以使用内置的基于角色的模板作为起点，也可以创建完全自定义的规则，以匹配你的思维方式和工作习惯。

###  你将学到

- 计划规则如何自定义计划呈现
- 内置角色模板（前端、测试、产品经理）
- 创建自定义计划规则
- 何时应用计划规则

---

## 计划规则可以自定义的内容

计划规则控制 Verdent 在 Plan Mode 中呈现计划的方式：

<Tabs>
  <Tab title="呈现格式">
    - **概要-详情-概要** - 开头是执行概要，中间是详细步骤，末尾是影响概要
    - **图表优先** - 以可视化呈现为主导，文字提供补充细节
    - **表格 vs 叙述** - 结构化表格便于扫描数据，散文式叙述用于情境化解释
    - **章节排序** - 自定义哪些章节优先出现，并定义层级结构

    <Tip>
      在快速理解至关重要的利益相关者评审中，使用概要-详情-概要。当在深入实现之前架构理解至关重要时，使用图表优先。
    </Tip>
  </Tab>
  <Tab title="内容深度">
    - **高层战略** - 聚焦"做什么"和"为什么"，技术细节最少
    - **详细技术** - 包含实现细节、代码模式、架构决策
    - **代码示例** - 控制代码是否出现（包含/排除、完整 vs 片段、diff 格式）
    - **测试内容** - 在 QA 工作流中默认包含，在以 PM 为中心的计划中省略

    <Tip>
      让内容深度匹配你的受众。在跨团队协作时使用高层战略，在独自实现或与资深开发者协作时使用详细技术。
    </Tip>
  </Tab>
  <Tab title="可视化元素">
    - **Mermaid 图表** - 流程图、序列图、状态机（自动生成或显式指定）
    - **DOM 层级树** - 以树状文件夹格式呈现组件结构
    - **线框图** - UI 草图和布局示意
    - **样式表** - CSS 规格说明，带合并单元格，按组件组织

    <Tip>
      Mermaid 图表会在请求时根据计划内容自动生成。如果你希望默认包含特定图表类型，请在计划规则中显式要求。
    </Tip>
  </Tab>
  <Tab title="默认行为">
    - **默认省略** - 测试、样式、向后兼容性（减少计划长度）
    - **必需元素** - 验收标准、边界情况、KPI（确保生产就绪）
    - **澄清偏好** - 多轮澄清 vs 单次确认 vs 不确认

    <Tip>
      先从省略开始以保持计划简洁，然后仅为你真正需要的内容添加必需元素。你随时可以在特定计划会话中请求被省略的内容。
    </Tip>
  </Tab>
  <Tab title="角色专属">
    - **前端** - 带图表、DOM 树、样式表的可视化架构，默认省略测试
    - **QA/测试** - 带覆盖矩阵的测试用例表、边界值分析、可追溯性
    - **产品经理** - 仅业务需求、图表/线框图、无代码片段

    <Tip>
      从一个角色模板开始，然后在此基础上自定义。大多数开发者以前端或 QA 模板为基础，并调整特定章节以匹配自己的工作流。
    </Tip>
  </Tab>
</Tabs>

---

## 基于角色的计划模板

Verdent 提供专业角色模板，自动调整计划结构、内容深度和呈现风格：

<Tabs>
  <Tab title="前端">
    **聚焦：** 带可视化结构的技术实现计划

    **关键特征：**

    - 规划前进行全面的代码库研究
    - 用 Mermaid 流程图和状态图表示交互流程
    - 以树状文件夹格式呈现 DOM 层级
    - 带合并单元格的样式表，呈现 CSS 属性
    - **省略：** 默认省略测试内容和样式（除非请求）
    - **提供：** 明确的解决方案，不提供多个选项

    **最适合：** 需要可视化架构和清晰实现路径的前端开发者
  </Tab>
  <Tab title="测试">
    **聚焦：** 全面的测试用例生成和质量保证

    **关键特征：**

    - 目标导向的测试设计（业务逻辑、安全性、稳定性）
    - 用 9 列 Markdown 表格呈现结构化测试用例
    - 等价类、边界值和关键参数
    - 全覆盖：正常、备选、异常和边界情况
    - 注重可执行性，支持自动化
    - 可追溯到需求点

    **最适合：** 需要系统化测试覆盖的 QA 工程师和测试自动化专家
  </Tab>
  <Tab title="产品经理 (PM)">
    **聚焦：** 从业务视角出发的产品需求

    **关键特征：**

    - **无代码片段或技术实现**
    - 聚焦"做什么"和"为什么"，而非"怎么做"
    - 序列图、流程图和线框图
    - 带优先级的需求清单和前后对比
    - 带处理策略的边界情况
    - 带 KPI 和事件追踪的数据规格说明

    **最适合：** 在不引入技术污染的情况下定义业务需求的产品经理
  </Tab>
</Tabs>

---

## 自定义计划规则

通过定义以下内容创建个性化的计划规则：

**规则组成：**

- **呈现风格** - 概要-详情-概要、图表优先或表格格式
- **内容深度** - 高层概览 vs 详细实现
- **省略项** - 默认排除的内容（测试、样式、向后兼容性）
- **必需元素** - 强制章节（图表、验收标准、数据规格）
- **交互偏好** - 澄清方式、确认要求

<Tip>
  在 Plan Mode 中，点击输入框中的 **Plan Rules** 按钮，可快速访问并修改你的计划规则。
</Tip>

**规则应用：**

- 应用于所有 Plan Mode 会话
- 在工作区会话间持久保存
- 可通过内联指令覆盖
- 与自定义子智能体协同工作

**了解更多：** 在工作区中创建或编辑 `Plan.md`，使用 Markdown 格式定义自定义计划规则。

---

## 另请参阅

<CardGroup cols={3}>
  <Card title="专业计划" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    将想法转化为实现计划
  </Card>
  <Card title="澄清循环" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    交互式需求精化
  </Card>
</CardGroup>