开发与工程 changelog-generationgit-historyrelease-notescommit-scanningpr-labels

变更日志扫描技能

扫描已合并的PR和提交,将变更分类,并为起草发布说明生成结构化草稿。

FollowSkills 评估 · FSRS-2.0
不推荐
45/ 100 五分制 2.3 / 5
1 2 3 4 5 6
1信任安全13 / 25 · 2.6/5

技能本身仅读取 git 历史并生成草稿,无网络外发或文件外写,权限最小;明确要求未经人工批准不得发布或打 tag,符合安全原则。但未提及敏感信息处理、依赖安全或回滚,数据流透明度有限。仓库有 SECURITY.md 但技能文件未引用。

2可靠稳定6 / 20 · 1.5/5

技能步骤基本自洽,命令示例明确,但未提供错误处理或异常输入反馈,失败时无明确说明。依赖 git 命令,但技能文件未提供安装或依赖说明。静默分析,无法验证实际执行,故得分受限于静态评估上限。

3适用触发8 / 15 · 2.7/5

技能面向 changelog 草拟场景,目标明确,但未声明不适用范围或边界条件;触发方式由用户调用,但精确触发条件未说明。环境适配未知,未涉及中文支持或海外服务依赖,但在国内可用性未证实。

4规范维护10 / 15 · 3.3/5

有清晰的 front matter 和分类,结构基本合理;但缺少安装/依赖说明、示例、FAQ、已知限制、版本化、变更日志和维护责任。MIT 许可明确,但技能文件未提及许可或归因。

5有效结果5 / 15 · 1.7/5

能产生分类草稿并更新状态文件,但未提供格式规范或示例输出,无法确认直接可用性。相对手动起草的优势未说明,静态评估无法验证实际结果。

6证据核验3 / 10 · 1.5/5

仅有 SKILL.md 和仓库级 CI,未含针对技能本身的测试或第三方执行证据。仓库有 CI 工作流,但未覆盖此技能。静态评估,证据有限。

证据充分度: 评估于 2026年8月7日 审查版本 c57170dbf93f
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 技能未明确说明敏感信息(如 PR 中的密钥)如何处理,草拟时可能不慎包含敏感内容。
  • 错误处理缺失,git 命令失败或标签不存在时无明确失败信息。
  • 未提供安装或运行依赖说明,可能影响实际使用。
  • 缺乏版本化、变更日志和维护责任披露,长期可维护性不确定。
  • 仓库功能可能依赖海外服务,但技能本身无网络依赖,国内可达性未证实。
评估证据 [1][2][3][4][5][6][7]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

此技能自动扫描自指定标签以来的合并PR和提交,提取标题、标签、类型和信号。它将变更分类为功能、缺陷修复、文档、依赖、破坏性变更和安全类别。输出是一份分类的草稿发布说明,保存到RELEASE_NOTES_DRAFT.md,并更新一个状态文件。设计为只能创建草稿(L1级别),未经明确的人类批准,它不会创建PR、发布或打标签。

运行git log --merges --oneline <last-tag>..HEAD来获取合并提交。收集PR标签、里程碑和提交消息。将变更分类为预定义类别。写出RELEASE_NOTES_DRAFT.md,其中包含分类的草稿,并更新changelog-drafter-state.md,包含扫描窗口信息。确保破坏性变更和安全项目突出显示。

  1. 希望在发布前快速生成最新合并更改摘要的维护者。
  2. 开发者需要根据与上个标签以来的git历史自动构建草稿发布说明。
  3. 团队希望按类别(功能、缺陷修复等)组织发布说明,以简化发布公告。
  4. 维护者需要为每周发布提前准备草稿,并跟踪扫描范围以供审核。

这个 Skill 有哪些优点和局限?

优点
  • 自动提取已合并的PR和提交,减少手动工作。
  • 通过标准类别提供结构化输出,便于组织。
  • 设计为L1草稿,安全且不会意外发布或打标签。
  • 更新状态文件以跟踪扫描范围,利于审核。
局限
  • 未指定如何集成PR标签或里程碑(仅描述,未提供具体命令)。
  • 没有任何记录在案的测试套件或验证的代理平台(除了作为示例的OpenCode)。
  • 示例旨在用于OpenCode,但其他代理可能需要调整。
  • 未描述如何处理无标签、无里程碑的仓库;依赖提交消息可能不一致。

如何安装这个 Skill?

将该仓库克隆或复制到您的环境中,并将技能文件夹(starters/changelog-drafter-opencode/skills/changelog-scan/)放置在您的代理技能目录中。对于这个多技能仓库,请参阅README了解整个集合的安装说明;此特定技能没有单独的安装说明。

如何使用这个 Skill?

在您的代理中调用技能,并指定最后标签(例如:'从v1.2.0扫描变更日志')。该技能将运行git命令并生成草稿。草稿将位于RELEASE_NOTES_DRAFT.md;检查并手动完善。除非明确获得批准,否则不会发布标签或创建PR。

常见问题

这个技能是否会自动发布或打标签?
不会。规则明确指出,未经明确的人类批准,绝不发布或打标签,并且该技能仅限于L1草稿——没有PR或标签。
它使用什么命令扫描变更?
它使用git log --merges --oneline <last-tag>..HEAD,并考虑PR标签、里程碑和自上次标签以来的提交消息。
它在哪里输出草稿?
它写入RELEASE_NOTES_DRAFT.md以存储分类的草稿,并更新changelog-drafter-state.md以记录扫描窗口。
它是否适用于任何Git仓库?
它需要是一个Git仓库,具有标签和合并历史。它假设存在标签;对于没有标签的仓库,需要手动定义参考点。

同仓库的其他 Skills

均来自 cobusgreyling/loop-engineering

相关 Skills