
下面是一套可直接落地为 Excel 的质量管控文档设计适用于交付项目型研发团队 AI 编码 SDDSpec Driven Development模式。建议 Excel 包含以下 6 个 Sheet《总览-质量门禁》《节点1-需求Spec质量》《节点2-接口文档与接口质量》《节点3-单元测试质量》《节点4-冒烟测试质量》《问题跟踪与整改》Sheet 1《总览-质量门禁》阶段质量节点主责角色参与角色准入条件准出条件主要产物是否必须通过未通过处理需求阶段需求 Spec 质量产品经理项目经理、开发、测试项目范围明确已有原始需求或客户输入Spec 评审通过无 P0/P1 疑问未关闭需求 Spec、验收标准、业务规则、异常场景是禁止进入开发设计阶段接口文档和接口质量开发产品经理、测试、项目经理需求 Spec 已通过接口文档评审通过Mock 或联调契约明确API 文档、字段说明、错误码、Mock 数据是禁止接口开发或联调开发阶段单元测试质量开发测试、项目经理接口设计明确代码开发完成单测通过率、覆盖率达标无阻塞缺陷单测代码、覆盖率报告、AI 生成代码审查记录是禁止提测提测阶段冒烟测试质量测试开发、产品经理、项目经理开发自测完成部署到测试环境核心链路冒烟通过无阻塞问题冒烟用例、测试报告、缺陷记录是打回开发修复Sheet 2《节点1-需求 Spec 质量》检查维度检查项具体质量标准准入条件准出条件操作步骤主责角色参与角色检查方式产物/证据结果需求完整性是否包含业务背景说明业务目标、用户角色、使用场景、业务价值已有客户需求、会议纪要或合同范围背景描述清晰无重大遗漏产品经理整理业务背景项目经理确认范围产品经理项目经理人工评审需求 Spec 文档通过/不通过需求完整性是否包含功能范围明确做什么、不做什么边界清晰原始需求已收集功能边界无歧义列出功能清单、非功能清单、排除项产品经理开发、测试评审会议功能范围清单通过/不通过需求明确性是否存在模糊描述不出现“尽量”“大概”“支持一下”“优化”等不可验证描述初版 Spec 已完成所有描述可被开发和测试理解使用 AI 辅助检查模糊词产品经理修订产品经理开发、测试AI 检查 人工复核模糊项整改记录通过/不通过需求可测试性是否定义验收标准每个需求至少有一条可验证的验收标准功能点已拆分验收标准覆盖正常、异常、边界场景按 Given-When-Then 编写验收标准产品经理测试用例反推验收标准列表通过/不通过业务规则是否列出业务规则规则包含条件、计算逻辑、状态流转、权限控制需求场景明确规则无冲突、无遗漏梳理规则表、状态机、权限矩阵产品经理开发、测试评审业务规则表通过/不通过异常场景是否覆盖异常和边界包含空值、重复、超限、无权限、数据不存在、并发等场景主流程已明确异常场景有处理规则测试基于 Spec 补充异常场景测试产品经理、开发测试评审异常场景清单通过/不通过数据要求是否明确数据字段字段名称、类型、必填、默认值、取值范围清晰功能设计完成字段定义可支撑接口设计产品经理列字段开发补充技术约束产品经理开发文档检查字段说明表通过/不通过权限要求是否明确角色权限不同角色可见、可操作范围明确用户角色已定义权限矩阵评审通过建立角色-功能-数据权限矩阵产品经理开发、测试权限矩阵检查权限矩阵通过/不通过非功能需求是否包含性能、安全、兼容性要求有明确指标如响应时间、并发量、日志、安全限制项目交付标准明确指标可验证、可测试项目经理协调客户确认指标项目经理产品、开发、测试评审非功能需求表通过/不通过AI 编码准备是否适合 AI 编码输入Spec 结构化、无歧义、可拆分为开发任务Spec 初版完成可作为 AI Prompt 或 SDD 输入将 Spec 拆为用户故事、任务、验收条件产品经理开发AI Prompt 检查AI 编码输入文档通过/不通过Sheet 3《节点2-接口文档和接口质量》检查维度检查项具体质量标准准入条件准出条件操作步骤主责角色参与角色检查方式产物/证据结果接口完整性是否覆盖所有功能接口每个功能点都有对应接口或说明无需接口需求 Spec 已通过接口清单完整无遗漏开发根据 Spec 输出接口清单开发产品、测试Spec 对照检查接口清单通过/不通过接口定义是否包含基本信息包含接口名称、URL、Method、描述、调用方、提供方接口清单完成信息完整命名规范按统一模板编写接口文档开发测试文档检查API 文档通过/不通过请求参数是否明确请求参数字段名、类型、是否必填、默认值、枚举、长度、示例齐全接口定义完成参数无歧义可直接开发和测试开发补充请求字段说明开发测试文档检查请求参数表通过/不通过响应参数是否明确响应结构返回码、message、data 结构、分页结构、空数据结构明确请求参数完成前后端可基于文档联调开发补充响应示例开发前端/测试Mock 校验响应示例通过/不通过错误码是否定义错误码错误码统一、语义明确、处理建议清晰接口流程明确常见异常均有错误码维护错误码表开发测试异常场景对照错误码表通过/不通过权限控制是否说明鉴权逻辑登录态、角色权限、数据权限、Token 规则明确权限需求明确权限校验点清晰根据权限矩阵标注接口权限开发产品、测试权限用例检查接口权限说明通过/不通过幂等与并发是否考虑重复提交和并发涉及新增、支付、审批、状态变更类接口必须说明幂等策略业务规则明确幂等规则和并发处理方式确认开发设计幂等 Key、锁或状态校验开发测试设计评审幂等设计说明通过/不通过数据校验是否定义参数校验规则必填、格式、范围、枚举、跨字段校验明确参数定义完成校验失败返回明确错误码开发补充校验规则开发测试用例反推参数校验表通过/不通过Mock 支持是否提供 Mock 数据核心接口提供成功、失败、空数据、异常示例API 文档完成前端/测试可提前验证使用工具生成 Mock 或示例 JSON开发测试Mock 调用Mock 地址/JSON通过/不通过接口可测性是否可被自动化测试接口可通过 Postman、Apifox、JMeter 等工具调用测试环境或 Mock 可用核心接口具备自动化验证基础测试编写接口测试集合测试开发工具执行接口测试集合通过/不通过AI 编码适配是否可作为 AI 生成代码输入接口文档结构清晰可生成 Controller、DTO、Client、测试代码接口文档完成AI 生成代码无需二次猜测字段含义开发将接口文档输入 AI 生成代码初稿开发项目经理AI 输出审查AI 生成代码记录通过/不通过Sheet 4《节点3-单元测试质量》检查维度检查项具体质量标准准入条件准出条件操作步骤主责角色参与角色检查方式产物/证据结果单测范围是否覆盖核心业务逻辑核心服务、规则计算、状态流转、权限判断必须覆盖代码开发完成核心逻辑覆盖率达标开发根据 Spec 和业务规则编写单测开发测试代码检查单测代码通过/不通过覆盖率单测覆盖率是否达标行覆盖率建议 ≥ 70%核心模块 ≥ 80%关键方法必须覆盖单测可运行覆盖率报告达标执行覆盖率工具如 JaCoCo、Coverage.py开发项目经理工具检查覆盖率报告通过/不通过用例完整性是否覆盖正常场景每个核心方法至少覆盖一个正常路径单测框架已配置正常路径全部通过基于验收标准设计单测开发测试单测执行单测报告通过/不通过异常场景是否覆盖异常输入空值、非法值、越界、无权限、状态不合法等场景有测试异常规则明确异常断言明确使用 AI 生成异常测试用例开发复核开发测试单测执行异常用例通过/不通过边界场景是否覆盖边界值最小值、最大值、临界状态、空集合、大集合等有测试字段规则明确边界断言通过根据字段约束生成边界用例开发测试单测执行边界用例通过/不通过断言质量是否有有效断言禁止只调用不断言断言必须验证关键输出、状态或异常单测已编写无无效单测Review 单测断言开发测试Code ReviewReview 记录通过/不通过Mock 使用外部依赖是否 Mock数据库、第三方服务、消息队列、远程接口应 Mock 或隔离依赖清单明确单测可独立稳定运行使用 Mock 框架隔离外部依赖开发测试单测执行Mock 配置通过/不通过可重复执行单测是否稳定连续执行 3 次均通过不依赖执行顺序、不依赖脏数据单测环境可用无随机失败CI 或本地重复执行开发项目经理CI 检查CI 报告通过/不通过AI 生成代码审查AI 生成代码是否经过人工审查AI 生成代码必须进行逻辑、安全、性能、边界检查AI 参与编码审查问题已关闭开发提交 AI 代码审查清单开发项目经理Code Review审查记录通过/不通过静态扫描是否通过静态代码检查无阻塞级问题无高危安全漏洞无明显重复代码代码提交完成静态扫描通过执行 SonarQube、Lint 等工具开发项目经理工具扫描扫描报告通过/不通过提测门禁是否满足提测条件单测通过率 100%覆盖率达标无 P0/P1 缺陷开发自测完成允许提交测试开发填写提测单并附报告开发测试、项目经理提测审核提测单通过/不通过Sheet 5《节点4-冒烟测试质量》检查维度检查项具体质量标准准入条件准出条件操作步骤主责角色参与角色检查方式产物/证据结果提测准入是否满足提测条件代码合并完成、部署成功、单测通过、接口文档更新开发提交提测单测试确认可测测试检查提测材料测试开发、项目经理提测单检查提测单通过/不通过环境可用测试环境是否可用服务正常启动数据库、缓存、队列、第三方依赖可用部署完成环境无阻塞问题测试执行环境健康检查测试开发环境检查环境检查记录通过/不通过核心链路是否覆盖主流程覆盖用户登录、核心业务新增/查询/修改/提交/审批等主链路环境可用核心链路全部通过测试执行冒烟用例测试产品、开发手工/自动化执行冒烟测试报告通过/不通过接口冒烟核心接口是否可调用核心接口返回正常响应结构符合文档接口服务启动核心接口全部通过使用 Apifox/Postman 执行接口集合测试开发工具执行接口冒烟报告通过/不通过页面冒烟页面是否可访问和操作核心页面无白屏、无阻塞 JS 错误、按钮和表单可用前端部署完成核心页面操作通过测试访问核心页面并操作测试开发手工检查页面截图/录屏通过/不通过权限冒烟基础权限是否正确不同角色只能访问授权功能和数据测试账号准备完成权限无重大问题使用不同角色账号执行冒烟测试产品用例执行权限测试记录通过/不通过数据正确性关键数据是否落库正确新增、修改、状态流转、金额、数量等关键数据正确主流程可执行数据与预期一致测试通过页面/API/数据库校验测试开发数据核对数据验证记录通过/不通过异常提示基础异常提示是否正确必填、格式错误、权限不足、数据不存在有明确提示主流程通过无明显错误提示或空白提示测试执行基础异常操作测试产品手工测试异常截图通过/不通过缺陷级别是否存在阻塞缺陷不允许存在 P0/P1 缺陷P2 需评估是否影响继续测试冒烟执行中阻塞缺陷清零测试记录缺陷开发修复测试开发、项目经理缺陷评审缺陷单通过/不通过冒烟结论是否允许进入系统测试冒烟通过率 100%无阻塞问题冒烟执行完成允许进入正式测试测试出具冒烟结论测试项目经理报告确认冒烟测试报告通过/不通过Sheet 6《问题跟踪与整改》问题编号所属节点问题描述问题等级发现人责任人发现日期计划解决日期实际解决日期当前状态解决方案验证人验证结果备注Q-001需求 Spec 质量需求中“优化查询效率”无明确指标P1开发产品经理2025/01/012025/01/02待处理补充响应时间指标如 2 秒内返回测试待验证Q-002接口文档和接口质量查询接口缺少分页参数说明P2测试开发2025/01/012025/01/02待处理补充分页字段 pageNo/pageSize/total测试待验证Q-003单元测试质量核心价格计算方法无边界测试P1测试开发2025/01/012025/01/02待处理增加最大值、最小值、折扣为空等用例测试待验证Q-004冒烟测试质量提交审批后状态未更新P0测试开发2025/01/012025/01/01修复中排查状态流转逻辑测试待验证角色视角检查表项目经理角色检查表质量节点项目经理关注点必做动作准入检查准出确认质量标准需求 Spec 质量范围、计划、交付边界组织需求评审确认需求是否可进入开发客户需求或合同范围明确Spec 评审通过遗留问题有负责人和时间无 P0/P1 需求疑问接口文档和接口质量联调风险、跨端协作确认接口评审是否完成Spec 已冻结或基线化接口文档通过评审接口变更可追踪单元测试质量开发提测质量检查单测报告、覆盖率报告、静态扫描报告代码开发完成单测通过率 100%覆盖率达标不允许无报告提测冒烟测试质量是否允许进入正式测试跟踪冒烟缺陷关闭情况提测材料完整冒烟通过无 P0/P1不通过则打回开发产品经理角色检查表质量节点产品经理关注点必做动作准入检查准出确认质量标准需求 Spec 质量需求清晰、完整、可验收编写 Spec、验收标准、业务规则原始需求明确开发和测试无重大理解偏差每个功能都有验收标准接口文档和接口质量接口是否符合业务语义参与接口评审确认字段和业务含义Spec 已通过关键字段、状态、错误提示符合业务不得与业务规则冲突单元测试质量核心业务规则是否被覆盖协助确认核心规则测试点业务规则已明确核心规则有测试覆盖关键规则不遗漏冒烟测试质量主流程是否符合验收预期参与核心链路验收冒烟环境可用主流程符合产品预期核心业务可正常流转开发角色检查表质量节点开发关注点必做动作准入检查准出确认质量标准需求 Spec 质量是否可开发、无歧义评审需求提出技术疑问Spec 初稿完成技术疑问关闭不带疑问进入编码接口文档和接口质量接口可实现、可联调编写接口文档、Mock、错误码Spec 通过接口文档评审通过字段、参数、响应、错误码完整单元测试质量代码正确性和稳定性编写单测、执行覆盖率、静态扫描代码完成单测和扫描通过单测通过率 100%覆盖率达标冒烟测试质量缺陷快速修复支持测试环境和问题定位提测完成冒烟问题关闭P0/P1 必须当天响应测试角色检查表质量节点测试关注点必做动作准入检查准出确认质量标准需求 Spec 质量需求是否可测试评审 Spec补充异常和边界场景Spec 初稿完成测试疑问关闭每个需求可设计测试用例接口文档和接口质量接口是否可测检查接口参数、响应、错误码、Mock接口文档初稿完成可编写接口测试接口无明显缺字段单元测试质量是否达到提测质量检查单测报告和核心场景覆盖开发提交报告允许提测关键逻辑有单测覆盖冒烟测试质量是否允许进入正式测试执行冒烟用例输出报告测试环境可用冒烟通过核心链路 100% 通过推荐 Excel 字段下拉值结果字段字段可选值结果通过 / 不通过 / 不适用 / 待确认问题等级等级说明P0阻塞交付或主流程不可用P1严重影响核心功能或存在重大理解偏差P2一般问题不阻塞主流程P3优化建议或轻微问题当前状态状态说明待处理问题已发现但未开始处理处理中责任人正在处理待验证已修复等待验证已关闭验证通过挂起暂不处理需说明原因四个节点统一准入准出汇总质量节点准入准出需求 Spec 质量有原始需求、客户输入、合同范围或会议纪要Spec 评审通过需求清晰、完整、可测试、可用于 AI 编码接口文档和接口质量需求 Spec 已通过或基线化API 文档完整Mock/错误码/权限/异常/字段说明清晰单元测试质量代码开发完成接口设计明确单测通过率 100%覆盖率达标静态扫描无阻塞问题冒烟测试质量提测单完整部署成功开发自测完成核心链路通过无 P0/P1 缺陷可进入正式测试