用途:根据 GitCode API 拉取指定仓库在某一区间内的提交,由 AI 总结、归类、润色后生成可对外发布的 Markdown 版 Release Notes。适用于用户提出「生成 release notes」「版本发布说明」「从某 tag 到现在的更新日志」「从某日期到现在的提交记录」等需求。
主要能力:脚本只负责获取 commit 与简单过滤(排除空 message、纯 merge),以 JSON 输出到 stdout;归类、概括、润色与最终 Markdown 由 AI 完成。输出按固定小节顺序:新特性、修复、文档、其他更改,每类最多 10 条,条目只写简要说明,不展示 commit 哈希或链接。
使用方式:必须提供 --repo owner/repo;可选 --branch、--from、--to、--since-date。调用命令为 python <SKILL_ROOT>/scripts/release_notes.py --repo owner/repo --json [--branch BRANCH] [--from TAG] [--to TAG] [--since-date YYYY-MM-DD],本技能流程下必须带 --json。区间三选一:--since-date、仅 --from、或 --from + --to;同时传时按 --since-date > --from/--to 处理。未传 --branch 时依次尝试 master、develop、main。认证读取 GITCODE_TOKEN,优先级为进程环境变量、Windows 用户级、Windows 系统级;Linux/macOS 建议在 ~/.bashrc 或 ~/.zshrc 中 export GITCODE_TOKEN="..."。
限制:未配置 token 或未提供 --repo 时脚本报错;不得在未获得脚本 JSON 前猜测或伪造数据,不得原样罗列 commit,不得出现 commit 链接、ID 或 git 地址,不展示合并与依赖更新、测试用例、合规及内部细节。支持 Linux / macOS / Windows,脚本通过 file 定位,使用绝对路径执行。