SuperAPI AI 工具集

changelog-orchestrator

部署与运维

查看项目

更新于 10-15 22:42

技能介绍

用途:将原始仓库活动(已合并的 PR、issue、commit,可选 Slack 更新)转化为可发布的变更日志草稿,并准备分支/PR 供审查。

主要能力:读取仓库根目录的 .changelog-config.json 配置;用 validate_config.py 校验配置;确定日期范围;加载配置的 Markdown 模板(或回退到 assets/weekly-template.md);用 render_template.py 渲染最终 Markdown;确保 frontmatter 至少包含 date(ISO)和 version(SemVer,未知则 0.0.0);用 quality_score.py 运行确定性检查;若分数低于阈值则按配置处理;将变更日志写入配置的 output_path;创建分支 changelog-YYYY-MM-DD,并以 docs: add changelog for YYYY-MM-DD 提交;若配置了 gh 则打开 PR,否则打印用户应运行的命令。

前置条件:目标仓库需有 .changelog-config.json;需设置必需环境变量(至少 GitHub 来源需要 GITHUB_TOKEN);PATH 中需有 Git,gh 可选(若配置用于创建 PR)。

输出:Markdown 变更日志草稿(通常为 CHANGELOG.md),以及可选的 PR URL;来自 quality_score.py 的质量报告(分数与发现)。

限制与更多信息:错误处理见 references/errors.md,示例见 references/examples.md,详细实现指南见 references/implementation.md。默认模板包括 assets/default-changelog.md、assets/weekly-template.md、assets/release-template.md。