SuperAPI AI 工具集

pr-description-generator

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:为当前分支、指定分支、提交范围或未提交更改自动生成 PR 描述,也可用于生成变更日志和提交前审查。

主要能力:分析 git diff、提交历史与文件变更,输出摘要、变更文件列表、测试说明、破坏性变更和提交记录,支持人类可读、Markdown 和 JSON 三种格式。

用法:使用 node /job/.pi/skills/pr-description-generator/generate.js 生成当前分支描述;可加分支名与 main 比较;用 --from 与 --to 指定提交范围;用 --uncommitted 处理未提交更改;用 --markdown 输出 PR 正文;用 --json 供程序集成。可从仓库根目录运行。

适用场景:自动化 PR 创建流程、提交前审查代码变更、从提交生成变更日志,以及与其他技能(如会话文件、记忆代理)配合。

限制:需要包含提交的 Git 仓库;复杂语义摘要可能需要 LLM(当前使用模式匹配);无法通过静态分析检测运行时行为变化。建议提交信息写得清晰,以便生成更准确的摘要。