SuperAPI AI 工具集

ce-pr-description

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:为当前分支的提交或指定 PR 撰写或重新生成标题与正文,标题采用 conventional-commit 格式(type: description 或 type(scope): description,72 字符以内),正文遵循价值优先原则。

主要能力:解析自由输入,识别 PR 引用(完整 URL、pr:<编号>、#编号或纯数字)或默认描述当前分支;支持 base:<ref> 显式指定基线(仅当前分支模式);返回 {title, body_file},body_file 为含正文 markdown 的临时文件绝对路径,正文不作为返回值内联输出。

使用方式:当前分支模式依据 base:<ref>、现有 PR 的 baseRefName、origin/HEAD 的顺序确定基线;PR 模式通过 gh pr view 获取 PR 信息,同仓库走本地 git 路径,跨仓库走 API 路径。调用方自行读取 body_file 并决定是否用 gh pr edit 或 gh pr create 应用。

适用场景:分离出统一的 PR 描述撰写逻辑,供 ce-pr-stack 按层批量调用、ce-commit-push-pr 在全流程与刷新模式中调用;也支持强调基准测试、性能等聚焦提示。

限制:不发起交互式确认,不切换分支,不提供对比确认叙述,不自动应用 gh 命令;PR 非 OPEN 状态时优雅退出且无输出;基线无法本地解析时需先 fetch;证据区块仅在已有 PR 正文含 ## Demo 或 ## Screenshots 时保留,本技能不提示用户采集证据;文档、CI、测试或纯内部重构等场景无法提供证据。输出上限约 100 行,硬上限约 150 行,大型 PR 更需取舍而非堆砌内容。