Skip to content
返回 AI 编程

规格驱动 AI 开发

提示 AI 前先写验收标准；将规格视为契约。

工作流进阶

为什么

GitHub 2024 年对 2000 名开发者的企业调查发现 97% 在工作中用过 AI 编程工具，Stack Overflow 2024 调查显示 76% 的开发者正在或计划使用 AI 工具（上年为 70%）。精确规格是改善 AI 输出最廉价的方式。

'加登录页'得 10 种实现；'POST /login 用 zod 验证 {email,password}，失败 401，设 JWT cookie，200 返回 user'只得一种。

何时使用

任何有 >1 验收标准的功能写规格。一行能覆盖的琐碎编辑跳过。

如何做

1. 写 Given/When/Then 验收标准。 2. 加约束（zod 验证、不加依赖、遵循 X 模式）。 3. 将规格 + 文件引用喂给 AI。 4. 门禁：tsc + 测试须过；红则拒绝并重新提示。 5. 仅绿时用约定式消息提交。

示例

规格："POST /api/books：用 zod 验证 {title:string, author:string}； 空 title 拒绝（400）；持久化到 Books；返回 201 + 行；记录失败。" 提示："@file src/api/router.ts 实现上述规格；遵循 health.ts 模式"

常见问题

  • ⚠Error: Cannot find module 'xxx' → 运行 `npm install xxx`（或 `pnpm add xxx`）；确认已写入 package.json 依赖。
  • ⚠错误："Command not found: claude" 或 "cursor" → 确认二进制在 PATH 上：`which claude` / `which cursor`；缺失则全局重装。
  • ⚠TypeError: Cannot read properties of undefined (reading 'x') → 加空值守卫或可选链 `obj?.x`；通过堆栈追溯 undefined 来源。

最佳实践

  • ✓规格写为可测验收标准，非散文。
  • ✓保持 AI 循环紧凑：规格 → 生成 → 门禁 → 提交。
  • ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。

常见问题解答

什么是规格驱动 AI 开发？

提示 AI 前先写验收标准；将规格视为契约。 它可帮助开发者快速理解 规格驱动 AI 开发 的核心价值与适用场景。

如何开始使用规格驱动 AI 开发？

开始使用 规格驱动 AI 开发，建议先掌握以下要点：写 Given/When/Then 验收标准。

规格驱动 AI 开发 的常见误区有哪些？

使用 规格驱动 AI 开发 时常遇到的问题包括：Error: Cannot find module 'xxx' → 运行 `npm install xxx`（或 `pnpm add xxx`）；确认已写入 package.json 依赖。；错误："Command not found: claude" 或 "cursor" → 确认二进制在 PATH 上：`which claude` / `which cursor`；缺失则全局重装。；TypeError: Cannot read properties of undefined (reading 'x') → 加空值守卫或可选链 `obj?.x`；通过堆栈追溯 undefined 来源。。

规格驱动 AI 开发 的最佳实践是什么？

规格驱动 AI 开发 的最佳实践包括：规格写为可测验收标准，非散文。；保持 AI 循环紧凑：规格 → 生成 → 门禁 → 提交。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。

如何深入学习规格驱动 AI 开发？

从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。