一、前言:AI代码审查的行业痛点:

在传统电商项目开发中,代码审查(Code Review)是保障软件质量的核心环节,但存在三大痛点:人力成本高(资深工程师需投入30%以上时间)、覆盖度不足(人工难以发现隐蔽的并发问题或安全漏洞)、反馈延迟(跨时区协作导致审查周期长达数天)。JiuwenSwarm凭借Agent Team实现了多智能体自主分工、高效沟通与无缝协作Coordination Engineering,完成了从“单兵作战”到“精锐团队”的关键跨越,可实现自动化、高精度、实时化的代码审查。其核心价值在于:将工程师从重复劳动中解放,聚焦于架构设计与业务逻辑优化。


1.1 传统单Agent代码审查的固有缺陷:

在智能化研发运维体系普及的当下,AI代码审查已成为企业保障代码质量、规避线上风险的核心手段。目前绝大多数企业采用单Agent流水线审查模式,依托单一通用大模型完成架构校验、安全扫描、代码规范检测、逻辑漏洞排查等全部审查工作。该模式部署简单、成本低廉,适配小型单体项目,但在中大型分布式项目、复杂业务系统中暴露的问题愈发突出。

单Agent核心痛点集中在上下文稀释问题,单一模型需要同时兼顾多维度审查指标,注意力资源被大量分散,无法对细分领域进行深度研判。从工程实践数据来看,单Agent审查模式下,复杂业务代码漏洞漏检率高达32%,架构不合理问题识别率不足65%,代码风格统一整改完成率仅71%。除此之外,单Agent还存在任务串行执行耗时久、专项专业度不足、问题归因模糊、整改建议通用性过强等缺陷,无法满足企业精细化代码管控要求。

同时,传统人工代码审查依赖资深研发人员经验,存在审查标准不统一、主观偏差大、人力成本高、审查效率低等问题,尤其在高频迭代的敏捷开发流程中,人工审查难以覆盖全部代码变更,极易埋下技术债务与安全隐患。


二、JiuwenSwarm相关介绍:

JiuwenSwarm(集群/蜂群)将分散的工具与能力整合为高度协同、智能涌现的智能体工程,让多个AI智能体如蜂群般高效协作、自主演进,迈向「群体智能」的 AI Agent时代。JiuwenSwarm是 openJiuwen 社区推出的「多智能体协同框架 / 运行时」,用来把一堆 AI 智能体(Agent)组织成 “蜂群式团队”,解决单智能体干不了、干不稳、不可复用的复杂任务。

2.1 如何安装呢?

# 安装 JiuwenSwarm
pip install jiuwenswarm

# 初始化 JiuwenSwarm (首次启动)
jiuwenswarm-init

# 启动 JiuwenSwarm
jiuwenswarm-start

# 安装 JiuwenSwarm-tui
pip install jiuwenswarm-tui

# 启动 JiuwenSwarm-tui
jiuwenswarm-tui

这里更推荐使用桌面版本,直接使用exe安装程序进行安装,非常的方便,小白也会进行安装:

在这里插入图片描述
安装完成后,我们通过5173端口启动JiuwenSwarm服务:

在这里插入图片描述


2.2 创建wrokspace代码仓库代码:

接下来我们可以配置一个大模型,也是比较简单的,这里我们使用qwen3.6-plus 模型,是阿里 2026-04-02 发布的闭源商用旗舰大模型,主打100 万超长上下文 + Agentic Coding(智能体编程)+ 多模态增强 + 极低定价。

在这里插入图片描述

首先我们在工作台中新建一个项目目录data,里面放我们最近开发的鸿蒙代码animal code,接下来我们就用这个项目来测试JiuwenSwarm多Agent Team交叉审查模式,通过任务拆分、并行审查、交叉校验、结果聚合的工作流程,彻底解决单Agent审查短板。

在这里插入图片描述

接下来可以通过打开Swarm Skills Hub,用来专门JiuwenSwarm管理、分发、共享、复用AI 技能(Skills),让团队所有人 / 所有智能体都能一键安装、统一版本、沉淀最佳实践。

请添加图片描述

可以找一下"开发编程"板块中,找到一个适合的"代码评审专业组"的Skill,来使用一下。

请添加图片描述

接下来我们在JiuwenSwarm中的"技能"选项卡中,可以直接搜索"代码评审专业组",找到类似的Skill,点击安装,安装成功后,我们就可以在JiuwenSwarm中看到这个技能,然后就可以开始使用这个技能了。

在这里插入图片描述

在这里插入图片描述

