发布说明草稿技能
将变更日志扫描输出转化为结构清晰、分类明确的发布说明草稿,并标记重要变更与安全问题。
证据显示技能仅提议草案、不自动发布,工作流也标注人工审核,权限最小化。但缺少对敏感数据处理、回滚机制及依赖安全的明确说明;发布者未验证。扣分因数据流透明度和回滚不完整。
技能仅指示遵循外部Grok技能的精确结构,但未提供本地实现或脚本;依赖外部未经验证的服务,不可复现。错误处理与异常输入反馈缺失。扣分因关键路径无法从文件独立验证,依赖外部来源。
适用场景明确(从changelog-scan输出生成发布说明草稿),但未声明能力边界、非适用场景及触发条件;环境适配信息不足,如中文支持和大陆网络可达性。扣分因边界和触发条件不清晰。
有清晰的名称和简短描述,有MIT许可证,但缺少安装说明、维护责任、版本记录、示例和FAQ;依赖外部Grok技能未详细说明。扣分因文档层级不完整,缺少故障排除和治理。
技能目标明确,但未提供可验证的输出样例;完整性依赖外部技能,直接可用性未证实。扣分因缺少输出验证和对比基准,静态评估无法确认边际价值。
技能自身无测试或执行证据;依赖外部Grok技能,仓库有CI但未覆盖此技能关键路径。扣分因无第三方执行证据,静态评估无法独立复现。
- 技能依赖外部未经验证的Grok技能,核心功能可能无法在断网或大陆网络环境使用。
- 缺乏安装和运行说明,用户难以独立复现;建议补充详细文档和示例。
- 未明确数据流和敏感信息处理,使用前应审查输出内容,避免泄露。
这个 Skill 能做什么,适合哪些场景?
该技能将来自 changelog-scan 的原始输出整理为结构化的发布说明草稿。它遵循 Grok 的 draft-release-notes 技能定义的严格结构和规则。输出为 RELEASE_NOTES_DRAFT.md 文件或清晰的章节,供循环流程持久化。技能会在顶部显著标记破坏性变更和安全问题,最后添加人工审核说明。它专为循环工程工作流设计,用于自动化生成发布说明草稿。
读取来自 changelog-scan 的输入,并应用预定义的结构和规则对其进行分类和格式化。生成名为 RELEASE_NOTES_DRAFT.md 的干净草稿或可持久化的清晰章节。在文档开头突出显示破坏性变更和安全问题。在文档末尾添加人工审核说明。仅提出草案,不直接进行写入或修改。
- 项目维护者希望在发布前快速将变更日志转换为草稿发布说明。
- 运行循环工程的开发者,想要自动生成发布说明草稿作为每周循环的一部分。
- 使用 Grok、Claude Code 或 Codex 的团队,希望为发布说明草稿建立一致的格式。
- 任何需要草稿发布说明但保留人工审核和批准权限的人。
这个 Skill 有哪些优点和局限?
- 通过自动化格式化节省时间。
- 确保发布说明结构一致。
- 标记破坏性变更和安全问题,降低遗漏风险。
- 设计为仅提出建议,减少意外更改。
- 与循环工程工作流无缝集成。
- 需要 changelog-scan 输出作为输入;并非独立技能。
- 格式可能不完全匹配自定义发布流程。
- 仅生成草稿;需要人工审查和编辑。
- 没有内置测试或验证。
- 仅适用于 changelog 格式良好的标准项目。
如何安装这个 Skill?
将技能文件夹(starters/changelog-drafter/.claude/skills/draft-release-notes/)复制到您的 Agent Skills 目录(例如,Claude Code 的 ~/.claude/skills/ 或项目的 .claude/skills/)。或者,通过运行 npx @cobusgreyling/loop-init . --pattern changelog-drafter 安装整个循环工程集合。有关确切安装步骤,请参阅仓库文档。
如何使用这个 Skill?
提供来自 changelog-scan 的 changelog 输出作为输入。技能将生成一个结构化的 RELEASE_NOTES_DRAFT.md 文件或包含的建议部分。在应用之前,始终查看并编辑草稿。使用示例提示:“根据此变更日志草拟发布说明:[粘贴 changelog]”。确保 changelog-scan 已在同一循环中运行。