三类场景提示模板：修 Bug、新功能、重构
一句话定义
把高频任务固化为三张提示模板——修 Bug（症状/复现/期望）、新功能（意图/接口/边界）、重构（目标/不变量/验证）——每次发起任务时填空而非从零措辞。
为什么重要
kp-003 的三元组是结构，模板是结构的复用件。高频任务的表达失误高度重复，固化模板能把「想措辞」的时间归零，把「漏信息」的风险清单化。模板也是团队对齐的工具：新人用同一套模板提问，产出风格与审查重点随之统一。
前置知识
kp-003（意图-约束-验收三元组）。
核心概念
修 Bug 模板——要素：现象（做了什么/期望什么/实际什么）、最小复现步骤、相关代码与完整错误栈、已排除的假设。要点：复现步骤比描述重要，模型可以自己跑复现（代理层）或推演（对话层）。
新功能模板——要素：意图与动机、接口签名约定、输入输出示例（含边界）、禁区（不许动的模块）、验收测试名。要点：给 2-3 组「输入→输出」示例比形容词有效一个量级。
重构模板——要素：重构目标（可读性/性能/解耦）、不变量（外部行为与公共 API 必须保持）、验证方式（哪些测试必须保持通过）、范围边界。要点：不变量是重构提示的灵魂，缺失时 AI 会「顺手改行为」。
原理与机制
模板的本质是把注意力预算（kp-004）按任务类型预分配：修 Bug 把预算给「复现与栈」；新功能给「示例与边界」；重构给「不变量与测试」。每种任务的失败模式不同，模板提前堵住了最贵的那类缺失。模板同时约束输出形态——明确要求「只输出 diff」「先给方案再动手」，能显著降低无效输出。
实例或案例
修 Bug：Before
这个接口偶尔 500，帮我看看怎么回事。After
现象：POST /orders 偶发 500（约 0.5%），期望一律 200/4xx。
复现：并发 50 请求创建含相同 sku_id 的订单，日志见 attach。
代码：services/order.py:88-120（扣减库存段），完整栈附后。
已排除：非鉴权问题（4xx 正常）；非数据缺失（单请求无错）。
要求：先给 3 个按概率排序的假设，不要直接改代码。新功能：After 示例
意图：订单列表支持按状态筛选。
接口：GET /orders?status=paid|shipped|all，默认 all。
示例：status=paid → 只返回已支付单；status=bogus → 400。
禁区：不改 Order 模型与迁移脚本。
验收：test_orders_filter.py 新增 4 用例全绿。
输出：先列改动文件清单与 diff，等确认再落盘。重构：After 示例
目标：把 utils/legacy.py 的订单计算拆成纯函数便于测试。
不变量：calc_total 对全部现有用例输出不变；公共函数名与签名不变。
验证：pytest tests/test_calc.py 必须全绿；补特征测试后再动手。
范围：只动 utils/legacy.py 与其调用点，禁止格式化整文件。操作步骤：
- 把三张模板存进编辑器 snippet 或团队 wiki，命名
/bug、/feature、/refactor。 - 发任务前 30 秒过一遍要素清单，缺哪项补哪项。
- 每月复盘：同类任务反复补同一种信息 → 把它升级进模板。
排错清单：
- 产出仍偏差 → 按顺序补：约束 > 示例 > 拆小任务。
- 输出太长无法审 → 加「只输出 diff，不加解释」。
- 模板僵化 → 模板是底稿不是圣旨，按任务增删行。
公式或模型
本节不适用：模板是复用件，量化收益归入 kp-026 的返工率观察。
图示
本节不适用：三类模板以代码块呈现已足够。
直观类比
模板像急诊分诊表：主诉、病史、已做检查各栏固定，医生（模型）不必猜，直接进入处置。
常见误区
- 模板越全越好：每张模板保持 5-7 个要素，超出的信息应放规则文件或文档。
- 一次发多个任务：一模板一任务，多任务合并必然顾此失彼。
- 用模板代替思考：填模板前先想清楚验收，模板不会替你决定「对错」。
与其他知识点的关系
kp-014 调试协作是修 Bug 模板的深化；kp-011 spec 驱动是新功能模板的工程化升级；kp-015 是重构模板的规模化护栏。
自测题
要点：重构的定义就是行为不变；缺失不变量时模型会把重构做成重写，引入行为变更。
要点：示例可判定、可转化为测试；形容词无法约束生成。
- 重构模板为什么必须写「不变量」？
- 新功能模板中「输入输出示例」优于形容词的原因？
延伸阅读
《Refactoring：Improving the Design of Existing Code（第2版）》Martin Fowler——不变量与行为保持的权威论述。