可以直接复用的 Spec-First 案例

这些案例展示一件事:如何把松散需求变成一个小规格包,包含 spec.md、任务、验收标准和测试证据,然后再让 AI 开始写代码。

Before弱工单或提示词
After可评审规格包
Use复制到 issue 和 PR

精选案例

Checkout 优惠码

一个涉及金额的 checkout 需求,变成包含校验状态、总价计算、实现任务和回滚证据的规格包。

弱需求:
给 checkout 加优惠码。
无效码不要影响付款。

规格边界:
- 付款前应用一个优惠码
- 不做后台管理
- 不重构 totals
打开优惠码案例

API 错误分类

一个 API 错误清理需求,变成包含兼容说明、SDK fixture、OpenAPI 示例和迁移证据的契约规格。

弱需求:
优化 API 错误。
让客户端更容易处理。

规格边界:
- 只改 envelope
- 只做 additive response change
- 旧 SDK 仍能解析
打开 API 错误案例

快速 before/after 示例

通知偏好

把笼统设置需求改写成迁移风险、偏好状态和重复发送证据。

报表导出

把“大客户 CSV 导出”改写成异步导出任务、过期筛选风险和压测证据。

更多紧凑改写

对照松散工单和规格包版本,查看范围、任务、验收和证据如何落地。

浏览快速示例

从你的模糊需求开始

把粗糙需求贴进 AI Coding Spec Packet 生成器,转成四份可评审 Markdown 文件。

编辑说明

案例选择标准是可复用:每个案例都必须展示真实 before/after、明确规格边界,并给出评审证据。