用途:git-api-pr 用于在不触碰本地 git 状态的情况下,通过 GitHub API 将文件改动提交为 PR。适合快速修复、拼写错误、配置或文档更新等 1-3 个文件的简单改动,以及希望避免本地提交、分支创建/切换的场景。
主要能力:解析文件路径与参数,校验输入;解析基础分支状态;根据标题自动生成分支名;为每个文件创建 blob;构建包含新增/更新/删除条目的 tree;创建 commit 与分支 ref;最后创建 PR,支持草稿、自定义基础分支、自定义分支名、删除文件等。
使用方式:命令形式为 /git:api-pr <文件...> --title <标题>,可选参数包括 --base、--branch、--body、--draft、--delete。执行依赖 gh CLI 与已认证的 GitHub 环境,通过 gh api 调用仓库、blob、tree、commit、refs 和 PR 接口。
适用场景:单文件或多文件快速修复、草稿 PR、自定义分支、删除废弃文件、非默认基础分支等。
限制:需要 --title;需要 gh auth 已登录;基础分支不存在或分支已存在时会报错;不适合复杂多文件重构、需要本地测试、pre-commit 钩子、部分暂存或交互式暂存的场景,这些应改用 /git:commit。具体收费、平台支持范围等资料暂未提供。