SuperAPI AI 工具集

qtbug-upstream-fixer

通用与其它

查看项目

更新于 10-16 09:48

技能介绍

用途:处理 Qt 上游 Jira 缺陷(如 QTBUG-146018、AUTOSUITE-123)并准备提交到 codereview.qt-project.org 的 Gerrit 补丁,使用 git review 提交。不适用于仅下游的 Deepin 缺陷、Debian CVE 或一般 Qt 构建清理。

主要能力与流程:技能隔离运行,不调用其他技能;允许工具为 Bash、Read、Write、Edit、Agent(仅子代理)、WebFetch、WebSearch、LSP、TodoWrite。流程分阶段:配置、扫描、worktree、修复、验证、提交。扫描最近两年内的 issue(created >= -2y),支持按模块或 issue 详情查看。克隆使用 SSH 地址 ssh://USER@codereview.qt-project.org:29418/<路径>,可用 --single-branch 减少历史。修复只针对报告缺陷,不重构、不做附带清理。提交前需要用户确认,非 dry-run 提交不得擅自执行。

必要配置:Jira API v3 已废弃旧版 GET /search,必须使用 POST /rest/api/3/search/jql(JSON body)。需设置 QTBUG_JIRA_USER、QTBUG_JIRA_TOKEN、QTBUG_GERRIT_USER;首次执行 ssh-keyscan -t rsa -p 29418 codereview.qt-project.org >> ~/.ssh/known_hosts。可复制 config.env.example 为 config.env 填写,脚本会自动加载。

常用命令:python3 scripts/check_env.py 检查环境;python3 scripts/scan_qtbug.py --limit 20 --format table 扫描;python3 scripts/qtbug_worktree_manager.py 管理仓库与 worktree;git review 推送。

限制与排查:Jira 返回 0 条记录时检查凭据与 Token 是否过期;HTTP 410 Gone 说明需改用 POST 接口;Host key verification failed 需运行 ssh-keyscan;No '.gitreview' file found 需在 worktree 中创建 .gitreview 并将远程重命名为 gerrit。需避开大型重构、复杂硬件或环境依赖的 issue。具体收费、平台等信息暂未提供。