SuperAPI AI 工具集

changelog-draft

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:从指定发布区间内合并的 PR 生成可审阅的变更日志草稿,供 Slack、Notion 或应用内“What's New”使用。

主要能力:按 channel(stable、preview、dev)与 release_tag 推断上一发布切点,形成 previous_cut_tag..release_tag 区间;抓取 PR 并提取显式 CHANGELOG 标记;对未标记 PR 分类为 NEW-FEATURE、IMPROVEMENT、BUG-FIX、TUI、OZ 等;区分内外部贡献者与机器人;提取 feature flag 列表;获取 issue 报告者;输出 changelog-draft.md、changelog-draft.json,并用脚本生成 changelog-release.json。

使用方式:依次运行仓库内脚本,例如 python3 .agents/skills/changelog-draft/scripts/fetch_prs.py --repo "${GITHUB_REPOSITORY:-warpdotdev/warp}" --base-ref <previous_tag> --head-ref <release_tag>,以及 classify_contributors.py、extract_feature_flags.py、fetch_issue_reporters.py、convert_to_release_json.py。参数包括 channel、release_tag 必填,output_dir、attribution 可选。

适用场景:Warp 发布流程中自动整理公开变更日志,并保留审计信息。

限制:不得写入 channel_versions.json 或生产配置,不得推送提交、创建分支或 PR,输出仅写入 output_dir;CHANGELOG-NONE 的 PR 不得出现;internal_pr 仅用于审计,不能用于署名或用户可见链接;未知贡献者需保守处理并人工核验。