可以看到本地技能列表中,我们可以在工作区看到skills 目录下,可以查看到这个技能,然后就可以开始使用这个技能了。

在这里插入图片描述


2.3 多Agent交叉代码审查实战:

接下来,我们首先切换到"集群"模式,直接输入我们想要任务内容:

帮我使用代码评审专业组,分析一下 data 下面的 animal 项目,帮我找出一些缺陷和 bug,并给出一些建议

在这里插入图片描述

首先,JiuwenSwarm在分析时,list_files 工具执行失败,无法列出里面的文件animal 项目:

在这里插入图片描述

紧接着,JiuwenSwarm会自动调用glob 工具成功定位到了项目文件:

/root/.jiuwenclaw/agent/jiuwenclaw_workspace/data/animal/animal/.idea/modules/animal.iml

这次只匹配到了 1 个文件,是 .idea/modules/animal.iml,这是 IntelliJ IDEA 的项目配置文件,说明你的 animal 项目大概率是一个 Java 项目(或 Kotlin/Scala 等 JVM 项目)。

在这里插入图片描述

team_leader 已经判断出项目类型已识别,这是一个 HarmonyOS(鸿蒙)项目并且正在做预处理,比如:

  • 排除 IDE 文件、构建缓存、签名文件等非源码内容
  • 只保留 .ets/.ts/.json 等核心源码文件
  • 识别到项目规模:约 60+ 个源代码文件

在这里插入图片描述

在这里插入图片描述

角色 视角 核心关注方向
Code Reviewer(绿色) 乐观正向视角 基础正确性 bug、代码可读性、ArkTS 规范、测试覆盖率缺口、代码风格问题
Adversarial Critic(红色) 悲观对抗视角 异常场景失败案例、安全风险、隐藏假设、边界漏洞、未来潜在痛点
Architect(紫色) 系统级视角 模块边界合理性、接口契约变更、跨模块依赖冲突、架构设计缺陷

评审团队已经组建完成,三个角色正在并行评审你的鸿蒙项目,进入了「交叉评审」的关键阶段,项目覆盖范围全部 60+ 个 .ets 源码文件,后续输出会把三方评审结果整合,生成分级报告:

  • MUST-FIX:必须立刻修复的致命缺陷(崩溃、安全漏洞、严重功能错误)
  • SHOULD-FIX:建议修复的高优先级问题(性能、可维护性、兼容性)
  • FYI:仅供参考的优化建议(风格、最佳实践)

在这里插入图片描述

  • create_task:创建了评审总任务
  • spawn_member:生成了另外两个评审智能体,和 team_leader 组成三人评审组

在这里插入图片描述

任务名称 认领角色 评审方向
code-review code-reviewer 基础正确性、ArkTS 规范、可读性、测试缺口
adversarial-review adversarial-critic 异常场景、安全风险、边界漏洞
architect-review architect 架构设计、模块边界、依赖冲突

三个任务完全并行执行,无依赖关系,不用等待某个角色完成,效率很高,评审完成后,结果会写入 .team/ 工作空间的对应文件,team_leader 会统一整合输出最终报告

  • 给 code-reviewer 分配并确认任务状态
  • 给 adversarial-critic 分配并确认任务状态
  • architect 也已认领 architect-review 任务

在这里插入图片描述

🔴 P0 致命缺陷(必须立刻修复)

这是最高优先级问题,不修复会直接导致安全风险或核心功能失效。

密码明文存储(安全漏洞)

  • 问题位置StorageService.ets:220-232, 261, 373, 894-900
  • 问题描述:用户密码(包括“记住密码”功能)直接以明文形式存储在 preferences 中,无任何加密处理。
  • 风险:一旦设备被 root/越狱,用户密码会直接泄露,严重违反数据安全规范。
  • 修复建议
    1. 改用 AES 对称加密 存储密码,密钥用鸿蒙的 Huks 硬件安全模块保护。
    2. “记住密码”功能只存储 refreshToken,不要存原始密码。
    3. 用鸿蒙的 DataAbility 或加密数据库替代 preferences 存储敏感数据。

🟠 P1 高优先级缺陷(必须修复)

预约流程不完整(功能缺陷)

  • 问题位置ServiceBookingPage.ets:413-448
  • 问题描述handleConfirm() 方法只弹出了 AlertDialog,但没有创建 ServiceOrder 订单实例,导致用户提交预约后,后台没有生成任何订单数据。
  • 风险:用户操作无反馈、无数据,预约功能完全失效。
  • 修复建议
    1. 弹窗确认后,调用 ServiceOrderService.createOrder() 生成订单。
    2. 增加订单创建成功/失败的回调处理,给用户明确提示。
    3. 补充异常分支:网络失败、参数校验失败时的错误处理。

