AI编程之需求分析与描述

文章主旨：

在AI编程模式下，开发人员需将模糊的业务需求转化为结构化、无歧义的规格说明，这是避免AI生成代码偏离业务意图的关键前提。

关键要点：

• AI编程与传统编程的核心差异在于：AI无法追问模糊需求，因此必须提供精确、完备的规格。
• 需求与规格的区别：需求是人与人沟通的工具，允许模糊；规格是人与AI沟通的工具，必须结构化、无歧义、无遗漏。
• AI可读的规格检查标准包括5个问题：是否消除歧义、是否结构化、是否明确分支/边界/异常、是否经业务方确认、是否能直接用于生成代码。
• 通过案例“VIP用户包邮”展示了从模糊需求到精确规格的细化过程，包括追问澄清歧义、产出结构化规格（含分支、边界、异常处理）。
• 从需求到设计的完整链路为：需求文档 → 识别业务事件 → 定义业务能力 → 补充业务规则 → 结构化描述 → 工作流编排 → AI生成代码。

内容结构：

1 传统模式与AI模式的需求描述对比：传统模式允许模糊，依靠人类追问；AI模式必须精确，开发人员需将模糊需求转化为结构化规格，扮演“翻译官”角色。

2 需求与规格的区别：需求是业务价值沟通介质，规格是精确行为描述；规格必须无歧义、无遗漏，并需业务方确认、随需求变更同步更新。对比维度包括语言、允许模糊性、受众、目的、完整性、变更成本及示例。

3 AI可读的检查单：开发人员需回答5个问题——是否有歧义并已追问？是否已写成结构化规格？每个分支、边界、异常是否明确？业务方是否确认？规格是否可直接给AI？全部满足后方可交付。

4 案例：从需求到规格的细化过程：以“VIP用户包邮”为例，展示开发人员追问澄清（VIP定义、非VIP规则、满99判断、查询失败处理等），最终产出结构化规格（规则名、触发条件、输入、分支、边界、异常）。强调规格是对业务行为的结构化定义，而非简单的提示词润色；并给出反例说明模糊需求导致AI实现的多种偏差。

5 从需求到设计的链路：核心逻辑为需求文档 → 识别业务事件 → 定义业务能力（动宾结构）→ 补充业务规则 → 结构化描述（YAML）→ 工作流编排 → AI生成代码。通过实际业务场景（用户提交订单、库存检查、VIP包邮）拆解每一步的具体内容。

文章总结：

本文系统阐述了AI编程中需求分析与描述的方法论，强调将模糊需求转化为精确规格是保证AI生成代码质量的核心，并为开发人员提供了可操作的检查标准和转化链路。