SuperAPI AI 工具集

changelog

通用与其它

查看项目

更新于 10-16 06:49

技能介绍

用途:生成当前用户近期工作的 Markdown 变更日志,汇总合并/关闭的 GitHub PR 与关闭或参与过的 Linear 工单,按功能领域分组,套用 templates/changelog.md 模板后打印到聊天。

主要参数:days 为可选位置参数,控制天数窗口(缺省 7 天,含今天,UTC;传入非正整数报错);--scope=current|all(默认 current,仅限当前目录对应 GitHub 仓库,需 gh repo view 取仓库名;all 时按仓库分组);--audience=technical|general(默认 technical,general 面向非工程读者改用主题分组并去除术语)。

数据来源:PR 用 gh search prs --author=@me --state=closed --closed="${SINCE}..${UNTIL}" 查询,按 state 区分 merged 与 closed;Linear 通过已连接的 MCP 服务查询当前用户工单。gh 或 MCP 缺失时打印提示并只用另一数据源,不整体失败。结果数等于 LIMIT 时加截断警告。

分组规则:按优先级取 conventional-commit scope、Linear 项目名、标签、仓库名、顶层目录,无信号归入 Other。PR 关闭工单时合并为一条。功能桶按字母排序,Other 最后;桶内按关闭时间倒序。

输出:始终输出单个 Markdown 块,用四反引号外层围栏包裹;默认不写文件。空窗口渲染空状态文案,不编造工作。限制:--author=@me 不捕获 Co-authored-by;--scope=current 在非 GitHub 仓库报错而不回退。