在这里插入图片描述

team_leader 已经完成了任务看板审查,任务结构与依赖:任务结构完整,依赖链正确,无需调整或额外指派,完成情况:5 个评审任务中,3 个已完成,2 个正在执行,整体进度符合预期。

任务名称 状态 负责成员
review-module-core ✅ completed code-reviewer
review-module-training-food ✅ completed code-reviewer
review-module-service-community ✅ completed architect
review-module-pet-health ⏳ claimed adversarial-critic
review-module-home-framework ⏳ claimed adversarial-critic
integrate-review-results ⏳ blocked 等待前置任务完成

已完成的评审:

  • code-reviewer 已经完成了核心模块和宠物训练/食物模块的代码评审,重点关注了正确性、可读性、ArkTS 规范和测试缺口。
  • architect 完成了社区服务模块的架构评审,我们之前已经看到了他输出的 P0/P1 级缺陷报告。

正在执行的评审:

  • adversarial-critic 正在并行处理宠物健康模块和首页框架模块,他的视角是「悲观对抗视角」,会重点关注异常场景、安全风险、边界漏洞和未来潜在痛点。
  • 这两个任务完成后,integrate-review-results(整合评审结果)才会自动解锁执行。
  • 当 adversarial-critic 完成两个模块的评审后,team_leader 会自动执行 integrate-review-results,整合三个角色的所有评审结果。
  • 最终会输出一份完整的分级报告,包含 MUST-FIX / SHOULD-FIX / FYI 三个级别的问题,并解决不同角色之间的意见冲突。

在这里插入图片描述

在这里插入图片描述

预约流程不完整

  • 问题:ServiceBookingPage.handleConfirm()只弹了确认弹窗,没有创建 ServiceOrder订单实例,用户预约无数据。
  • 修复:弹窗确认后调用订单创建服务,补充成功/失败回调和异常处理。

积分系统竞态条件

  • 问题:addPoints()非原子操作,并发调用会导致积分丢失、数据不一致。
  • 修复:改用数据库事务/原子操作,或给积分操作加锁。

社区数据全局共享

  • 问题:帖子/评论用全局 key 存储,多用户场景下数据互相可见、可删除。
  • 修复:存储 key 加上 userId前缀,改用 Rdb 数据库做用户数据隔离。

God Object 问题(StorageService 1388 行)

  • 问题:StorageService承担了所有存储、业务逻辑,打破模块边界,难以维护和测试。
  • 修复:按业务拆分 UserStorage、OrderStorage、CommunityStorage等独立服务。

在这里插入图片描述

✅ 评审任务:实际已 100% 完成

虽然界面上 integrate-review-results 任务状态显示 pending,但 team_leader 明确说明:

任务状态显示 pending 是系统规则限制(只有成员能标记 completed,Leader 无法直接改状态),但实际交付物早已产出。

已完成的核心交付物

  1. 完整问题索引:54 条问题已按 文件+行号 精准索引,定位到具体代码位置。
  2. 严重问题共识升级:
    • 密码明文存储、API Key 硬编码这两个问题,已被所有角色共同上调为最高严重级别。
  3. 角色冲突暴露:3 个评审角色之间的意见冲突已全部暴露(后续可按需处理)。
  4. 分级分类完成:问题已按 MUST-FIX / SHOULD-FIX / FYI 三级分类,优先级清晰。
  5. 最终报告落地:完整评审报告已写入 .team/final-review-report.md 文件,可随时读取。

总结:

本次我们基于JiuwenSwarm多智能体协同框架,结合Swarm Skills Hub的“代码评审专业组”技能,对data目录下的鸿蒙(HarmonyOS)animal项目开展了全流程自动化代码审查,成功解决了传统代码审查人力成本高、覆盖度不足、反馈延迟的行业痛点,同时规避了单Agent审查上下文稀释、专业度不足的固有缺陷。
实战过程中,我们先完成JiuwenSwarm的安装配置,选用qwen3.6-plus模型,通过Swarm Skills Hub安装适配的代码评审技能,随后切换集群模式发起审查任务。框架自动定位项目路径、预处理源码(排除非核心文件),组建由Code Reviewer、Adversarial Critic、Architect组成的三角色评审团队,按不同视角并行开展交叉评审,覆盖项目全部60+个.ets源码文件。


参考资料:

仓库地址:https://atomgit.com/openJiuwen
官网地址:https://www.openjiuwen.com

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