SuperAPI AI 工具集

describe-pr

编程与开发

查看项目

更新于 10-16 03:15

技能介绍

用途:按仓库标准模板生成完整的 Pull Request 描述,并可直接更新到 GitHub 上的 PR。

主要能力:读取 thoughts/shared/pr_description.md 模板;识别当前分支关联的 PR 或列出开放 PR 供选择;检查并更新已有描述文件 thoughts/shared/prs/{number}_description.md;收集 PR 差异、提交历史、基础分支与元数据;可选聚合 .git/claude/commits/*/reasoning.md 推理记录,生成“Approaches Tried”章节;分析变更、识别破坏性变更与迁移需求;处理模板中“How to verify it”清单,能运行的命令会执行并勾选,失败或需人工测试的保留未勾选并说明。

使用方式:依赖 gh CLI。常用命令包括 gh pr view --json url,number,title,state、gh pr list --limit 10 --json number,title,headRefName,author、gh pr diff {number}、gh pr view {number} --json commits、gh pr edit {number} --body-file thoughts/shared/prs/{number}_description.md。若报无默认远程仓库,需先运行 gh repo set-default。

适用场景:需要统一 PR 描述格式、补充验证记录或整理变更理由的仓库协作流程。

限制:需先存在 thoughts/shared/pr_description.md 模板,否则会提示用户创建;推理记录聚合依赖 .claude/scripts/aggregate-reasoning.sh 与相关文件存在;人工测试类验证步骤无法自动完成,需用户自行确认。