真正有用的是一套共同发布语言
Agent 协同实现可以很快,但仓库仍需要人能读懂的用户影响记录。Keep a Changelog 与语义化版本提供了成熟的共同语言:把新增、变更、移除、修复和安全工作分开,再判断这次发布应该是 major、minor 还是 patch。
1.0.0 实际包含什么
Changelog Generator 把这套约定写进一个 SKILL.md。它要求 Agent 在缺少 Changelog 时初始化文件、给已完成工作分类、建议版本并更新包版本。公开仓库实际只有这份指令和 README,没有可执行脚本、解析器、测试夹具或输出校验器。
指令与保证之间还有距离
首版没有强制在写入前读取真实 Git diff、比较当前标签或检查脏工作区,也默认所有 package.json 都应该获得同一版本,这对独立版本的 Monorepo 可能是错误的。因此,一个表达流畅的 Agent 仍可能生成看似合理但并不准确的发布记录,或修改无关包。
更安全的第二版
- 起草前检查工作区、暂存差异、最新标签和现有 Changelog。
- 把仓库证据与对话上下文明确分开。
- 修改版本前取得明确确认。
- 处理锁文件、独立版本包和非 Node 清单。
- 校验生成分区,并加入可重复测试夹具。
仓库事实同样重要
README 目前写着 MIT,但仓库没有 LICENSE 文件,GitHub 也无法识别许可证。在法律文件补齐前,我只会称它为源码公开,而不会称为开源。1.0.0 的真实价值是一套紧凑的工作约定;可靠自动化是下一阶段产品目标,而不是应该被追认的现成功能。
