用途:仅在用户明确要求完成从本地检出到发布的全流程时使用,包括按需建分支、暂存、提交、推送和创建拉取请求。
主要能力:本地 git 负责建分支、暂存、提交和推送;分支推送到远端后,优先使用本插件中的 GitHub 应用创建 PR;当连接器无法干净推断仓库或头分支时,用 gh 作为回退,用于发现当前分支 PR、检查认证或创建 PR。
前置条件:需要 GitHub CLI gh,先运行 gh --version,缺失则请用户安装并停止;需要已认证会话,运行 gh auth status,未认证则请用户运行 gh auth login 并重新检查;需要本地 git 仓库,并清楚哪些改动属于本次 PR。
命名约定:从 main/master/默认分支开始时,分支名为 codex/{description};提交信息为 {description}(简洁);PR 标题为 [codex] {description},概括完整 diff。
工作流:确认预期范围,运行 git status -sb 并在暂存前检查 diff;若工作区含无关改动,不要默认 git add -A,应询问用户哪些文件属于本次 PR;确定分支策略,在 main、master 或其他默认分支上创建 codex/{description},否则留在当前分支;只暂存预期改动,混合工作区优先使用明确文件路径,仅当用户确认整个工作区都在范围内时才用 git add -A;用确认的描述简洁提交;运行最相关的检查,若因缺少依赖或工具失败,安装所需内容后重跑一次;用 git push -u origin $(git branch --show-current) 推送并跟踪;创建草稿 PR,推送成功后优先用插件中的 GitHub 应用,从远端推导 repository_full_name(如规范化 git remote get-url origin 或 gh repo view --json nameWithOwner),从 git branch --show-current 推导 head_branch,从用户请求或远端默认分支推导 base_branch(如 gh repo view --json defaultBranchRef);若从 fork 推送或 PR 目标与刚推送的远端不同,优先用 gh pr create 回退,因为连接器 PR 创建流程预期单一仓库目标,可能无法干净表达跨仓库 head 语义;若连接器无法干净推断仓库或分支,回退到 gh pr create --draft --fill --head $(git branch --show-current);使用 CLI 回退时把 PR 正文写入临时文件并使用真实换行,以便 Markdown 正常渲染;最后总结分支名、提交、PR 目标、验证结果以及用户仍需确认的事项。
写入安全:绝不静默暂存无关的用户改动;工作区混合时未确认范围绝不推送;除非用户明确要求可评审的 PR,否则默认草稿 PR;若仓库似乎未连接到可访问的 GitHub 远端,停止并说明阻塞点,不要臆测。
PR 正文期望:使用真实 Markdown 散文,覆盖改了什么、为什么改、对用户或开发者的影响、修复类 PR 的根本原因,以及用于验证的检查。
限制:资料未提供收费、价格、平台支持范围或效果数据;该技能依赖 gh 与已认证会话,且需要可访问的 GitHub 远端。