用途:把「提交、推送、开 PR」串成一条工作流,并根据改动深度自适应生成 PR 标题与描述,强调价值优先。
主要能力:
- 三种模式:仅生成描述(只跑描述步骤并打印);更新已有 PR 描述(用 gh pr edit 预览确认后应用);完整工作流(按步骤提交、推送、创建 PR)。
- 分支与 PR 状态处理:先解析远端默认分支,识别 HEAD 游离、在默认分支且有改动、在默认分支无改动、功能分支等情况,并据此路由。
- 提交策略:按文件级别分组为 2-3 个逻辑提交,避免 git add -A 或 git add .;提交信息默认参考项目约定,无约定时采用 conventional commits,歧义时优先 fix:。
- 推送:使用 git push -u origin HEAD。
- 描述生成:组合 PR 标题与正文,并可询问是否捕获演示证据(可加载 ce-demo-reel,返回 Tier、Description、URL、Path,按 URL 或 Path 处理)。
- 应用方式:正文写入临时文件并用 --body-file 传入,禁止用 --body-file -、stdin 管道或 --body "$(cat ...)";新建 PR 用 gh pr create --title ... --body-file "$BODY_FILE",已有 PR 用 gh pr edit --title ... --body-file "$BODY_FILE"。
提问约定:需要询问用户时,优先使用平台阻塞式提问工具,如 Claude Code 的 AskUserQuestion、Codex 的 request_user_input、Gemini/Pi 的 ask_user;没有阻塞工具或调用出错时才在聊天中提问,不应静默跳过。
上下文获取:在非 Claude Code 平台运行 Context fallback 命令,依次输出 STATUS、DIFF、BRANCH、LOG、DEFAULT_BRANCH、PR_CHECK。
适用场景:用户说「commit and PR」或类似意思时;需要为 PR 编写或刷新描述时。
限制:在默认分支上不支持直接推送,需先创建功能分支;描述与证据捕获依赖仓库状态和可运行环境;演示证据在凭据不可用、付费服务、仅部署基础设施或硬件场景下可能无法生成。其他未提供细节暂未提供。