原文地址：https://addyo.substack.com/p/how-to-write-a-good-spec-for-ai-agents
我先说结论：AI 写代码这件事，真正的分水岭不在模型本身，而在你有没有把流程设计清楚。
文章要点
- 本文详细介绍了如何为AI编程助手编写高质量规格说明（Spec）的五大原则：
- 从高层愿景开始，让AI起草细节
- 先提供简洁的高层目标和核心需求，让AI生成详细规格。使用计划模式（Plan Mode）在编写代码前完善规格，将规格作为持久化的参考文档，并保持以目标为导向。
- 将规格视为结构化文档，涵盖六个核心领域：命令、测试、项目结构、代码风格、Git工作流和边界约束。使用一致的格式（如Markdown），将规格集成到工具链中，采用四阶段工作流（指定→计划→任务→实施），并将规格作为"活文档…
我的观点
如果没有明确验收标准，AI 产出的“看起来能跑”会很快变成维护负担。
把上下文边界、接口契约、回归检查前置，采纳率会比单纯调 prompt 更稳定。
团队层面最该沉淀的是失败样本和复盘模板，而不是个人技巧。
实践建议
- 先写验收条件（测试、输出格式、边界场景），再让模型生成实现。
- 每轮只优化一个维度（正确性/可读性/性能），避免目标漂移。
- 把评审驳回原因沉淀为 checklist，下一轮直接复用。
收尾
别追求“看完很多”，要追求“本周能改一件事”。把这篇文章转成一个具体动作，效果会比收藏链接更大。