用途:为当前分支相对 main 的代码变更生成变更日志条目,并同步到文档站点。
主要流程:先执行 git log main..HEAD --oneline 与 git diff main..HEAD --stat 了解变更;在根目录 CHANGELOG.md 的 ## Unreleased 下按前缀表添加条目;若变更涉及 packages/ 或 sdks/ 下的子包,需同时更新该子包 CHANGELOG.md,并使用其自有前缀规则。随后运行 node docs/scripts/sync-changelog.mjs 同步英文文档,在 docs/zh/release-notes/changelog.md 的 ## 未发布 下手写中文对应内容,使用全角冒号,术语遵循 docs/AGENTS.md。若含破坏性变更,需在 docs/en/release-notes/breaking-changes.md 与中文对应文件的相应章节下补充 Affected/受影响 与 Migration/迁移 小节。
条目格式:- <Prefix>: <动词开头的独立可读句子> — <可选理由/前后对比/迁移说明>。首句须独立可读;每条只写一个变更;避免分号、also、and 或嵌套破折号;以 Fix、Add、Switch、Bump 等动词开头;仅写用户可感知的内容,不写内部重构、测试或 CI 调整,Lib: 除外。
前缀列表:Shell、Web、Vis、CLI、ACP、Core、Tool、Skill、MCP、Plugin、LLM、Kosong、Wire、Auth、Config、Lib、Build,不得自创;不确定时参考同类既有条目。排序:同一版本内按前缀表顺序分组,组内顺序随意。
Highlights:从下一版本起,在每个版本标题下添加 Highlights: …(1–3 条最受关注内容),中文镜像为 亮点:…;仅内部或 Lib: 的版本跳过;亮点为摘要,被提及条目仍需保留完整 bullet;不回填历史版本。
限制:未提供具体脚本行为、错误处理、依赖或平台要求等细节。