AIOX @qa质量代理详解：10阶段结构化代码审查是怎么做的
AIOX qa质量代理详解10阶段结构化代码审查是怎么做的【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-coreAIOXSynkra AIOS的qa 质量代理代号 Quinn守护者原型是专职的测试架构师与质量顾问。本文带你拆解它的核心能力——一套10 阶段结构化代码审查流程从自动扫描自愈到风险分级、质量门Quality Gate四态决策让 AI 代码审查既有章法又可追溯。先认识 qaAI 团队里的质量守门人在 AIOX 的多代理协作体系中dev 负责写代码po 负责需求而qa 负责把最后一道关。它的工作特点可以概括为 8 条核心原则原则一句话解释 按需深入风险高就深挖低风险就保持简洁 需求可追溯每条验收标准AC都要映射到测试Given-When-Then⚖️ 风险驱动按概率 × 影响给测试排优先级️ 质量属性验证检查安全、性能、可靠性等非功能需求NFR 门治理只给明确结论PASS / CONCERNS / FAIL / WAIVED且必须带理由 咨询式卓越用文档教育团队从不无故阻断流程 CodeRabbit 集成用自动化审查尽早暴露问题它的完整定义位于.aiox-core/development/agents/qa.md官方流程文档见 qa-system.md。10 阶段结构化审查全景一览当 dev 把 story 标记为 Review或用户手动执行*review {story}命令后审查引擎就会按下面 10 个阶段顺序推进#阶段名称关键动作0自动自愈CodeRabbit Self-Healing自动扫描 最多 3 轮自动修复0b智能分析代码智能参考影响评估改动波及了多少消费方文件1风险定级风险评估决定后续审查的深度2深度体检综合六维分析追溯、质量、架构、NFR、可测性、债务3主动修复积极重构安全处直接重构代码并解释原因4规范核对标准合规检查对照编码规范与项目结构5验收核验验收标准验证逐条 AC 确认实现完整6文档审阅文档与注释检查API 变更、复杂逻辑注释7落盘输出QA Results 生命周期流转原子写入 story 文件8质量门Gate File 四态决策生成可审计的 YAML 门文件整套流程的总剧本就是.aiox-core/development/tasks/qa-review-story.md这个任务文件。下面逐段拆解。阶段 0CodeRabbit 自动扫描 自愈循环审查还没开始机器先巡逻一遍运行 CodeRabbit CLI对比 main 分支的已提交变更按严重度分级CRITICAL / HIGH / MEDIUM / LOW发现 CRITICAL 或 HIGH 问题 →自动尝试修复最多 3 轮迭代3 轮后仍有高危问题 → 质量门直接判FAIL强制人工介入MEDIUM 问题不阻断自动登记为技术债务tech debt工单。 这种自愈设计的好处把机械性问题交给机器反复磨把人的注意力留给真正需要判断的地方。单轮超时上限 30 分钟总时长约 90 分钟封顶。阶段 0b代码智能参考影响可选如果项目配置了代码智能Code Intelligence提供者qa 会调用.aiox-core/core/code-intel/helpers/qa-helper.js中的getReferenceImpact(files)生成一张影响面表格每个被修改文件有多少个消费方文件会受影响消费方超过 10 个的文件会自动升级审查深度若代码智能不可用则静默跳过不影响后续流程。阶段 1风险评估决定审查深度qa 不是一刀切地审每一行代码。满足以下任一信号会自动升级为深度审查 改动了认证、支付、安全相关文件 story 没有新增任何测试 diff 超过500 行 上一次质量门是 FAIL / CONCERNS story 有 5 条以上验收标准风险评分会写入门文件任意风险分≥ 9 直接 FAIL≥ 6 记 CONCERNS。阶段 2六维综合分析这是整个审查最重的一环覆盖 6 个维度维度检查内容A. 需求可追溯性每条 AC 是否都有对应测试用 Given-When-Then 记录映射关系B. 代码质量架构设计、重复代码、性能隐患、安全漏洞C. 测试架构单测/集成/E2E 分层是否合理、Mock 使用、边界场景覆盖D. 非功能需求安全、性能、可靠性、可维护性四项逐一打分E. 可测试性输入可控吗输出可观测吗失败好调试吗F. 技术债务捷径、缺失测试、过期依赖、架构违规阶段 3~6不只是挑刺还能直接动手很多静态审查工具只能发现问题而 qa 的定位是测试架构师——它被授权在安全的前提下直接重构代码阶段 3 积极重构动手改安全范围内的代码跑测试确认不破坏功能并在 QA Results 中写清楚为什么改、怎么改阶段 4 合规检查逐条对照编码规范、项目结构、测试策略文档阶段 5 验收核验确认每条 AC 完整实现边界用例已覆盖阶段 6 文档审阅复杂逻辑缺注释就补上API 变更必须同步文档。⚠️ 注意边界qa 只能更新 story 文件中的 QA Results 区块和状态流转无权修改 File List 等其他章节也禁止git push/git commit这些权限只属于 github-devops。职责隔离正是这套体系可靠的原因。阶段 7~8QA Results 落盘与质量门四态决策审查结论最终以双产物形式持久化且协议是fail-closed的写盘 回读校验全部通过才允许交接产物 1QA Results写回 story 文件包含代码质量评估、重构清单、合规核对表、安全与性能结论并执行状态流转PASS/CONCERNS/WAIVED →InReview → DoneFAIL →InReview → InProgress。产物 2质量门文件YAML由.aiox-core/development/templates/qa-gate-tmpl.yaml渲染保存到docs/qa/gates/目录包含决策理由、质量评分、NFR 逐项状态、修复建议与责任人dev/sm/po默认 2 周过期。质量门四态决策速查决策触发条件后续流向✅PASS全部 AC 满足无高危问题覆盖率达标devops 推送CONCERNS存在非阻断问题已登记追踪知情放行FAIL有高危问题或 AC 未满足dev 执行*apply-qa-fixes修复WAIVED问题被明确豁免需批准人 理由po 关闭 story质量评分算法很直观质量分 100 − 20×FAIL数 − 10×CONCERNS数介于 0~100 之间。QA Loop审查-修复自动闭环单次审查不是终点。.aiox-core/development/workflows/qa-loop.yaml定义了自动化循环Reviewqa 执行完整审查并给出判定Fix Request若 REJECT生成QA_FIX_REQUEST.md交接给 devApply Fixesdev 修复后标记 Ready for Re-reviewRe-reviewqa 重新审查最多 5 轮迭代超限则升级人工处理。APPROVE 即完成BLOCKED 则直接升级——循环始终有明确出口。关键文件路径导航想深入源码或自行调整配置这些路径值得收藏完整任务剧本.aiox-core/development/tasks/qa-review-story.md质量门任务.aiox-core/development/tasks/qa-gate.md风险矩阵.aiox-core/development/tasks/qa-risk-profile.mdNFR 评估.aiox-core/development/tasks/qa-nfr-assess.md测试设计.aiox-core/development/tasks/qa-test-design.md需求追溯.aiox-core/development/tasks/qa-trace-requirements.mdQA 循环编排.aiox-core/development/workflows/qa-loop.yaml全局配置覆盖率目标 80%、质量分下限 70 等.aiox-core/core-config.yaml流程文档docs/zh/aiox-agent-flows/qa-system.md总结这套 10 阶段流程好在哪可预期每次审查走完全相同的路径没有看心情审查 可追溯门文件记录决策理由、评审修订号、证据清单随时可审计 可自愈机械问题机器 3 轮内消化MEDIUM 问题自动进技术债务 有边界QA 只改该改的权限最小化FAIL 必回炉PASS 必放行。对于想引入 AI 代码审查的团队AIOX 的 qa 提供了一个很好的范本先用流程约束 AI再让 AI 释放效率。【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考