6 种提示词结构
把上面的技巧抽象成可复用的提示词骨架。
阅读教程模型写代码快不快,很大程度上取决于你给的上下文够不够、对需求的描述准不准。
本教程把一次周全的协作拆成五步:准备上下文、描述需求、先要方案、验证闭环、贴对报错。照着做,能明显减少"看起来对但跑不通"的返工。
模型不会看到你的项目。一次提问至少要给齐四样东西:技术栈与版本、相应代码片段、运行环境或报错材料、及不能动的边界(哪些接口不能改、必须兼容哪一版)。
技术栈:Java 17 + Spring Boot 3.2 + MySQL 8
相关代码:OrderService.java 的 calculateDiscount 方法(见下)
环境:生产上偶发,但测试环境无法复现,怀疑是并发导致
边界:不能改表结构,不能引入新依赖把"我要什么"说清楚,把"怎么做"留给模型。自己先想好实现细节再喂进去,反而容易把错误思路一起带过去。
弱:帮我写一个重试方法,失败重试三次
强:需要一个 HTTP 调用重试方法。要求:只对超时和 5xx 重试,4xx 直接抛出;每次间隔按指数退避并加入随机抖动;总耗时不超过 5 秒;支持传入自定义重试次数;请说明为什么这样设计。对稍微繁杂的需求,先让模型给出方案与取舍,你认可后再让它写代码。这样能避开得到一大段漂亮但方向错误的实现。
先不要写代码。请给出两种实现方案,分别说明复杂度、失败场景、维护成本和对现有代码的影响,并推荐其中一种。等我确认后再输出完整代码与对应的单元测试。模型给出的代码至少要过三关:能否编译或借由静态翻看、关键路径有没有边界用例、异常路径是否有明确的失败行为。让它自己补测试往往比你自己想边界更全面。
请为上面的实现补充单元测试,覆盖:正常返回、首次失败后重试成功、全部失败后抛出异常、4xx 不重试、退避时间随次数增长。测试框架用 JUnit 5。贴报错时给周全材料:周全错误栈、触发次序、预期行为与实际行为、及你已经尝试过什么。只贴结束时一行报错,模型只能猜。
现象:批量导入 5000 行时,第 3000 行左右报空指针
完整错误栈:(粘贴)
触发步骤:导入 5000 行 CSV,其中一行的日期字段为空
预期:跳过该行并记录错误
实际:整个任务中断
已尝试:把批大小改成 1000,问题依旧把这五步串起来,就是一次高质量的协作:上下文决定模型能不能理解,需求描述决定方向,方案先行避开返工,验证闭环保证质量,正确的报错材料让调试一轮到位。
只贴与问题直接相应的文件片段,并附上技术栈、版本和错误材料。上下文不是越多越好,无关文件会稀释注意力。改造老项目时,把调取方、被调取方和相应设定一起给全,往往比一次贴整个仓库更实用。
不宜直接照抄。制成的代码应当先在本地跑通单元测试与边界用例,再由熟悉业务的人审查安全与性能影响,尤其是涉及鉴权、金额计算、数据库写入和对外输入的部分。