用途:为 Epicenter 仓库撰写和审阅拉取请求(PR)的标题与正文,包括变更日志和合并细节。仅用于创建 PR 或编辑其文本;若只是暂存、拆分或提交本地更改,应使用 git;若涉及 issue 分类或公开回复,应使用 github-issues。
主要能力:帮助解释变更为何存在、为何采用该形式。正文先简述改了什么,再展开 diff 无法提供的推理:变更起因、方案适配原因、重要后果或权衡。可用代码展示行为、图表揭示关系、表格呈现对比,并给每个视觉元素足够上下文。正文形态与长度由变更决定:小修复可能只需两句话,所有权变更可能需要图表与理由,破坏性 API 变更需给出新旧用法与迁移指引。
使用方式:起草前阅读最终 diff 和受影响的调用方,识别主要变更及其原因,核对示例与实现是否一致,区分已证实行为与预期收益,证据不足时不编造理由。面向未跟进讨论的读者写作,保持合并后仍有用;最终范围变化时重写标题与正文。标题使用与提交相同的 conventional commit 格式。公共 API、CLI、HTTP、配置或类型签名变更需附代码示例;破坏性变更需给出新旧示例。仅 feat: 和 fix: 且用户可见变更的 PR 才添加 ## Changelog 章节。
硬性规则:除非用户明确要求,不得包含 ## Summary、## Changes、## Testing、## Test Plan 或 ## Verification 章节;命令、测试与验证缺口写在聊天最终回复而非 PR 正文;不列出变更文件;不包含 AI 或工具署名。
限制:资料未提供具体安装命令、收费或平台信息。参考文件(body-patterns.md、visual-patterns.md、examples.md、changelog-entries.md、github-pr-operations.md)按需加载。