pr-ready 用于在提交拉取请求前做最后准备。触发场景包括用户说“ready for PR”“open a PR”“prepare for review”,完成实现阶段后,或运行 diff-review 之前;实际代码审查应使用 diff-review,而非本技能。执行模型为主智能体直接运行,因为需要终端访问(git、CI)、编辑文件(changelog)和用户交互(确认 PR 标题),输出为在 GitHub 上已打开或待打开的 PR。工作流共八步:验证分支状态,确认不在 main 上并检查未提交与未推送提交,若存在未提交更改需询问用户是否先提交;运行所有检查,读取 AGENTS.md 或 Makefile 中的检查命令,按 lint、typecheck、test、build 顺序执行,失败时询问是否先运行 fix-ci;分析相对目标分支的 diff,统计并分类变更(源码、测试、文档、配置、依赖);检查文档影响,基于 git 做轻量验证,源码变更、公共 API 变更或新增模块时标记,报告但不阻塞,写入 PR 描述的“Documentation Impact”;若存在 CHANGELOG.md,则更新 [Unreleased] 分区,按 Added/Changed/Fixed/Removed 归类;生成 PR 描述,包括摘要、变更类型复选框、变更列表、文档影响、测试和检查清单,若项目有 .github/pull_request_template.md 则沿用;根据 diff 建议 GitHub 标签,由文件路径、提交前缀和改动规模推导;最后询问用户确认标题与目标分支,预览或直接创建,命令为 gh pr create --title "<title>" --body-file /tmp/pr-body.md --label "<labels>"。规则要求:绝不推送到 main,只操作功能分支;始终先运行本地检查;使用项目现有 PR 模板;changelog 仅在项目已有该文件时更新,不新建;创建 PR 前必须获得用户确认;不使用内置 explore 子代理。
pr-ready
编程与开发
更新于 10-15 21:42