SuperAPI AI 工具集

create-pull-request

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

用途:为 agent-harness 活动项目中所选的仓库生成便于评审的 PR 草稿,并协助创建或更新 GitHub 拉取请求。

主要能力:分析 git 变更并输出分析 JSON;根据分支意图从 assets/templates/ 选择 PR 模板并生成 PR 正文;在展示或创建前运行质量检查;支持按用户指定语言生成 PR 标题与正文;保留 issue 引用,仅在 PR 目标为仓库默认分支时输出关闭关键字。

使用方式:先读取 .agents/harness/config/agent-harness.yaml,解析 active_projects 并检查相关项目配置。目标仓库按以下顺序确定:用户指定的仓库;当前文件所属且无歧义的仓库;活动上下文中唯一的仓库;否则询问用户。git 与 gh 命令需在目标仓库根目录执行,而非 agent-harness 仓库根目录。切换目录可使用 Push-Location / Pop-Location 或等效目录栈。在目标仓库运行 scripts/analyze_changes.py 生成分析 JSON,再运行 scripts/generate_pr_body.py,创建前运行 scripts/quality_checks.py。默认先出草稿并请求批准,除非用户明确要求立即创建。

限制与约束:除非 PR 有意针对 agent-harness 本身,否则不得对 agent-harness 仓库运行 git 或 gh。所有临时 PR 产物只能保存在本技能目录的 temp-files/ 下,生成的临时文件仅放在 agent-harness 的 .github/skills/create-pull-request/temp-files/。用户指定的输出语言对最终 PR 标题与正文具有约束力。完整工作流、PowerShell 示例与错误处理见 REFERENCE.md。