SuperAPI AI 工具集

qodo-agent-session-review

编程与开发

查看项目

更新于 11-13 19:34

技能介绍

用途

Qodo Agent Session Review 是一个面向代码审阅的交互式工具技能,帮助审阅者理解变更并做出决策。它强调在逐文件查看之前,先把多个 PR 串联成一个有证据支撑的故事线,使审阅者先掌握用户旅程、变更前后行为、范围与规格差异、依赖关系和关键决策,再进入细节。

主要能力

  • 将多个 PR 连接为统一的审阅会话,支持跨仓库工作包。
  • 汇总 Qodo 发现项及其准确的已审阅 SHA 与完整性信息,并与审阅者自己的本地判断分开呈现。
  • 结合变更代码行及周边代码、已发布作者备注、关联工单与规格、相关依赖等只读证据进行梳理。
  • 通过 enrich 与 plan 命令补充和校验证据,识别不受支持的声明与缺失证据。
  • 启动本地浏览器界面供审阅者查看和操作,笔记与标记保存在本地,导出生成独立的本地文件。

使用方式

前置条件为 Python 3.9 或更高版本、Qodo CLI 2.0.0 或更高版本,并对目标仓库具备受管审阅读取权限,且已完成认证连接。无需安装 gh、提供商令牌、克隆私有 Agent Session Review 或下载运行时。

启动脚本为 python3 -B "<skill>/scripts/launch.py",其会按顺序检查 Python、CLI 版本、已认证身份和可读目录。也可直接使用等效的 CLI 探测命令,例如 qodo --version、qodo read whoami --json 等。所有受管读取(包括身份查询)都通过 qodo read 进行,不以 gh 或直连供应商 HTTP 替代。

典型流程包括:用 collect-only 收集 PR 引用并记录会话 ID 与数据位置;检查来源身份、分页与覆盖警告及当前 HEAD;只读研究变更与证据;构建故事线;用 enrich 校验;用 plan 生成计划;用 serve 启动本地界面并由审阅者驱动浏览器。刷新可能改变源 HEAD,需重新检查完整性并修订过期内容,同时保留审阅者已保存的本地工作。

适用场景

适合需要系统理解跨仓库变更包、将多个 PR 合并审阅、并在浏览界面中依据证据做决策的代码审阅工作。也适用于需要将 Qodo 发现项与本地审阅判断清晰区分的场景。

限制

本地笔记和标记不会发布评论、批准 PR、解决供应商线程或更改 Qodo 发现项处置。导出只生成本地文件,分享是单独动作。缺少或拒绝的证据应视为未知,不能当作空或干净的审阅。只应在状态完成、review_complete=true 且匹配当前 HEAD 证据时才认定 Qodo 审阅完成。打包代码不可修改,不应手工编辑 review-data.json、打包应用资源或渲染页面。仅在使用明确授权且可用时才使用宿主浏览器控制,不能仅凭生成成功声称视觉验收通过。安装、更新、迁移或更改别名根目录等恢复操作不得未经授权覆盖。其他事实如具体收费、价格或效果暂未提供。