把重复编码任务写成可复用提示模板
文章介绍将 Claude Code 提示拆为前置上下文和固定任务正文,减少每次重复描述。示例明确技术栈、修改范围、兼容性约束与验收命令,并要求报告调用点和测试结果。
AI 深度解读
每次让 Claude Code 改代码,你可能都要重打一遍测试命令、目录范围和兼容要求。漏写一条,就可能多来回一轮。作者给出的办法是把每周重复的工作写成两段式提示词,先交代仓库约束和验收条件,再给出一项具体任务。
原文列了 18 类工作,拿内部函数改名和偶发测试举例。最值得借鉴的是把「改完应该是什么样」提前写清楚。这样你可以直接对照 diff 和测试结果验收,尤其是那些测试通过了也可能改错的任务。
同一个任务,为什么要把仓库约束放在前面
模型能读文件,但从文件里看到一种做法,和知道团队要求必须遵循它,是两回事。仓库里有测试脚本,模型仍需要知道这次交付要跑哪条命令。它能看见一个函数被导出,却未必知道已有调用方依赖这个名字。第一段上下文就用来补这些信息,包括语言版本、测试命令、代码风格、必须保留的行为、可改目录和完成标准。作者建议一行写一个事实,几个月后回来维护也能快速扫一遍。
第二段只描述一项任务,写清改什么和交付什么。仓库约定变了就更新第一段,同类工作再来时,第二段通常只需要换目标。作者把上下文排在前面,是希望模型从一开始就用这些条件理解任务。
改名示例用的是 Python 3.11、pytest 和 ruff,行宽为 100。把内部的 loadConfig 改成 readConfig 时,修改范围限于 src/ 和 tests/,migrations/ 和 docs/ 排除在外。src/pkg/__init__.py 的公开导出是兼容契约,因此旧名要作为弃用别名保留,新名留在内部。交付时要列出修改过的调用点,贴出 pytest -q 的结果摘要,并确认 diff 只涉及这次改名。把这些条件写在一起,才能检查「内部已经改名」和「外部调用仍然兼容」这两件事。
偶发测试要修的是不稳定因素
原文的另一个示例交代了复现条件和修复边界。CI 用 pytest-xdist 并行跑测试,tests/test_sync.py::test_retry_backoff 大约每 5 次失败 1 次,本地始终通过。作者怀疑测试直接断言了真实经过的时间,而 CI 机器运行较慢。下面第一段让模型知道该查哪里,以及哪些改法会破坏验收条件。
Context to provide:
- Test runner: pytest-xdist, tests run in parallel on CI.
- The failing test is `tests/test_sync.py::test_retry_backoff`; it fails ~1 in 5 on CI and never
locally. Suspect: it asserts a wall-clock delay, and CI runners are slow.
- Do not disable the test, do not add sleep(), do not mark it xfail.
- Done = the test is deterministic without weakening the assertion.
倒数第二行把禁用测试、加 sleep() 和标记 xfail 都排除在外,最后一行要求保留原有的断言强度。接着,任务段把工作限定为定位不确定性的来源,并提出修法。
Read tests/test_sync.py and find what makes this test non-deterministic.
Propose a fix that removes the timing dependency, keep the assertion as strict as it is now,
and explain in two sentences why the original passed locally and failed on CI.
第二行要求去掉时间依赖,同时维持断言强度。最后一行要求用两句话解释本地和 CI 的表现为何不同,其中的计时问题仍是待查的假设。
18 份提示词覆盖了哪些重复工作
原文列出的任务包括重构、代码审查、排查偶发测试、编写测试、生成文档、数据库迁移、API 设计、事后复盘、功能开关、提交消息、PR 描述、依赖升级、性能排查、CLI 规范、README、RFC、依赖审计和变更日志。每项工作一个文件,都按上下文和任务正文两段组织。
作者销售的 Claude Code Prompt Pack 包含 18 个文件,采用 MIT 许可证,一次性购买后可以按仓库约定修改。文章展示了两份示例。模板能省去重复输入,仓库约定、验收条件和边界仍需要维护,具体代码也仍要读。
我的判断
这套方法最有价值的地方,是把评审时才会追问的问题提前写进任务。像「旧导出还在吗」「断言有没有被放宽」,都能在交付时核对。至于上下文放前面是否更容易一次做对,以及能省几轮沟通,原文没给对照数据。偶发测试的失败频率也是示例中的描述,文章没展示修复后的运行结果。这部分属于经验之谈。
如果团队已有随仓维护的 CLAUDE.md,可以把测试命令、代码风格等长期约定集中放在那里,再在任务模板里写本次范围和验收条件。每个模板都复制一遍全局规则,升级工具链时就要同步改多处。反过来,如果某个约束只对这类任务成立,比如重构时保留某个旧导出,把它留在任务提示里更容易核对和维护。
能拿来做什么
- 给下一次前端或 Node 内部重构准备一份模板,写出实际测试命令、可编辑目录和必须保留的导出,再要求 Claude Code 列出改过的调用点和验证结果。
- 排查偶发测试时,给出具体用例、CI 并发设置、失败频率和本地表现,把怀疑的原因标成假设,并要求修法保留原有断言强度。
- 从最常重复的一两类任务开始,把评审时反复补充的要求写成可检查的验收条件。仓库升级测试工具或调整目录时,一并更新模板。