AI 编程 · 核心方法 · 第 1 节

规格驱动开发

先写清楚「要什么、不要什么、怎么算完成」，再让 AI 动手。规格是 AI 编程里回报率最高的一份文档。

一、为什么规格在 AI 时代变得更值钱

过去写规格是为了让人看懂；现在多了一个更强的理由——规格就是代理的施工图。代理式工具拿到一份边界清晰的规格，可以自主完成大部分实现；拿到一句「做个登录」，它只能靠猜，而你将花更多时间纠正它。实现变便宜之后，定义工作的价值被放大了。

二、一份最小可用的规格长什么样

# 任务：导出功能增加 CSV 格式

## 目标
用户在「数据」页可以导出 CSV，与现有 Excel 导出并列。

## 行为要求
- 遵守当前表格的筛选与排序状态
- 数字字段不带千分位，空值输出空字符串
- 文件名格式：data-YYYYMMDD-HHmm.csv

## 明确不做
- 不做列选择（后续任务）
- 不改动现有 Excel 导出的任何行为

## 完成标准
- npm test 全绿
- 手工验证：筛选后导出，行数与页面一致

注意「明确不做」这一节：它防止代理顺手重构不该动的东西，是控制改动半径的关键。「完成标准」则给了代理自我验证的依据——跑什么命令、看到什么结果才算结束。

三、工作流：规格 → 实现 → 回读

1. 写规格。哪怕只有五行。写不出来的部分，就是你还没想清楚的部分。
2. 让 AI 复述。实现前要求它用自己的话概括规格、列出计划。复述阶段暴露的理解偏差，成本几乎为零。
3. 实现并自验。让它按完成标准自测，测试不过自己修。
4. 回读规格。审查实现后，把「实际做了但规格没写」的部分补进规格——规格与代码从此保持同步，成为下一批任务的上下文。