核心目标:减少冗余上下文、避免 AI 反复重读全项目、约束输出范围、强制先规划再编码,降低 Token 消耗,产出高质量可直接运行、结构最优的代码
原理:不加约束的自然语言需求 → AI 漫无目的扫描文件、大量试探性输出、反复生成无效代码,Token 暴涨;标准化提示框架强制 AI「先思考范围→方案评审→最小变更→规范编码」。

前置通用规则(每次对话第一条固定带上,做成模板)

plaintext
【基础约束,全程遵守】
1. 上下文范围:只读取本次任务相关目录与文件,禁止无差别遍历整个项目;无关文件绝不读取。
2. 输出原则:精简思考文本,减少废话;优先输出可直接使用代码,长篇推理内容做折叠/简要总结。
3. 修改规范:任何代码变更,先输出【变更清单】:文件路径 + 修改目的;确认后再生成代码。
4. 遵循项目现有编码规范:沿用当前项目命名、注释风格、目录结构,不要自创一套架构。
5. 不一次性大范围重构,拆分任务;单一需求只解决当前问题,禁止附带额外功能。
6. 出现报错优先定位根因,不盲目堆砌代码;尽可能复用已有类、方法、工具函数。
7. 所有新增代码自带必要异常处理、参数校验;杜绝裸写SQL、无校验接口等隐患。
8. 如果信息不足,一次性列出需要我补充的信息,不要多次零散追问。

三层分级提示框架(按任务大小选用,直接复制使用)

框架 A|小型任务(新增接口、修复 BUG、方法优化、前端小功能)【最常用,Token 最低】

适用:修复 404、新增一个控制器方法、路由配置、优化函数、bug 调试
plaintext
【任务类型:小型迭代】
基础约束(粘贴上方通用规则)
任务目标:{填写你的需求,精准简洁}
限定范围:仅操作文件/目录:{文件路径,例:app/controller/User.php、route/app.php}
禁止修改:{列出不能动的文件,避免误改核心代码}

执行流程:
① 快速读取限定文件,分析现有逻辑
② 输出简要实现思路(不超过3行)
③ 输出变更清单
④ 给出完整代码片段,标注改动位置
⑤ 简单说明风险点

额外要求:保持代码最小改动,不重构无关逻辑;兼容ThinkPHP现有版本特性。
示例填充:
任务目标:新增用户登录接口,增加账号密码校验

限定范围:app/controller/Auth.php、route/app.php

禁止修改:app/model、middleware 内已有鉴权中间件

框架 B|中型任务(新增模块、一套接口、数据表 + 控制器 + 路由全套)

适用:新增会员模块、后台 CRUD、完整 API 分组
plaintext
【任务类型:中型功能开发】
基础约束(粘贴上方通用规则)
任务目标:{详细描述需求}
项目框架:ThinkPHP{版本}
目录约束:
需要新增/修改目录:xxx
禁止触碰模块:xxx

执行步骤:
1. 梳理当前项目现有架构,判断如何嵌入新功能,不破坏原有业务
2. 输出【方案概要】:数据表设计(如有)、文件结构、路由规划
3. 输出完整【变更清单】(新建文件 + 修改文件),等待确认
4. 确认通过后,依次生成代码,遵循项目规范
5. 附带简单测试调用示例

硬性优化要求:
合理复用现有模型、验证器;使用事务处理数据操作;接口增加统一异常返回;代码具备扩展性,避免硬编码。

框架 C|大型任务(架构调整、重构、多模块改造)谨慎使用,消耗最高

建议手动拆分多个中型任务,不要一次性丢给 AI,防止 token 爆炸
plaintext
【任务类型:大型重构/架构调整】
基础约束(粘贴上方通用规则)
任务目标:
项目环境:ThinkPHP版本、PHP版本
边界限制:明确哪些功能必须保留,哪些可以优化,哪些禁止改动

执行流程:
阶段1:调研 → 分析现有代码存在问题,输出优化方案
阶段2:输出整体改造文件清单、改造顺序、潜在风险
阶段3:分批次执行修改,每批次完成后等待确认
阶段4:给出自测方案

要求:优先兼容现有业务,尽量平滑改造;尽可能降低代码侵入性;改动做好注释区分原有代码与新增代码。

针对 Cline / CodeBuddy 专属节能技巧(重中之重)

1、控制文件读取范围(最大程度节省 Token)

❌ 错误写法:帮我完善登录功能(AI 自动扫描整个项目,读取几十份文件)

✅ 正确写法:只读取 app/controller/auth.php 和路由文件实现登录接口

Cline 有自主读取文件能力,不限制范围 = 疯狂消耗 token

2、善用「先规划,确认再编码」

每次强制 AI 先输出变更清单,你审核。

发现方案范围过大,可以直接缩小任务,避免 AI 写完一大段代码才发现方向错误,白白消耗额度。

3、任务拆分原则(降低消耗核心手段)

不要一条指令同时要求:建表 + 控制器 + 路由 + 中间件 + 前端接口 + 文档

拆分为:

  1. 生成数据表结构
  2. 创建模型与验证器
  3. 编写控制器方法
  4. 配置路由、统一返回格式

4、上下文清理策略

  • 一个功能开发完成,新开对话窗口进行下一项任务

    Cline/CodeBuddy 会持续累积全部聊天上下文,对话越长,后续每一轮消耗越高!长期不重置,token 持续暴涨。

5、禁用 AI 多余行为

在提示词加入:
不要输出客套话、markdown 多余分隔装饰、冗长思考过程;只输出有效信息。

ThinkPHP 项目专用增强附加模板(直接追加在提示末尾)

plaintext
【ThinkPHP开发规范附加要求】
1. 使用框架原生方法,不要手写原生SQL;优先使用验证器做参数校验。
2. 路由遵循项目现有风格,区分api路由与后台路由。
3. 响应统一沿用项目已有的返回格式,不要新建返回方法。
4. 命名遵循TP规范:控制器大驼峰,方法小写+下划线。
5. 新增逻辑尽量独立,减少对原有控制器大量改动。

一份可以直接复制的【终极通用模板】(日常 90% 场景直接用)

plaintext
【基础约束,全程遵守】
1. 上下文范围:只读取本次任务相关目录与文件,禁止无差别遍历整个项目;无关文件绝不读取。
2. 输出原则:精简思考文本,减少废话;优先输出可直接使用代码。
3. 修改规范:任何代码变更,先输出【变更清单】:文件路径 + 修改目的;确认后再生成代码。
4. 沿用当前项目编码规范、目录结构,不自创架构。
5. 单一需求只解决当前问题,禁止额外增加无关功能。
6. 尽可能复用已有类、方法,最小改动原则。
7. 信息不足一次性列出所需资料,不要多次零散提问。

【任务类型:小型迭代】
任务目标:
限定操作文件/目录:
禁止修改文件:

额外规范:ThinkPHP项目,优先使用框架原生API,做好参数校验与异常捕获,兼容现有项目逻辑。

使用对比总结

不加模板:消耗高、AI 到处乱读文件、代码冗余、容易越改越多

使用这套框架:

✅ 文件读取范围可控 → Token 大幅下降

✅ 先方案确认再编码 → 减少无效返工

✅ 强制复用项目现有代码 → 产出代码更贴合项目、易维护

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。