SuperAPI AI 工具集

av-cli

编程与开发

查看项目

更新于 10-15 17:22

技能介绍

用途:av 是 Aviator 提供的命令行工具,用于在 av 初始化过的仓库中处理堆叠 PR(stacked PR)工作流,也可用于普通单 PR 流程。仓库是否已初始化,可通过 git rev-parse --git-common-dir 后检查 <git-common-dir>/av/av.db 是否存在来判断;若不存在需询问用户是否执行 av init。

主要能力:av 可创建与管理堆叠分支,av commit 提交时自动 restack 子分支,av pr 自动推送分支并创建/更新 PR、自动设置正确的父分支为 base,av sync 完成 fetch、rebase 与推送,av restack 仅本地 rebase。还提供 av branch、av adopt、av reparent、av orphan、av switch、av next、av prev、av diff 等分支与导航操作。

关键用法:堆叠结构以 git common dir 下的 av/av.db 为准(用 cat 读取,不要用 Read 工具,也不要手动修改,不要用 av tree 判断结构)。非交互场景需使用带等号的参数,如 av sync --push=yes --prune=yes、av pr --title "..." --body "..."。不要直接用 git commit 或 git push,改用 av commit、av pr、av sync;不要用 gh pr edit --body 更新 av 管理的 PR,以免破坏元数据块;不要使用 av pr --edit。av sync 可能耗时 15-30 秒以上,建议超时至少 60 秒。

适用场景:多层功能开发(如 DB、服务、API、UI 各一层)、多人协作拉取远程分支(av adopt --remote)、PR 合并后清理(av sync --all --push=no --prune=yes,推送前应先询问用户)。

限制:av split-commit 与 av reorder 没有非交互模式;提交信息与 PR 内容中不要提及堆叠位置或父子关系;展示 PR 信息时应使用 av.db 中的完整 permalink URL。具体命令细节可运行 av <command> --help 或 man av-<command> 查看。