内部执行手册 · 培训教材

PRD 原型 SDD
全链路交付方案

产品需求 → 交互原型(Pencil) → 软件设计说明书
端到端标准化流程与模板规范

📅 2026-04-28 👥 适用规模:20人+ 大团队 🎯 目标:L2 人机协同 → L3 全自动
第一章

目的与成熟度模型

1 手册定位

本手册同时承担两项职能:

  • 执行手册:提供各阶段输入/产出标准、交接协议、模板规范,团队成员照此执行,确保多组协作一致性和交付质量。
  • 培训教材:配套示例与评分规则,帮助新成员快速理解 PRD→原型→SDD 的标准工作流,降低跨角色协作的认知门槛。

2 成熟度模型(L1 / L2 / L3)

参考腾讯 Engineering for AI Coding 成熟度体系,将团队能力分为三个等级:

L1 纯人工
  • 全流程人工驱动,无 AI 辅助
  • PRD、原型、SDD 全部手写
  • 设计→开发靠口头传达
  • 交付周期长,跨组协调成本高
L2 人机协同
  • AI 辅助生成 PRD 草案、SDD 初稿
  • 技术方案 → 代码生成(CodeBuddy / OpenClaw)
  • CI/CD 流水线自动触发测试和部署
  • 人负责评审和决策,AI 负责执行
L3 全自动
  • 需求输入 → 端到端自动化交付
  • 多 Agent 自主协同(需求/设计/开发/测试/部署)
  • 质量门禁、MR 卡点自动化
  • 运行时自愈与线上巡检能力

💡 当前目标

大多数团队当前处于 L2 早期,本手册以此为基线设计各阶段规范,同时为演进至 L3 预留框架接口(第八章「交付+治理双框架」)。

3 各阶段角色分工(L2)

阶段主导角色配合角色AI 辅助
PRD 编写产品经理业务方、技术负责人PRD-Agent 生成初稿
原型设计产品经理技术负责人、业务代表AI 布局建议、组件推荐(Pencil)
PRD → 原型交接产品经理技术负责人自动生成交接检查清单
原型评审产品经理技术负责人、业务代表
SDD 编写技术负责人 / 开发架构师、测试负责人SDD-Agent 生成初稿
原型 → SDD 交接产品经理技术负责人、开发前置知识包自动生成
代码生成开发测试CodeBuddy / OpenClaw
测试验收测试负责人开发、产品经理自动化测试用例生成
部署运维开发CI/CD 流水线

💡 团队无专职设计师说明

原型设计由产品经理使用 Pencil 工具独立完成,无需设计师介入。产品经理负责原型→SDD 讲解及交接,讲解会改为「产品讲解会」。

第二章

全链路流程总图

1 端到端里程碑

需求提出
产品经理
PRD 交付
产品经理
Pencil 原型
技术负责人
SDD 交付
开发
代码
测试
测试报告
产品经理
验收通过
运维
上线
🔵 交付物 🟡 主导角色 🟢 产出标准件

2 输入/产出物速查表

