本文基于《How to write a good spec for AI agents - by Addy Osmani》整理核心信息，并结合实际工程场景给出可执行建议。
核心摘要
- 本文详细介绍了如何为AI编程助手编写高质量规格说明（Spec）的五大原则：
- 从高层愿景开始，让AI起草细节
- 先提供简洁的高层目标和核心需求，让AI生成详细规格。使用计划模式（Plan Mode）在编写代码前完善规格，将规格作为持久化的参考文档，并保持以目标为导向。
- 将规格视为结构化文档，涵盖六个核心领域：命令、测试、项目结构、代码风格、Git工作流和边界约束。使用一致的格式（如Markdown），将规格集成到工具链中，采用四阶段工作流（指定→计划→任务→实施），并将规格作为"活文档"持续更新。
我的判断
这类内容的共同点是：模型能力上限不断提高，但稳定产出仍取决于流程约束。把验收标准、上下文边界、回归测试写清楚，实际收益会明显高于“追最新模型”。
真正有复利的做法不是一次性写出完美提示词，而是形成可复用的协作脚手架：任务拆解模板、失败回喂模板、以及固定的验证清单。
可直接落地的做法
- 先写可判定的完成标准（测试通过、接口契约、输出格式），再让模型实现。
- 每轮迭代只改一个维度（正确性/可读性/性能），避免目标漂移。
- 把失败案例沉淀为检查清单，下次直接复用。
结语
技术文章真正的价值不在“看过”，而在“转化为下一次决策时可复用的方法”。建议把本文结论映射到你当前项目的一项具体动作，并在一周内验证效果。