Specification-Driven Agent Development

人工撰写的Prompt或松散的用户故事留有歧义空间；Agent可能偏离正轨、过度解读，或是生成与利益相关方意图相悖的代码。

采用spec-first工作流，以正式规格文件（如Markdown、OpenAPI、JSON Schema）作为Agent的首要输入与事实来源。

• 解析spec → Agent构建显式任务图。
• 搭建脚手架 → 直接基于spec生成项目结构与桩代码。
• 强制约束：所有生成的产物必须关联到spec中的对应条款。
• 迭代更新：仅通过编辑spec实现迭代，而非临时发起即兴prompt调整。

if 有新功能需求:
    编写/更新spec
    Agent与spec同步

为Agent提供一个结构规范的spec文件，然后运行claude spec run命令。

常见陷阱：要求粗糙或规格定义不充分仍会导致错误扩散。

• 优点：可重复执行、便于审计、易于差异比对。
• 缺点：前期编写规格文档需投入较多精力；不熟悉规格文档格式的团队存在初期适应门槛。