用途:pi-github 是 pi 的扩展,提供 /gh-* 命令(也支持 /github-* 变体)用于常见 GitHub 操作,并为智能体工作流提供 PR 审查线程处理工具。
前提:需安装并认证 gh CLI;仓库范围命令需在 git 仓库中运行,或显式指定仓库。
主要命令:/gh-prs 列出打开的 PR(可加 mine 或 review-requested);/gh-issues 列出打开的 Issue(可加 mine 或 label:name);/gh-status 显示仓库仪表盘(PR、Issue、CI、分支 PR);/gh-actions 查看最近工作流运行;/gh-notifications 查看未读通知;/gh-pr-create 用 LLM 生成摘要创建 PR;/gh-pr-review 查看 PR 审查反馈;/gh-pr-fix 修复未解决的审查线程;/gh-pr-merge 合并 PR 并完整清理,支持 --squash、--merge、--rebase。
智能体工具:github_review_thread_reply 回复审查线程;github_resolve_review_thread 将线程标记为已解决(每次修复后必须调用);github_post_pr_comment 发布 PR 摘要评论。这些工具底层使用 gh CLI,无需 API token,优先于原始 REST/GraphQL 调用。
仓库引用语法:支持 GitHub URL、owner/repo#N、repo#N(配合默认 owner)、owner/repo、纯数字,无参数时从当前分支自动检测。可在 settings.json 中设置默认 owner,例如 {"pi-github": {"defaultOwner": "espennilsen"}}。
详细工作流参考文档:references/pr-fix.md(修复审查反馈)、references/pr-fix-parallel.md(并行修复多个 PR)、references/pr-merge.md(合并与清理)、references/pr-create.md(创建 PR)。
约定:默认合并策略为 squash;发布标签使用 v<semver>;结构化输出使用 --json 加 --jq;功能分支始终使用 worktree,不在主目录执行 git checkout。
限制:依赖 gh CLI 及其认证状态;未提供收费、价格或平台支持等更多信息。