产品需求 → 交互原型(Pencil) → 软件设计说明书
端到端标准化流程与模板规范
本手册同时承担两项职能:
参考腾讯 Engineering for AI Coding 成熟度体系,将团队能力分为三个等级:
大多数团队当前处于 L2 早期,本手册以此为基线设计各阶段规范,同时为演进至 L3 预留框架接口(第八章「交付+治理双框架」)。
| 阶段 | 主导角色 | 配合角色 | AI 辅助 |
|---|---|---|---|
| PRD 编写 | 产品经理 | 业务方、技术负责人 | PRD-Agent 生成初稿 |
| 原型设计 | 产品经理 | 技术负责人、业务代表 | AI 布局建议、组件推荐(Pencil) |
| PRD → 原型交接 | 产品经理 | 技术负责人 | 自动生成交接检查清单 |
| 原型评审 | 产品经理 | 技术负责人、业务代表 | — |
| SDD 编写 | 技术负责人 / 开发 | 架构师、测试负责人 | SDD-Agent 生成初稿 |
| 原型 → SDD 交接 | 产品经理 | 技术负责人、开发 | 前置知识包自动生成 |
| 代码生成 | 开发 | 测试 | CodeBuddy / OpenClaw |
| 测试验收 | 测试负责人 | 开发、产品经理 | 自动化测试用例生成 |
| 部署 | 运维 | 开发 | CI/CD 流水线 |
原型设计由产品经理使用 Pencil 工具独立完成,无需设计师介入。产品经理负责原型→SDD 讲解及交接,讲解会改为「产品讲解会」。
| 阶段 | 输入(Input) | 产出(Output) | 质量门槛 |
|---|---|---|---|
| PRD 编写 | 业务需求、用户反馈、战略目标 | PRD 文档(≥80分) | 评分 ≥80 通过 |
| PRD 评审 | PRD 文档 | 评审纪要、修改意见 | 产品+技术+业务三方签字 |
| 原型设计 | PRD 文档 + 交接确认 | Pencil 原型文件(.ep) | 交互标注完整率 100% |
| 原型评审 | Pencil 原型 | 评审纪要、修改意见 | 产品+技术+设计三方签字 |
| PRD → 原型 交接 | PRD 文档(评审通过版) | 交接确认单 | 交接检查清单 100% 通过 |
| SDD 编写 | Pencil 原型 + PRD + 交接确认 | SDD 文档(分章节) | 架构师+技术负责人联审 |
| SDD 评审 | SDD 文档 | 评审纪要、修改意见 | 开发全员评审通过 |
| 原型 → SDD 交接 | Pencil 原型(评审通过版) | 前置知识包 + 交接确认单 | 设计师讲解会完成 |
| 代码生成 | SDD 文档(评审通过版) | 源代码 + 单元测试 | AI 代码采纳率 ≥80% |
| 测试执行 | 源代码 + SDD | 测试报告(含用例通过率) | 测试用例通过率 ≥95% |
| 产品验收 | 测试报告 + 原型 | 验收确认单 | 产品经理签字 |
| 部署 | 验收确认单 | 上线确认单 | 门禁全通过 |
PRD 文档统一采用以下四部分结构,每部分均有强制字段:
每项功能必须包含:功能名称、描述、验收标准(可测试)、优先级、预计工作量(人天)。验收标准须为可量化/可观测的条款,不能使用模糊描述。
所有 PRD 上评审会前须完成自评,≥80 分方可提审。不满足则打回重写。
评审不通过的 PRD 须按以下规则修正,不得降级处理:
Pencil 文件内所有组件须使用统一命名规范(产品经理负责编写),便于 SDD 阶段快速定位:
{模块}_{页面}_{组件类型}_{序号}
示例:Order_Checkout_Btn_Submit_01
含义:订单模块 → 结算页 → 按钮 → 提交按钮 → 序号01
每个可交互元素须在 Pencil 中标注以下信息:
交互标注完整率须达到 100%。未标注项视为「设计待确认」,SDD 阶段有权暂停并打回补充。
{项目}_{模块}_v{版本号}.ep,如 OMS_Order_v2.3.ep产品经理提交流原型之前,须完成以下检查项,由技术负责人或设计师确认:
交接须由 产品经理 + 技术负责人 双方在交接确认单上签字(无专职设计师,由产品经理承担原型设计职责)。签字即代表:产品确认原型符合 PRD,技术确认无架构风险。
大团队 SDD 采用分章节编写,每个子模块独立成册,便于多模块并行开发、单独评审和独立版本管理。
| 模块名 | 依赖模块 | 提供接口 | 消费接口 | 数据依赖 | 部署顺序 |
|---|---|---|---|---|---|
| Order | User / Product | POST /order/create | GET /user/info | User Name | 1 |
| Product | — | GET /product/{id} | — | — | 0(基础) |
| User | — | GET /user/info | — | — | 0(基础) |
{模块}_SDD_v{主版本}.{次版本}.{修订号}.md原型评审通过后,产品经理须向开发团队进行正式讲解,确保开发充分理解产品原型设计意图:
讲解会前,产品经理提供以下前置知识包供开发预习:
交接须由 产品经理 + 技术负责人 + 开发代表 三方在交接确认单上签字。签字即代表:产品确认交付完整,开发确认理解设计意图,技术负责人确认可启动 SDD。
参考腾讯「AI全自动化平台」双轮驱动体系:大团队须同步建设交付框架与治理框架,形成「交付驱动效率,治理保障质量」的正循环。
AI 编码在提升速度的同时带来质量失控风险。须配置:需求评审门禁 / 方案评审门禁 / 代码 CR 门禁 / 安全检测门禁,任意一环不通过则阻断后续流程。
Skills 是 AI Agent 的核心执行能力,大团队须沉淀以下标准化 Skills:
AI 编码在静态代码生成上表现良好,但对系统架构、性能、可用性等问题能力有限。大团队须建立以下线上治理能力:
为解决 AI 辅助交付过程中「产出具与需求期望不一致」的问题,在每个环节设置校验 Skill,自动检查产出质量并驱动 AI 修复,确保交付内容始终符合预期。
skill:prd-validate触发时机:产品经理完成 PRD 初稿后,提交评审前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 需求评分 | ≥80分 | AI 分析失分原因,针对性重写对应区段(背景/价值/方案/影响) |
| 背景描述 | 非空、目标用户明确 | AI 补充用户画像、业务背景、问题陈述 |
| 验收标准 | 可量化/可测试 | AI 将模糊描述(「体验好」「操作流畅」)改为可测试指标 |
| 优先级标注 | P0/P1/P2 全标注 | AI 按重要性排序建议,补充缺失优先级 |
| 外部依赖 | 已识别并说明 | AI 补充依赖系统、接口提供方、数据权限申请计划 |
输出:prd-quality-report.json + 合格/不合格状态 + 评分详情
skill:prd-prototype-consistency触发时机:PRD 和原型同时产出后,进入交接流程前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 功能覆盖 | 100% | AI 检测 PRD 功能在原型中的缺失页面,补充原型标注或标注「原型未体现」 |
| 验收标准覆盖 | 100% | AI 对比每条验收标准 vs 原型交互,输出「未覆盖验收点」清单 |
| 页面跳转一致性 | 与 PRD 流程图一致 | AI 检测跳转矛盾,生成修改建议或标注风险项 |
| 数据字段一致性 | PRD 字段在原型有对应 | AI 检查表单字段,输出缺字段清单及补充建议 |
| P0 功能详细度 | P0 有详细设计说明 | AI 检查 P0 功能在原型中的标注密度,不足则补充 |
输出:consistency-report.json + 一致性得分 + 差异清单(AI已修复/待确认)
skill:prototype-validate触发时机:产品经理完成原型设计后,提交评审前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 交互标注完整率 | 100% | AI 自动补充缺失的交互说明(触发条件/交互行为/异常处理/数据来源) |
| 组件命名规范 | 符合 {模块}_{页面}_{类型}_{序号} | AI 批量检测并重命名不规范组件 |
| 异常状态标注 | 空态/加载态/错误态已覆盖 | AI 补充异常流程设计说明,标注缺失的异常场景 |
| 页面跳转一致性 | 与 PRD 流程图一致 | AI 检测跳转矛盾,输出修改建议 |
| 版本号 | 已锁定 | 确认版本状态,提示未锁定项 |
输出:prototype-check-report.json + 交接确认单(自动生成)
skill:handoff-prototype-sdd触发时机:原型评审通过后,正式交接给开发前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 产品讲解会 | 已完成,有 Q&A 纪要 | AI 总结讲解会 Q&A,生成纪要模板;提醒未参加的开发确认 |
| 前置知识包 | 已发布,链接可访问 | AI 检查链接可访问性,补充缺失项 |
| 交互标注 | 无「待确认」状态 | AI 标注或标记为 P1 风险项,提供修复建议 |
| 开发确认 | 已签字 | AI 发送确认提醒给开发代表,汇总未确认人员 |
输出:handover-confirm.json(三方签字电子版)+ 未完成项清单
skill:sdd-validate触发时机:技术负责人完成 SDD 初稿后,提交评审前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 章节完整性 | 6章节全部存在 | AI 补充缺失章节初稿(概述/数据模型/接口协议/模块设计/依赖矩阵/执行清单) |
| 接口协议 | 路径/方法/请求/响应完整 | AI 补充接口规格说明,检测缺失字段 |
| 非功能约束 | 性能/安全/可用性已覆盖 | AI 按行业基准补充非功能需求说明 |
| 依赖矩阵 | 模块依赖关系清晰 | AI 生成依赖图谱,补充文档缺失项 |
| 版本管理 | 变更记录完整 | AI 补充变更日志模板,检查历史版本 |
输出:sdd-quality-report.json + 章节完整性评分
skill:code-sdd-consistency触发时机:开发完成代码初版,提交 MR 前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 接口一致性 | 代码接口 vs SDD 接口一致 | AI 对比差异,输出接口不匹配清单及修改建议 |
| 数据模型一致性 | 字段类型/名称与 SDD 一致 | AI 检测字段差异,输出修改建议 |
| 异常处理一致性 | 与原型标注的异常场景一致 | AI 对比异常处理逻辑,补充缺失的异常分支 |
输出:code-sdd-consistency-report.json + 差异清单 + 修改建议
skill:test-validate触发时机:测试完成测试报告后,产品验收前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 测试用例通过率 | ≥95% | AI 分析失败用例,生成修复建议;自动生成补充测试用例覆盖失败场景 |
| P0/P1 功能覆盖 | 全部有测试用例 | AI 检测缺失场景,补充测试用例 |
| 异常/边界测试 | 已覆盖 | AI 补充边界测试用例(最大/最小/临界值/异常输入) |
| 单元测试覆盖率 | ≥70% | AI 自动生成单元测试代码,补充未覆盖分支 |
输出:test-report.json + 测试用例清单 + 覆盖率报告
skill:product-acceptance触发时机:测试报告通过后,产品经理进行验收前
| 校验项 | 阈值 | AI 自动修复策略 |
|---|---|---|
| 功能一致性 | 实现 vs 原型完全匹配 | AI 对比原型标注 vs 代码实现,输出差异清单及修复建议 |
| 验收标准达成 | P0/P1 全部通过 | AI 生成验收清单,逐项标注通过/未通过/风险 |
| 缺陷单闭环 | 所有 Bug 已关闭 | AI 输出未关闭缺陷清单,按优先级排序 |
输出:acceptance-report.json + 验收通过/待修复清单 + 产品经理签字确认页
任意环节校验不通过时,阻断进入下一环节。AI 自动修复后重新校验;若 AI 无法修复,自动发送通知给责任人(产品/技术/测试),并记录阻塞点。待人工处理完成后,重新触发 Skill 校验。
每个 Skill 完成后,统一输出以下结构化报告:
{
"skill": "skill:prd-validate",
"timestamp": "2026-04-29T07:00:00Z",
"status": "PASS | FAIL | AUTO_FIXED",
"score": 85,
"checks": [
{
"item": "需求评分",
"threshold": "≥80",
"actual": 72,
"result": "FAIL",
"autoFixApplied": "已重写「解决方案」区段,补充验收标准可测试性描述",
"recheckResult": "PASS"
}
],
"blocker": null, // 或 { "item": "...", "message": "..." }
"nextAction": "进入原型设计环节",
"signatures": {
"product": null, // null 表示无需签字,需签字时为 "2026-04-29 product.pm 已签字"
"tech": null,
"test": null
}
}
| 第九章 质量门禁 | 对应 Skill | 拦截行为 |
|---|---|---|
| PRD 评分 <80 分 → 阻断评审 | skill:prd-validate | 不通过则不允许提审,AI 自动修复后重新校验 |
| 原型标注完整率 <100% → 阻断交接 | skill:prototype-validate | 不通过则返还产品补充,AI 自动修复标注 |
| SDD 章节缺失 → 阻断开发 | skill:sdd-validate | 不通过则返还技术负责人补充,AI 补充缺失章节 |
| 测试用例通过率 <95% → 阻断验收 | skill:test-validate | 不通过则阻断产品验收,AI 自动生成补充用例 |
| 产品验收未通过 → 阻断部署 | skill:product-acceptance | 不通过则返还开发修复,AI 输出差异清单 |
| AI 代码采纳率 <80% → 加强 CR | skill:code-sdd-consistency | 不通过则触发人工代码评审,AI 输出不一致项 |
| 安全扫描不通过 → 阻断上线 | (CI/CD 安全门禁) | 安全卡点独立运行,不在本 Skill 体系内 |
| 架构评审不通过 → 阻断开发 | (架构评审委员会) | 人工评审环节,不在本 Skill 体系内 |
| 序号 | 检查项 | 检查依据 | 责任方 |
|---|---|---|---|
| 1 | PRD 已通过评审,版本已锁定 | 评审纪要 + 版本号 | 产品 |
| 2 | PRD 评分 ≥80 分 | 评分报告 | 产品 |
| 3 | 所有 P0/P1 功能已覆盖 | PRD 功能清单 vs 原型页面 | 产品 |
| 4 | 验收标准已体现 | PRD 验收标准 vs 原型交互 | 产品 |
| 5 | 外部接口可行性已确认 | 技术评审意见 | 技术 |
| 6 | 页面跳转与流程图一致 | PRD 流程图 vs Pencil | 产品 |
| 7 | 异常状态已标注 | Pencil 标注完整率 100% | 产品 |
| 8 | P0 功能有明确设计说明 | 标注文档 | 产品 |
| 序号 | 检查项 | 检查依据 | 责任方 |
|---|---|---|---|
| 1 | 原型已通过评审,版本已锁定 | 评审纪要 + 版本号 | 产品 |
| 2 | 所有交互标注完整,无「待确认」 | Pencil 标注完整率 | 产品 |
| 3 | 产品讲解会已完成,Q&A 有记录 | 讲解纪要文档 | 产品 |
| 4 | 前置知识包已发布 | 协同工具链接 | 产品 |
| 5 | 开发确认理解设计意图 | 开发签字 | 开发 |
| 6 | 技术负责人确认可启动 SDD | 技术负责人签字 | 技术 |
| 缩写 | 全称 | 说明 |
|---|---|---|
| PRD | Product Requirements Document | 产品需求文档 |
| SDD | Software Design Description | 软件设计说明书 |
| Pencil | Pencil Prototyping Tool | 原型设计工具(支持 .ep 格式) |
| MCP | Model Context Protocol | AI 工具链集成协议 |
| Skill | Agent Skill | AI Agent 的标准化技能单元 |
| CR | Code Review | 代码评审 |
| MR | Merge Request | 代码合并请求 |
| Lego | Lego 环境平台 | 测试环境快速创建平台 |
| DDL | Data Definition Language | 数据库结构变更语句 |
| Escalation | — | 问题升级机制 |