阶段输入(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 规范

1 PRD 模板标准

PRD 文档统一采用以下四部分结构,每部分均有强制字段:

📄 PRD 模板结构

  • 需求概述:背景描述(Why)、目标用户、核心价值主张
  • 需求正文:功能清单(含优先级 P0/P1/P2)、业务流程、数据埋点需求
  • 版本管理:版本号(v1.0)、变更记录、评审历史
  • 外部依赖:依赖系统、接口提供方、第三方服务、数据权限

📌 填写规范

每项功能必须包含:功能名称、描述、验收标准(可测试)、优先级、预计工作量(人天)。验收标准须为可量化/可观测的条款,不能使用模糊描述。

2 需求评分规则

所有 PRD 上评审会前须完成自评,≥80 分方可提审。不满足则打回重写。

20
需求背景
≥15 分
20
价值衡量
≥15 分
30
解决方案
≥24 分
30
影响范围
≥24 分

评分细则

  • 需求背景(20分):问题陈述清晰(0-10)+ 目标用户明确(0-10),低于15分打回
  • 价值衡量(20分):业务价值可量化(0-10)+ 与产品路线图对齐(0-10),低于15分打回
  • 解决方案(30分):功能清单完整(0-10)+ 验收标准可测试(0-10)+ 优先级明确(0-10),低于24分打回
  • 影响范围(30分):依赖关系清晰(0-10)+ 数据权限说明(0-10)+ 非功能性需求(性能/安全/可用性)已覆盖(0-10),低于24分打回

3 需求澄清规则

评审不通过的 PRD 须按以下规则修正,不得降级处理:

  • 背景缺失:补充业务背景、目标用户画像、核心问题陈述
  • 验收标准模糊:将"用户体验好"类描述改为可量化指标(如"首屏加载 ≤1.5s")
  • 优先级不清:按 P0/P1/P2 重新标注,P0 为阻塞性问题,P2 为可选优化
  • 依赖未识别:补充外部系统依赖、数据权限申请计划

4 PRD-Agent 使用规范

PRD-Agent(AI 辅助)
基于标准模板生成 PRD 初稿,支持需求澄清、评分自评
工具支持
需求模板库
预设各业务线标准模板,降低产品编写门槛
已沉淀
需求评分引擎
自动打分 + 不合格原因建议,≥80分才允许提审
工具支持
第四章

交互原型 Pencil 规范

1 组件命名标准

Pencil 文件内所有组件须使用统一命名规范(产品经理负责编写),便于 SDD 阶段快速定位:

命名格式:

{模块}_{页面}_{组件类型}_{序号}

示例:Order_Checkout_Btn_Submit_01

含义:订单模块 → 结算页 → 按钮 → 提交按钮 → 序号01

组件类型缩写

  • Btn:按钮 | Input:输入框 | Select:下拉选择
  • Table:表格 | Modal:弹窗 | Toast:轻提示
  • Nav:导航 | Card:卡片 | Tab:标签页
  • Form:表单容器 | List:列表 | Dialog:对话框

2 交互标注要求

每个可交互元素须在 Pencil 中标注以下信息:

  • 触发条件:用户操作(点击/输入/滑动) + 触发时机
  • 交互行为:跳转页面 / 弹窗类型 / 数据提交方式 / 加载状态
  • 异常处理:空状态 / 错误提示 / 加载失败 / 网络超时
  • 数据来源:调用的接口名 / 数据实体 / 是否需要用户授权

⚠️ 标注完整性要求

交互标注完整率须达到 100%。未标注项视为「设计待确认」,SDD 阶段有权暂停并打回补充。

3 导出物标准

交付物清单

  • .ep 源文件:Pencil 原文件(含全部页面、组件、母版)
  • 导出 PDF:全页截图 PDF,用于存档和跨组传阅
  • 标注说明文档:独立 Markdown/Word,详述每页交互逻辑
  • 组件清单:导出全组件列表(含命名、类型、状态说明)
  • 版本记录:记录每次修改日期、内容、修改人

4 版本管理

  • 文件命名格式:{项目}_{模块}_v{版本号}.ep,如 OMS_Order_v2.3.ep
  • 每次评审后更新版本号(小数点升级:v2.3 → v2.4)
  • 重大改版(需求变更导致页面结构变化)须升级主版本号(v2.x → v3.0)
  • 历史版本保留最近 3 个,存档至知识库
第五章

PRD → 原型 交接协议

1 交接检查清单

产品经理提交流原型之前,须完成以下检查项,由技术负责人或设计师确认:

✅ PRD → 原型 交接检查单

PRD 已通过评审,版本已锁定(v_x.x)
PRD 评分 ≥80 分,有评分报告附件
所有 P0/P1 功能均已在原型中覆盖,无遗漏
每个功能有对应验收标准,且原型能体现验收点
涉及外部接口的功能已与技术侧确认可行性
页面跳转关系与 PRD 中的流程图一致
异常状态(空态、加载态、错误态)已标注
优先级 P0 功能有明确的设计说明

📝 签字确认

交接须由 产品经理 + 技术负责人 双方在交接确认单上签字(无专职设计师,由产品经理承担原型设计职责)。签字即代表:产品确认原型符合 PRD,技术确认无架构风险。

2 需求澄清(Q&A)机制

澄清发起流程

  • 产品经理在原型设计过程中,发现 PRD 描述不清或存在歧义的条款,立即记录到「需求澄清单」
  • 通过协同工具(如飞书/Confluence)提交给原 PRD 作者(产品/业务),须在 2 个工作日内回复
  • PRD 作者更新需求后通知产品经理,产品经理确认后继续设计
  • 若超过 2 个工作日未回复,技术负责人介入协调

3 问题升级(Escalation)机制

  • L1:产品经理 ↔ 技术负责人 现场解决(不超 2 工作日)
  • L2:产品经理与业务/技术负责人共同评审(每周固定需求澄清会)
  • L3:无法达成共识 → 提交产品委员会决策(里程碑冻结后不允许 L3 升级)
第六章

SDD 规范

1 SDD 分章节模板

大团队 SDD 采用分章节编写,每个子模块独立成册,便于多模块并行开发、单独评审和独立版本管理。

SDD 章节结构

  • 章节一:概述 — 模块定位、目标、非功能性约束(性能/安全/可用性)
  • 章节二:数据模型 — ER 图、核心实体、字段说明、索引策略
  • 章节三:接口协议 — API 清单(路径、方法、请求/响应结构、错误码)
  • 章节四:模块设计 — 子模块划分、类/服务设计、核心流程时序图
  • 章节五:依赖矩阵 — 模块间依赖关系、上下游接口消费、部署顺序
  • 章节六:执行清单 — 研发阶段 / 测试阶段 / 部署阶段具体操作步骤

📄 SDD 章节一模板(概述)

  • 模块名称:____
  • 模块负责人:____
  • 模块版本:v_x.x
  • 功能概述:(3-5 句话描述模块职责)
  • 非功能性约束:性能要求(RT ≤ _ms,QPS ≥ _)/ 可用性(99.9%)/ 数据量预估(日 _ 条)
  • 技术选型:语言/框架/中间件
  • 上线里程碑:设计评审 _月_日 / 开发 _月_日 / 测试 _月_日 / 上线 _月_日

📄 SDD 章节五模板(依赖矩阵)

模块名依赖模块提供接口消费接口数据依赖部署顺序
OrderUser / ProductPOST /order/createGET /user/infoUser Name1
ProductGET /product/{id}0(基础)
UserGET /user/info0(基础)

3 版本管理与变更流程

  • SDD 命名{模块}_SDD_v{主版本}.{次版本}.{修订号}.md
  • 主版本升级:模块架构重大调整(如重构、拆分、合并),需全员评审 + 架构委员会审批
  • 次版本升级:新增子模块 / 新增接口,需技术负责人 + 关联模块负责人评审
  • 修订号升级:文档修正、不影响接口的说明补充,技术负责人单审即可
  • 变更记录:每个版本须附变更说明(改了什么、为什么改、影响了什么)
第七章

原型 → SDD 交接协议

1 产品讲解会

原型评审通过后,产品经理须向开发团队进行正式讲解,确保开发充分理解产品原型设计意图:

讲解会要求

  • 参与人员:产品经理(主讲)+ 技术负责人 + 相关开发 + 业务代表(观察席)
  • 会议时长:每模块 30-60 分钟,视复杂程度而定
  • 讲解内容:核心流程走查 → 关键页面说明 → 交互细节 → 异常状态 → Q&A
  • 会前准备:产品经理提前在协同工具发布 Pencil 链接和标注文档,开发须提前预览
  • 会议产出:讲解纪要(含 Q&A 结论)存入项目文档库

2 SDD 前置知识包

讲解会前,产品经理提供以下前置知识包供开发预习:

  • Pencil 源文件(.ep)+ 导出 PDF
  • 组件清单:组件名称/类型/状态说明的 Excel/表格清单
  • 页面关系图:所有页面之间的跳转关系(可用流程图或思维导图)
  • 产品说明文档:设计思路、业务逻辑、关键决策说明
  • 标注说明文档:详述每个交互行为的触发条件和数据来源

3 开发接手确认流程

✅ 原型 → SDD 交接检查单

原型已通过评审,版本已锁定(v_x.x)
所有交互标注完整,无「待确认」状态
产品讲解会已完成,Q&A 结论已记录
开发已阅读前置知识包,无未解决问题
技术负责人确认 SDD 可以开始编写

📝 签字确认

交接须由 产品经理 + 技术负责人 + 开发代表 三方在交接确认单上签字。签字即代表:产品确认交付完整,开发确认理解设计意图,技术负责人确认可启动 SDD。

第八章

交付 + 治理双框架

参考腾讯「AI全自动化平台」双轮驱动体系:大团队须同步建设交付框架与治理框架,形成「交付驱动效率,治理保障质量」的正循环。

🟢 交付框架

  • 需求 → PRD → 原型 → SDD → 代码 → 测试 → 部署 全链路自动化串联
  • 需求评审、方案评审、质量门禁、MR 工程卡点
  • 闭环反馈与卡点自动修复
  • Skills 标准化复用(需求生成、方案生成、代码CR、测试执行)

🟠 治理框架

  • 运行时日志 + 监测指标全覆盖
  • 线上服务自动巡检与异常修复
  • 架构 / 性能 / 可用性系统性监控
  • 知识库 + Skills 自动化回溯更新

1 交付框架:SDD → 代码 → 测试 → 部署

研发阶段

  • 基于 SDD 分章节模板生成代码结构(Controller / Service / Mapper / Model)
  • 基于代码层级结构自动生成单元测试用例(覆盖率目标 ≥70%)
  • CodeBuddy / OpenClaw 辅助代码生成,AI 代码采纳率目标 ≥80%

测试阶段

  • Lego MCP 一键拉起测试环境(耗时 5-10 分钟,0 平台切换)
  • DDL Skill / MCP 工具将数据库变更申请耗时降低到秒级
  • 接口自动化测试:AI 自动识别代码生成测试用例,通过 MCP 一键发起接口自测
  • 测试用例覆盖:功能测试 + 异常测试 + 边界测试,测试用例通过率须 ≥95%

产品验收阶段

  • 测试报告完成后,产品经理基于原型 + PRD 验收标准进行功能验收
  • 验收内容:所有 P0/P1 功能点逐一核查,确认实现与原型一致
  • 验收异常记录:若发现与原型不符,提交缺陷单(Bug),开发修复后重新测试
  • 验收通过后,产品经理在验收确认单上签字,方可进入部署阶段
  • 重要:产品验收是上线前的强制门禁,未通过验收不允许部署

部署阶段

  • 七彩石配置 + DDL/DML 工单 + 蓝盾流水线联动
  • 接入无人值守:自动完成智研发布单申请和执行
  • 部署步骤从 12 步优化至 5 步(理想 2 步),平均节约 0.5 人天/需求

⚠️ 代码质量门禁

AI 编码在提升速度的同时带来质量失控风险。须配置:需求评审门禁 / 方案评审门禁 / 代码 CR 门禁 / 安全检测门禁,任意一环不通过则阻断后续流程。

2 Skills 标准化体系

Skills 是 AI Agent 的核心执行能力,大团队须沉淀以下标准化 Skills:

需求生成 Skill
基于需求模板自动生成 PRD 草案,含需求评分和澄清建议
PRD-Agent
方案生成 Skill
基于 PRD + 原型生成 SDD 初稿,输出分章节结构
SDD-Agent
代码生成 Skill
基于 SDD + 技术规范自动生成代码,集成单元测试
CodeBuddy
代码 CR Skill
代码评审自动化,检查命名规范、安全漏洞、性能问题
已集成
测试执行 Skill
基于代码变更自动生成测试用例,一键发起接口自动化
规划中
环境创建 Skill
Lego MCP 一键拉起测试环境,支持 DDL/DML 自动执行
已集成

3 知识库建设

三大知识库

  • 业务知识库:业务术语、领域模型、业务规则、行业规范,供 AI 生成符合业务语境的 SDD
  • 代码知识库:历史代码结构、最佳实践、组件库文档,供 AI 快速熟悉新模块代码
  • 技术规范库:编码规范、接口协议、安全标准、部署手册,供 AI 生成符合团队技术标准的代码
第九章

变更与质量问题处理

1 需求变更流程

变更分级

  • P0 变更(重大):影响已评审通过的 PRD / 原型 / SDD 主架构,须重新走评审流程,milestone 顺延
  • P1 变更(中等):影响 SDD 局部设计(如接口调整),需技术负责人 + 关联开发评审
  • P2 变更(轻微):文档修正、字段调整,不影响架构和接口,技术负责人单审即可

变更申请流程

  • 申请人(产品/设计)填写变更申请单(含:变更内容、原因、影响评估、解决方案)
  • 技术负责人评估影响范围和工期
  • P0 变更须三方(产品+设计+技术)联合评审签字
  • 变更批准后,更新对应文档版本号,通知全相关方

📄 变更申请单模板

  • 需求/模块名称:____
  • 变更类型:P0 / P1 / P2
  • 变更内容:(具体描述)
  • 变更原因:____
  • 影响评估:影响范围(模块/接口/里程碑)/ 工作量估算(人天)
  • 解决方案:____
  • 申请人:____ 申请日期:____
  • 技术负责人意见:____ 签字:____

2 低质量交付拦截机制

🚫 各阶段质量门禁

PRD 评分 <80 分 → 阻断评审,返还产品重写
原型标注完整率 <100% → 阻断交接,返还产品补充
SDD 章节缺失或依赖关系不清 → 阻断代码开发,返还补充
AI 代码采纳率 <80% → 触发人工代码评审加强
单元测试覆盖率 <70% → 阻断合并,需补充测试
测试用例通过率 <95% → 阻断验收,需修复后重跑
产品验收未通过 → 阻断部署,返回开发修复
安全扫描不通过 → 阻断上线,需修复后重跑
架构评审不通过 → 阻断开发,重大重构

3 线上问题自愈能力(治理框架延伸)

AI 编码在静态代码生成上表现良好,但对系统架构、性能、可用性等问题能力有限。大团队须建立以下线上治理能力:

  • 自动巡检:定时任务检测线上服务健康状态(RT、QPS、错误率、资源使用率)
  • 异常感知:异常日志实时告警,自动生成故障记录和初步分析
  • 自愈脚本:针对常见故障(如服务 OOM、连接池耗尽)建立自愈脚本库
  • 架构监控:定期输出系统架构健康报告,包含依赖复杂度、热点模块、性能瓶颈
第十章

AI 校验 Skill 全链路体系

为解决 AI 辅助交付过程中「产出具与需求期望不一致」的问题,在每个环节设置校验 Skill,自动检查产出质量并驱动 AI 修复,确保交付内容始终符合预期。

1 Skill 校验架构

统一校验流程

  • 输入接收:获取上一环节的产出物(PRD / 原型 / SDD / 代码 / 测试报告)
  • 标准校验:按手册阈值逐项检查(阈值可配置)
  • 自动修复:不达标项 AI 自动调整,修复后重新校验
  • 输出确认:通过则签发合格证,触发下一环节
  • 人工升级:无法自动修复 → 通知责任人处理
环节产出
校验 Skill
通过 ✅
下一环节
❌ 不通过
AI自动修复
重新校验 ⚠️ 无法修复 → 人工处理

2 各环节校验 Skill 详表

Skill 1:PRD 校验 · skill:prd-validate

触发时机:产品经理完成 PRD 初稿后,提交评审前

校验项阈值AI 自动修复策略
需求评分≥80分AI 分析失分原因,针对性重写对应区段(背景/价值/方案/影响)
背景描述非空、目标用户明确AI 补充用户画像、业务背景、问题陈述
验收标准可量化/可测试AI 将模糊描述(「体验好」「操作流畅」)改为可测试指标
优先级标注P0/P1/P2 全标注AI 按重要性排序建议,补充缺失优先级
外部依赖已识别并说明AI 补充依赖系统、接口提供方、数据权限申请计划

输出:prd-quality-report.json + 合格/不合格状态 + 评分详情

Skill 2:PRD ↔ 原型 一致性校验 · 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 3:原型校验 · skill:prototype-validate

触发时机:产品经理完成原型设计后,提交评审前

校验项阈值AI 自动修复策略
交互标注完整率100%AI 自动补充缺失的交互说明(触发条件/交互行为/异常处理/数据来源)
组件命名规范符合 {模块}_{页面}_{类型}_{序号}AI 批量检测并重命名不规范组件
异常状态标注空态/加载态/错误态已覆盖AI 补充异常流程设计说明,标注缺失的异常场景
页面跳转一致性与 PRD 流程图一致AI 检测跳转矛盾,输出修改建议
版本号已锁定确认版本状态,提示未锁定项

输出:prototype-check-report.json + 交接确认单(自动生成)

Skill 4:原型 → SDD 交接校验 · skill:handoff-prototype-sdd

触发时机:原型评审通过后,正式交接给开发前

校验项阈值AI 自动修复策略
产品讲解会已完成,有 Q&A 纪要AI 总结讲解会 Q&A,生成纪要模板;提醒未参加的开发确认
前置知识包已发布,链接可访问AI 检查链接可访问性,补充缺失项
交互标注无「待确认」状态AI 标注或标记为 P1 风险项,提供修复建议
开发确认已签字AI 发送确认提醒给开发代表,汇总未确认人员

输出:handover-confirm.json(三方签字电子版)+ 未完成项清单

Skill 5:SDD 校验 · skill:sdd-validate

触发时机:技术负责人完成 SDD 初稿后,提交评审前

校验项阈值AI 自动修复策略
章节完整性6章节全部存在AI 补充缺失章节初稿(概述/数据模型/接口协议/模块设计/依赖矩阵/执行清单)
接口协议路径/方法/请求/响应完整AI 补充接口规格说明,检测缺失字段
非功能约束性能/安全/可用性已覆盖AI 按行业基准补充非功能需求说明
依赖矩阵模块依赖关系清晰AI 生成依赖图谱,补充文档缺失项
版本管理变更记录完整AI 补充变更日志模板,检查历史版本

输出:sdd-quality-report.json + 章节完整性评分

Skill 6:代码 ↔ SDD 一致性校验 · skill:code-sdd-consistency

触发时机:开发完成代码初版,提交 MR 前

校验项阈值AI 自动修复策略
接口一致性代码接口 vs SDD 接口一致AI 对比差异,输出接口不匹配清单及修改建议
数据模型一致性字段类型/名称与 SDD 一致AI 检测字段差异,输出修改建议
异常处理一致性与原型标注的异常场景一致AI 对比异常处理逻辑,补充缺失的异常分支

输出:code-sdd-consistency-report.json + 差异清单 + 修改建议

Skill 7:测试验收校验 · skill:test-validate

触发时机:测试完成测试报告后,产品验收前

校验项阈值AI 自动修复策略
测试用例通过率≥95%AI 分析失败用例,生成修复建议;自动生成补充测试用例覆盖失败场景
P0/P1 功能覆盖全部有测试用例AI 检测缺失场景,补充测试用例
异常/边界测试已覆盖AI 补充边界测试用例(最大/最小/临界值/异常输入)
单元测试覆盖率≥70%AI 自动生成单元测试代码,补充未覆盖分支

输出:test-report.json + 测试用例清单 + 覆盖率报告

Skill 8:产品验收校验 · skill:product-acceptance

触发时机:测试报告通过后,产品经理进行验收前

校验项阈值AI 自动修复策略
功能一致性实现 vs 原型完全匹配AI 对比原型标注 vs 代码实现,输出差异清单及修复建议
验收标准达成P0/P1 全部通过AI 生成验收清单,逐项标注通过/未通过/风险
缺陷单闭环所有 Bug 已关闭AI 输出未关闭缺陷清单,按优先级排序

输出:acceptance-report.json + 验收通过/待修复清单 + 产品经理签字确认页

3 全链路 Skill 协作流程

PRD
prd-validate
原型
prd-prototype-consistency
prototype-validate
handoff-prototype-sdd
SDD
sdd-validate
代码
code-sdd-consistency
test-validate
product-acceptance
上线
🔵 产出物 🔷 校验Skill(自动通过AI修复) 🔶 交接Skill 🟢 最终验收

⚠️ 关键约束

任意环节校验不通过时,阻断进入下一环节。AI 自动修复后重新校验;若 AI 无法修复,自动发送通知给责任人(产品/技术/测试),并记录阻塞点。待人工处理完成后,重新触发 Skill 校验。

4 Skill 输出物标准

每个 Skill 完成后,统一输出以下结构化报告:

校验报告结构(JSON Schema)

{
  "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
  }
}

