用途:这是一套 GitHub Issue 与 PR 评论的沟通准则,用于指导维护者回复 bug 报告、功能请求、PR 讨论或关闭 issue。目标是让评论简短、友好,并尊重报告者与维护者的时间。
主要能力:提供反模式清单(避免过度结构化、公式化开头、复述显而易见内容、企业式公告、过度解释已闭环修复);维护者尊重原则(最尊重的评论往往是最短且能清晰闭环的那条);评论压缩规则(先问读者需要知道或接下来做什么,只保留必要内容);标准结构(人性化确认、当前状态或直接回答、仅在必要时给出下一步、温暖收尾)。
使用方式:首次回复使用对方 GitHub 用户名问候,如“Hey @username, thank you for the issue”;持续往返可省略问候。修复类 issue 按顺序:感谢指出、说明当前状态、只在有助于验证时提及具体版本、发布、PR 或提交、简短致谢。复杂问题可主动提出一起调试,并附上 https://cal.com/epicenter/whispering;不要声称无法核实的可用时间。对投入较深的报告者可偶尔邀请加入 Discord,链接 https://go.epicenter.so/discord。可提出澄清问题,索要确切版本、平台和最小复现。收尾用感谢,如“Thanks again!”。
适用场景:回复 issue、答复 bug 报告、关闭 issue、PR 讨论等。PR 评论可更简短,进行中的讨论无需完整问候与收尾。语气与对方匹配:短问题短答,详细报告详细回复。
限制:仅覆盖写作与语气规范,未提供自动化工具、安装命令或平台集成方式;具体示例链接与外部服务地址以原文为准,其他功能与收费信息暂未提供。