重构提示词模式
保持行为：声明不变量、要计划、用现有测试门控。
提示词工程进阶
为什么
GitHub 2024 调查发现 92% 的美国受访者用 AI 编程工具生成测试用例，73% 的开源受访者用 AI 工具编程或写文档。重构须保持行为。
声明不变量（'响应结构不变'）并用现有测试门控，可捕获'让它更干净'提示词会静默引入的行为变更。
何时使用
任何非平凡重构用此。纯重命名用 IDE 工具跳过。
如何做
1. 声明目标 + 不变量（"响应结构不变；不加依赖"）。
2. 先要计划；审查。
3. 执行；每步后跑现有测试。
4. 测试红则重构改了行为 — 回滚并重新规划。
5. 每步用 refactor: 前缀提交。
示例
目标："在 src/api/** 用 zod.safeParse 替换 assertValid"
不变量："响应结构与状态码不变；除 zod 外不加依赖。"
计划：12 路由，每路由一 commit。每次后跑 npm test — 红意味行为变了。
常见问题
- ⚠错误：模型返回 "I cannot help with that" → 改写去除受限措辞；收窄范围并提供明确的允许示例。
- ⚠模型输出 JSON 解析错误 → 用 ```json 围栏包裹并在系统提示加 "仅返回合法 JSON"。
- ⚠错误：超出 token 限制（400 Bad Request） → 拆分提示、摘要前文或切换更大上下文模型。
最佳实践
- ✓重构前显式声明不变量。
- ✓用现有测试作行为保持门控。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是重构提示词模式？
保持行为：声明不变量、要计划、用现有测试门控。 它可帮助开发者快速理解 重构提示词模式 的核心价值与适用场景。
如何开始使用重构提示词模式？
开始使用 重构提示词模式，建议先掌握以下要点：声明目标 + 不变量（"响应结构不变；不加依赖"）。
重构提示词模式 的常见误区有哪些？
使用 重构提示词模式 时常遇到的问题包括：错误：模型返回 "I cannot help with that" → 改写去除受限措辞；收窄范围并提供明确的允许示例。；模型输出 JSON 解析错误 → 用 ```json 围栏包裹并在系统提示加 "仅返回合法 JSON"。；错误：超出 token 限制（400 Bad Request） → 拆分提示、摘要前文或切换更大上下文模型。。
重构提示词模式 的最佳实践是什么？
重构提示词模式 的最佳实践包括：重构前显式声明不变量。；用现有测试作行为保持门控。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习重构提示词模式？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。