GitCode 版本发布公告（Release Notes）

根据 GitCode API 拉取仓库在指定区间内的提交。脚本仅负责获取 commit 与简单过滤；你根据脚本输出的 JSON 总结、归类、润色并生成最终 release note，输出为 Markdown 格式，使阅读清晰、像人写的发布说明。

何时使用

• 用户表达「生成 release notes」「版本发布说明」「从 v1.0 到现在的更新日志」「从某日期到现在的提交记录」等意图。
• 必须在本次对话中提供 --repo owner/repo（必传）；可选提供 --branch、--from、--to、--since-date。

认证

GITCODE_TOKEN：按以下优先级读取。

• Linux/macOS：建议在 ~/.bashrc 或 ~/.zshrc 中 export GITCODE_TOKEN="..."。
• 未配置时：脚本报详细错误，提示到 GitCode 个人访问令牌 创建并设置环境变量。

路径约定

• 技能根目录（SKILL_ROOT）：本 SKILL.md 所在目录。脚本通过 __file__ 定位，不依赖当前工作目录。
• 支持 Linux / macOS / Windows；执行时使用脚本绝对路径。

固化流程

1. 解析参数：从用户输入或对话中提取 --repo（必传）、--branch、--from、--to、--since-date。
2. 调用脚本（输出 JSON）：

   python <SKILL_ROOT>/scripts/release_notes.py --repo owner/repo --json [--branch BRANCH] [--from TAG] [--to TAG] [--since-date YYYY-MM-DD]
   

   • 必须带 --json：脚本只做拉取与简单过滤，向 stdout 输出 JSON，不生成最终 Markdown。
   • 区间三选一：--since-date（从该日 00:00 上海时间至今）、--from（从某 tag 至今）、或 --from + --to（两 tag 之间）。
   • --branch 未传时：脚本依次尝试 master → develop → main，都不存在则报错并提示使用 --branch。
3. 读取 JSON：从 stdout 解析 JSON。若退出码非 0 或 stderr 有错误信息，向用户展示详细错误并结束。
4. 生成最终 release note：
   • 根据 JSON 中的 commits 做归类（新特性 / 修复 / 文档 / 其他）、总结（每条或每组用简要概括，不要直接贴 commit 原文）、润色（统一语言、合并同类、去掉无信息量项），生成干净、专业、可对外发布的 release note。
   • 按 「最终 release note 输出格式」 与 「撰写原则」 写出 Markdown（标题、四小节、每条仅写简要说明；不展示 commit 信息；不展示合并条数/测试/合规等无价值信息）。
   • 交付给用户（可保存为文件或粘贴到 GitCode Release）。
5. 禁止：不得在未得到脚本 JSON 前猜测或伪造数据；不得将 commit 列表原样当作最终 release note 交付，须经总结与润色后再交付。其余禁止事项见「禁止」一节。

脚本参数

• 区间约定：仅用 --since-date、或仅用 --from、或 --from + --to。若同时传多种，脚本按 --since-date > --from/--to 优先级处理。
• 本技能流程下须带 --json（以获取 JSON 供你总结）；不带 --json 时脚本会直接输出 Markdown，不经过本技能总结步骤。

脚本 --json 输出与你的职责

• 脚本：仅获取 commit 与简单过滤（排除空 message、纯 merge），向 stdout 输出 JSON；不做归类、不写总结。
• 你：从 stdout 解析 JSON，根据 commits 与 stats 做归类、简要概括、润色，按「最终 release note 输出格式」与「撰写原则」写出 Markdown；不得原样罗列 commit。

最终 release note 输出格式（须统一遵守）

生成 Markdown 时必须按以下格式；每条条目的简要说明根据 commit 进行归纳。