create-specification 用来把方案需求整理成便于 AI 理解的规格文件。产品和开发同事提供目标、限制、接口和已确认的规则,它会指导 AI 写出一份可以单独阅读的 Markdown 文档,供后续实现与验收使用。
“支持文件上传”和“只能上传指定类型、失败后保留填写内容”,对实现的约束差很多。规格需要把这些差别写出来,还要分清什么是必须满足的要求、什么是环境限制、什么只是建议,避免 AI 把可选偏好做成硬规则。
原文安排了接口与数据约定、验收条件、测试策略、依赖和边界示例。例如上传被拒绝时,页面应显示什么、哪些数据保留,都可以变成明确的验收场景。缺少的业务结论需要补充确认,不能为了填满章节自行编造。 文件会按用途命名,例如数据、工具或设计类规格,并解释缩写和术语,减少对上一段聊天记录的依赖。这样换一个实现任务时,也不必重新口头补齐全部前提。
它适合在需求已经有轮廓、但交给 AI 后总发生理解偏差时使用。你能检查一份写清范围和验收方式的规格,再让实现工作据此展开。