提示也要讲可读性
长提示是一份要进版本库、要被多人改的工程资产，可读性直接影响评审成本与改动风险。用分节标题、编号和段落间空行组织内容，改一处 diff 只显示那一行，新成员能按节定位到具体规则。反过来说，把任务、规则、示例揉在一段里，任何小改动都要重读全篇才敢动手。
基本信息
| 排版 | 标题分级 + 编号 + 段落间空行 |
|---|---|
| 收益 | 改动 diff 最小化；评审与定位更快 |
| 禁忌 | 同一段落里混放多个不同层级的规则 |
| 层级 | 标题控制在一到两级，过深反而难读 |
典型使用场景
- 多人协作维护同一份系统提示，需要看清谁改了哪条规则
- 提示进入 CI 回放流程，变更要能逐行 review
- 排查线上行为异常：快速定位是哪一节规则导致
- 把长提示拆成可复用组件（角色、格式、禁忌分别管理）
- 交接与培训：新成员按目录结构理解提示结构
分节结构示例
分节结构示例
## 1. 任务
## 2. 输入数据
## 3. 处理规则
3.1 数据清洗
3.2 异常判定
## 4. 输出格式
## 5. 示例
## 6. 常见错误（禁止事项）
# 每条规则独占一行，编号稳定不变
# 禁止把输出格式与业务规则写在同一段写法与代价对照
| 写法 | 收益 | 代价与边界 |
|---|---|---|
| 分节 + 编号 | 差异可定位，规则可引用 | 编号改动要同步更新引用 |
| 规则一条一行 | diff 最小，冲突易解决 | 行数变多，需靠标题组织 |
| 统一称谓与术语 | 减少模型理解歧义 | 术语表要单独维护 |
| 示例集中在末节 | 正文更紧凑 | 示例与规则隔得远，需交叉引用 |
版式大改时要注意：即使语义等价，模型也可能把它当作一份新提示来理解。重排之后应重跑回归用例，确认行为没有变化，而不是假定格式调整是无害的。
标题层级只用到一到两级。三级以上需要读者先理解层级才能定位，反而增加阅读负担，也会让提示看起来更复杂。