工程开发
qc avatar

qc

自动化质量闸门,使用 5 个并行 AI 代理审查代码变更,确保正确性、风格与一致性。

简介

qc (Quality Gate) 技能是一个自动化的代码审查编排工具,专为软件工程团队设计,旨在维持高水平的代码质量。通过并行启动五个不同的 AI 代理,它能针对任何相对于主分支的 git diff 进行全面审计。这种多层面的方法确保了变更不仅具备功能性,且符合现有的架构模式与可维护性要求。

  • 并行代理架构:同时执行五个专门代理,涵盖代码审查、简化、一致性、健壮性与范围控制。

  • 自动化标准执行:验证代码命名、错误处理、无用代码删除以及是否遵循 DRY 原则。

  • 情境感知的审查:利用现有的代码库模式与文件层级情境,提供符合团队特定编程风格的相关反馈。

  • 回归预防:评估边界条件、API 合约稳定性及潜在的副作用,在提交最终确定前降低风险。

  • 工作流集成:以表格格式清晰呈现结果,包含通过/失败状态、可操作的问题清单,并支持快速迭代循环。

  • 输入要求:此工具需要 git diff 输出与任务描述,以便提供具针对性的反馈。

  • 最佳实践:针对超过 500 行的大型 diff,建议用户逐个文件执行工具以获得更高精确度。

  • 错误处理:如果代理返回无效的 JSON,该工具会执行一次自动重试,之后若仍失败则会报错。

  • 升级策略:若特定问题在三次修正尝试后仍然存在,系统会自动将该问题升级至人工处理。

  • 实现建议:适用于利用 git 工作流的环境,确保所有审查过的代码都符合项目逻辑,且具备可组合性与适当的隔离。

仓库统计

Star 数
148
Fork 数
14
Open Issue 数
18
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 16:34
在 GitHub 查看