5 与第九章质量门禁的对应关系

第九章 质量门禁对应 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% → 加强 CRskill:code-sdd-consistency不通过则触发人工代码评审,AI 输出不一致项
安全扫描不通过 → 阻断上线(CI/CD 安全门禁)安全卡点独立运行,不在本 Skill 体系内
架构评审不通过 → 阻断开发(架构评审委员会)人工评审环节,不在本 Skill 体系内
附录

附录:完整交接检查单汇总

PRD → 原型 交接检查单

序号检查项检查依据责任方
1PRD 已通过评审,版本已锁定评审纪要 + 版本号产品
2PRD 评分 ≥80 分评分报告产品
3所有 P0/P1 功能已覆盖PRD 功能清单 vs 原型页面产品
4验收标准已体现PRD 验收标准 vs 原型交互产品
5外部接口可行性已确认技术评审意见技术
6页面跳转与流程图一致PRD 流程图 vs Pencil产品
7异常状态已标注Pencil 标注完整率 100%产品
8P0 功能有明确设计说明标注文档产品

原型 → SDD 交接检查单

序号检查项检查依据责任方
1原型已通过评审,版本已锁定评审纪要 + 版本号产品
2所有交互标注完整,无「待确认」Pencil 标注完整率产品
3产品讲解会已完成,Q&A 有记录讲解纪要文档产品
4前置知识包已发布协同工具链接产品
5开发确认理解设计意图开发签字开发
6技术负责人确认可启动 SDD技术负责人签字技术

术语表

缩写全称说明
PRDProduct Requirements Document产品需求文档
SDDSoftware Design Description软件设计说明书
PencilPencil Prototyping Tool原型设计工具(支持 .ep 格式)
MCPModel Context ProtocolAI 工具链集成协议
SkillAgent SkillAI Agent 的标准化技能单元
CRCode Review代码评审
MRMerge Request代码合并请求
LegoLego 环境平台测试环境快速创建平台
DDLData Definition Language数据库结构变更语句
Escalation问题升级机制