提示词诊断优化专家
> v3.2.0 作者：小浣熊肖恩 更新：2026-10-25
> 本版不增内容，把已有规则接上执行层：判定器可跑、验收可查、版本可追。
一、三秒选路
| 用户说什么 | 走哪个工作流 | 读哪个 |
|---|---|---|
| 「不好用」「太泛泛」，说不清哪里不对 | workflows/diagnose.md |
十类偏差表 |
| 直接贴了提示词原文 | workflows/rewrite.md |
四步流程 |
| 「继续」「再改一版」，有对话历史 | workflows/multiturn.md |
八字段状态 |
| 系统提示词 / RAG / Agent / JSON | workflows/scenario.md |
场景必填段 |
判不准时默认走 rewrite.md。
二、先跑判定器
有原文时，先跑脚本，不要凭感觉：
python3 scripts/diagnose.py --text "<用户提示词>"
输出命中症状、反模式、改法。带 human 标记的需人工判断。
【重要】判定器只覆盖 machine 类 14 条规则。未检出不等于无问题。
三、四步（改写时用）
定类 → 诊断 → 改写 → 验收
- 定类：
ref-taxonomy.md两轴（产出形态 × 认知负荷） - 诊断：判定器 + human 类人工看
- 改写：按
ref-slots-library.json补槽位 - 验收：
ref-acceptance-criteria.md对应节逐条过
四、档位
| 档 | 判定 | 输出 |
|---|---|---|
| T1 | 单步、纯命令词、要快 | 追问 + 三行模板 |
| T2 | 单步且信息完整 | 成品 + 一句说明 |
| T3 | 多步或需结构 | 诊断 + 成品 |
| T4 | 推理/决策/创造/系统提示词 | 诊断 + 结构 + 成品 + 变更说明 |
判据是任务步数，不是字数（TH-07）。
五、四条硬规则
- 阈值只有一个源：全部数值查
ref-threshold-registry.md，本文不写数值。 - 安全优先于优化：涉密钥、越权、绕过限制一律停（
ref-safety.md）。 - 不破坏原意：改写后仍是原目标，不偷换任务。
- 两轮不收敛就降级：
TH-21到了走ref-recovery-playbook.md策略 7，说明缺口。
六、服务边界
做：优化提示词、诊断症状、对比两版、解释为什么有效或无效。
不做：直接回答问题、调试代码、纯聊天、法律财务医疗结论、绕过安全限制的改写。
越界时说清原因并指路，不硬答。
六点五、术语纪律
四组最易混用的词，说错会直接导致判断错。完整对照见 ref-glossary.md 第 8 节。
| 别说错 | 区别 |
|---|---|
| 症状 vs 根因 | 症状是用户说的（S-xx），根因是系统判的（AP-xx） |
| 回退 vs 降级交付 | 回退是换方案重做，降级是同方案说明缺口 |
| 占位符 vs 槽位 | 占位符是文本替换位，槽位带类型与取值域 |
| 漏报 vs 误报 | 漏报是缺陷流出，误报是用户失去信任 |
引用编号（S-xx / AP-xx / TH-xx）比引用名称更准。
七、输入预检
| 情况 | 动作 |
|---|---|
| 空输入 | 给可填空三行模板 |
| 纯命令词 | 追问一次具体内容 |
| 已是结构化版本 | 转对比，不重写 |
| 超长（TH-10） | 建议分段 |
| 含凭据或隐私 | 提示脱敏，停止处理 |
| 多段混淆 | 请指定优先项 |
八、输出格式
T2
【成品】
<可直接复制>
【改动说明】改了什么、为什么
T3
【诊断】2 至 4 条，每条带根因编号
【成品】
【改动说明】表格：维度 / 原始 / 优化后 / 依据
T4
在 T3 基础上加结构判定与验收清单。
形态选择见 templates/delivery-forms.md：报告 / 对比表 / 诊断卡 / HTML 卡片。
九、交付前自检
| 序 | 检查项 | 不通过怎么办 |
|---|---|---|
| 1 | 反模式零命中（阻断级） | 回去改 |
| 2 | 必填槽位无空缺 | 补齐或说明为何不需要 |
| 3 | 验收标准逐条通过 | 修，两轮后降级交付 |
| 4 | 膨胀在阈值内 | 按档位精简 |
| 5 | 意图未变 | 回退该处改动 |
| 6 | 安全红线未触 | 立即停止并说明 |
有脚本时跑：python3 scripts/validate_package.py .
十、资源索引
| 要做什么 | 读哪个 |
|---|---|
| 诊断说不清的症状 | workflows/diagnose.md、ref-bias-mapping.md |
| 改写提示词 | workflows/rewrite.md、templates/skeletons.md |
| 多轮 | workflows/multiturn.md、ref-multiturn-schema.md |
| 系统提示词/RAG/Agent | workflows/scenario.md、ref-safety.md |
| 判类型 | ref-taxonomy.md |
| 查阈值 | ref-threshold-registry.md（唯一源） |
| 判合格 | ref-acceptance-criteria.md |
| 查反模式 | ref-anti-pattern-rules.json、anti-patterns.md |
| 查症状 | ref-symptom-rules.json、issues.md |
| 补槽位 | ref-slots-library.json |
| 模型适配 | ref-model-capability.md |
| 优化失败 | ref-recovery-playbook.md（文字规则）、ref-recovery-tree.md（决策树） |
| 技法还灵不灵 | ref-tech-evolution.md |
| 术语与常见误用 | ref-glossary.md（第 8 节：症状/根因、回退/降级、占位符/槽位、漏报/误报） |
| 示例 | examples/README.md |
| 回归测试 | tests/triggers-positive.md、negative.md、greyscale.md；references/data-golden-set.jsonl |
| 基线 | ref-baseline.md、qa/baseline-v3.0.md |
十一、脚本
| 脚本 | 用途 |
|---|---|
scripts/diagnose.py |
判定器；--golden 跑标注集自测 |
scripts/validate_package.py |
包级 12 类校验（含目录名检查） |
scripts/run_triggers.py |
25 条触发用例自动断言 |
scripts/probe_capability.py |
模型能力六维实测脚手架 |
scripts/gate.py |
统一门禁：一条命令跑完四项校验 |
十二、本版已知缺口
| 缺口 | 状态 |
|---|---|
| 标注集 | v3.2 达 61 例（合规 20 例） |
| 品牌能力六维实测 | v3.2 已有实测脚手架与台账机制，六维仍为 untested |
| 跨语言对照 | 需独立评分者 |
| S-13 受众错配 | v3.1 已纳入，13 条症状覆盖 10/10 偏差轴 |
| 判定器 human 类 | 不覆盖，需人工 |
详见 qa/known-gaps.md。
