用途:根据项目里程碑或已发布的 Release,生成面向用户的更新日志或发布说明文案。适用于用户请求里程碑说明、发布说明等场景。
主要能力:先读取 docs/issue-tracker.md 获取远程操作方式与仓库品牌语气指引;区分两类来源——规划中的里程碑(解析一个 provider 里程碑并列出其 issue,回答交付阶段包含什么)与已发布 Release(获取一个 provider Release,按适配器解析其 #N 或 PAT-N issue 引用,创建或更新对应发布说明,回答实际发布了什么)。抓取全部关联 issue 并处理分页,纳入理解用户影响所需的 issue 描述;排除仅内部的工作,除非其显著改变用户体验或用户明确要求工程变更日志;将保留条目归入 New、Improved、Fixed、Breaking,省略空分组;将条目改写为简洁的用户成果,避免暴露实现细节、内部路径或私有上下文的 issue 标题。
使用方式:解析请求的项目里程碑或 Release,目标不明确时拒绝处理;里程碑返回 Markdown 供审阅;Release 先呈现草稿,获得发布授权后通过适配器保存为追踪器发布说明;最后报告来源标识、issue 数量、省略的内部条目数,以及创建或更新的发布说明链接(若存在)。
限制:不得用里程碑作为已发布的证明,不得通过遍历 forge 事件时间线重建已发布内容;Release Please 继续负责提交级 CHANGELOG.md,本技能负责 issue 级的里程碑与 Release 摘要;不得仅因 issue 已完成就声称某条目已发布。具体适配器、命令与配置细节暂未提供。