用途:为内部开发团队生成有趣、易读的更新日志,汇总主分支最近的合并内容,突出新功能、缺陷修复并致谢开发者。
主要能力与用法:接受可选参数 daily、weekly 或天数时间范围;默认取主分支最近一天变更。daily 查看过去 24 小时合并的 PR,weekly 查看过去 7 天,标题需注明周期。使用 gh CLI 查询 PR 及其描述,检查 PR 标签判断类型,识别并置顶破坏性变更,包含 PR 编号、关联 issue 上下文与贡献者姓名。
内容优先级:破坏性变更置顶,其次用户可见功能、关键修复、性能改进、开发者体验、文档更新。分组呈现相似变更,代码与技术术语用反引号,PR 编号放入括号。输出格式需置于 <change_log> 标签内,包含标题、破坏性变更、新功能、缺陷修复、其它改进、致谢与每日趣事,整体控制在 2000 字符内以适配 Discord,并保持俏皮语气、节制使用 emoji、各分区使用一致 emoji。必要时附部署说明,如数据库迁移、环境变量更新、手动步骤与依赖更新。最后依据 EVERY_WRITE_STYLE.md 逐项复查风格,可并行使用多个 agent 加速。
发布与异常处理:可设置 DISCORD_WEBHOOK_URL 并用 curl 发送:curl -H "Content-Type: application/json" -d "{"content": "{{CHANGELOG}}"}" $DISCORD_WEBHOOK_URL。无变更时发送安静日提示;无法获取 PR 详情时列出 PR 编号供人工复核;发布前校验长度。
适用场景:建议每日纽约时间早 6 点生成前一日变更,周一生成上周摘要,重大发布或部署后特别生成;可按频道调整语气与详细程度。
限制:需具备 GitHub PR 与 gh CLI 数据获取条件,Discord 发布需自备 webhook;官方未提供更多收费、平台或效果信息。