它到底是什么

/commit-push-pr 不是 Claude Code 的核心内置命令，而是 Anthropic 官方维护的 "Commit Commands" 插件（plugins/commit-commands，位于 anthropics/claude-code 仓库）里打包的一条命令。该插件页面（claude.com/plugins/commit-commands）标注为 "Anthropic Verified"，声称有超过 171,000 次安装；.claude-plugin 配置显示插件版本 1.0.0，作者为 Anthropic（support@anthropic.com）。

官方命令参考页 code.claude.com/docs/en/commands 目前列出的是 /clear、/resume、/code-review、/init 等内置命令与 bundled skill/workflow，没有把 commit-push-pr 列入其中，说明它需要额外安装插件才能使用，不是开箱即用的功能。

值得注意的是：官方文档一度在 code.claude.com/docs/en/common-workflows 的 "Create pull requests" 一节中提到过一个 /commit-push-pr skill，并描述它能在配置了 Slack MCP 服务器后把 PR URL 推送到 CLAUDE.md 中指定的频道。但根据 GitHub Issue #29001（标题 "[DOCS] skill commit-push-pr not found"），有用户按文档尝试直接输入该 skill 时收到 "Unknown skill: commit-push-pr" 报错；该 issue 被标记 area:skills、documentation、stale，并以 "not planned" 关闭，没有附维护者说明。截至本文验证时间（2026-08-29）能访问到的 common-workflows 页面中，"Create pull requests" 一节已经不再包含对 /commit-push-pr 或 Slack 推送的描述；同时 claude.com/plugins/commit-commands 官方插件页与其镜像页均未提及任何 Slack 相关行为。因此本文不确认"配置 MCP 后自动发 Slack"这一说法在当前版本中真实存在，只如实呈现文档描述的变化过程。

怎么触发 / 怎么使用

1. 先安装插件

/plugin install commit-commands

2. 在有改动的仓库里运行

/commit-push-pr

命令对应的源文件 .claude/commands/commit-push-pr.md 显示其内部结构：

• allowed-tools 白名单：仅允许 git checkout --branch、git add、git status、git push、git commit、gh pr create
• 上下文注入：命令会先执行 !git status、!git diff HEAD、!git branch --show-current 把当前状态喂给 Claude
• 任务指令：
  1. 如果当前在 main 分支，先建一个新分支
  2. 生成一条提交信息并提交
  3. 推送该分支到 origin
  4. 用 gh pr create 开 PR
  5. 要求以上步骤在同一条消息里完成（允许多次工具调用）
  6. 不允许使用白名单外的工具，也不允许输出额外文字

保存 / 配置 / 集成

• 安装方式：/plugin install commit-commands（Anthropic 官方插件，claude.com/plugins/commit-commands）
• 前置条件：需要本机已装好 git，且 gh（GitHub CLI）已完成身份验证，仓库要配置好远程 origin
• 该插件同一 marketplace 下还带了 /commit（只生成提交，不推送/开 PR）和 /clean_gone（清理已在远程被删除的本地分支）两条命令

运行约束 / 限制

跟同类原语对比

经典使用场景

• 完成一次功能开发后，想用一条命令走完"提交 + 推送 + 开 PR"全流程，省去手动敲多条 git/gh 命令
• Anthropic 员工 Boris Cherny 在 Threads 上提到，他和团队把这类"每天要用很多次的内循环工作流"存成 .claude/commands/ 下的命令并纳入 git 版本管理，/commit-push-pr 就是他每天使用的其中一条

常见坑

1. 没装插件直接输入 /commit-push-pr 会报 "Unknown skill: commit-push-pr"——它是插件命令而非内置命令，需先执行 /plugin install commit-commands（对应 GitHub Issue #29001）
2. 不要假设它会自动把 PR URL 发到 Slack：这一行为曾出现在官方 common-workflows 文档描述中，但当前可访问版本已不含该描述，插件自身页面也未提及，真实性存疑
3. 依赖 gh pr create，如果 gh 未登录或者当前仓库没配置远程 origin，推送/开 PR 步骤会直接失败

来源

• commit-push-pr.md（anthropics/claude-code 仓库）
• Commit Commands 插件官方页面
• plugins/commit-commands 目录（anthropics/claude-code）
• GitHub Issue #29001："[DOCS] skill commit-push-pr not found"
• Boris Cherny（Threads）：slash commands 用于每天多次的内循环工作流
• 官方文档：Common workflows（code.claude.com）
• 官方文档：Commands 参考页（code.claude.com）
• Commit Commands 说明镜像页（claudekit.io）