21. 指令基础


目标定义

好的指令必须有清晰的目标:

❌ "改一下这个代码"
✅ "重构 processOrder 函数,将内部的三个步骤(校验、计算、持久化)拆分为独立的私有方法"

范围约束

明确操作范围,避免 AI 改动过大:

❌ "优化项目性能"
✅ "优化 src/api/search.ts 中的 fullTextSearch 函数,仅针对数据库查询部分"

条件限制

给出明确的约束条件:

请重构这个模块,但不要:
- 改变公开 API 的签名
- 引入新的第三方依赖
- 修改测试文件

输出规范

指定期望的输出格式:

请输出以下格式:
1. 改动摘要(50字以内)
2. 详细改动列表
3. 潜在风险
4. 测试建议

常见失真来源

失真类型原因预防方法
过度改动指令范围不明确明确指定文件和函数范围
引入新依赖未约束依赖范围在 Rules 或指令中明确约束
风格不一致未配置 Rules编写完善的 .cursorrules
删除有用代码AI 误判为无用使用 Plan Mode,先审后改
测试不通过改动未考虑副作用要求 AI 执行改动后运行测试