用途:面向 GitHub 开源贡献流程,帮助创建 Pull Request、Issue 与 Discussion,并在生成内容时结合真实改动而非仅凭提交信息或文件名。
主要能力:
- Pull Request:校验 git 状态与分支情况,读取 git diff base-branch...HEAD 做语义分析,生成标题与正文(可含 Summary、Test Plan 与 GitHub 提示块),支持指定 base 分支、reviewer、--draft 与 --test-plan。
- Issue:查找 .github/ISSUE_TEMPLATE/ 模板,按描述自动选择 bug、feature、docs、question 等类型并应用标签;支持 --check 搜索相似 issue。
- 特定仓库 Issue:针对 anthropics/claude-code 与 openai/codex 提供专门模板与环境信息收集(如 claude --version、codex --version、uname 等)。
- Discussion:通过 gh api graphql 获取仓库与分类,自动选择 Ideas、Q&A、General 等分类,并支持相似讨论搜索。
使用方式:先运行 gh auth status 确认已登录 github.com;未登录则运行 gh auth login。创建内容多用 gh pr create、gh issue create 配合 HEREDOC 传递多行正文;Discussion 走 GraphQL 查询与 createDiscussion 变更。
适用场景:向开源仓库提交 PR、报告或申请 issue,以及发起社区讨论。
限制:需要相应仓库写权限才能应用标签等操作;模板与分类取决于目标仓库配置;生成内容应遵循非正式、对话式语气,并优先理解改动意图与上下文。更多细节见各 references 文档。