关于 re0-merge
re0-merge 是用于接纳贡献的评审技能,旨在保留贡献者署名并清晰呈现维护者修改。它指导协作者和维护者完成评估、批准、合并及致谢说明。
主要功能
- 01逐项评估贡献
- 02保留贡献者提交署名
- 03将维护者修改单独提交
- 04合并前批准
- 05附致谢说明后关闭 PR
适用场景
- 01依据项目目标评审 PR
- 02清晰标注署名并合入贡献
- 03拒绝变更并记录理由
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lilmgenius/ paperthin --skill re0-merge安装后在 Claude Code 中输入/re0-merge确认已加载。
详细介绍
让贡献者的贡献得到公正认可:保留署名,让维护者的修改清晰可见,并以正式记录接受贡献。
目标
贡献是一份礼物,却也带来永久的维护成本;评审要么兼顾这两点,要么辜负其中一点。re0-merge 会引导所有评审者——任何协作者或维护者,而不只是作者——按照本套件的方式接受拉取请求:以项目主张为准进行评判,合并时保留作者的署名,将维护者自己的修改作为独立提交保留,并以批准和致谢结束,而非悄无声息地拒绝。
工作流
- 合并前先把关。 默认拒绝增量式贡献;举证责任在新增内容一方,要证明没有它套件会更差,而不是由你来解释为什么不接受。逐个评审 PR,绝不打包评审:修复缺陷能消除问题,是最容易接受的;新增工具只有在能将已有的手动执行规则自动化时才有立足之地;新增技能只有在填补现有技能都无法覆盖的实际空缺时才能合并。理由充分的拒绝也是已交付的结果,并非失败。
- 先从头到尾阅读。 决定前,以全新的视角通读贡献(如果已安装,则使用
shower流程);作者看来清晰的名称或说法,陌生人未必能看懂。 - 验证,不要重复修复。 如果作者已经推送了修复,就用一次性回归用例验证,而不是重写;修复的功劳归作者。
- 接受时批准,然后在
land/pr-<n>分支上合并(只有真正的多 PR 批次才使用范围)。决定接受后,立即提交批准评审,再进行合并——这是对贡献者代码的判定,不是发布的收据;现在就批准(而非与之后的关闭操作捆绑),才能让已关闭但未合并的 PR 仍清楚地显示为已接受。然后接受每个贡献者提交,同时保留其作者署名(你成为提交者;使用re0-git清理提交消息),将每项维护者修改都作为单独提交添加,以清晰呈现功劳分配,最后快进合并到main。 - 完善新技能,不要原样合并。 确定合适的名称(普通实词或简洁缩写,不要晦涩生造词)、调用方式(由模型还是用户调用)和归属位置;然后在所有清单位置登记该技能(
plugin.json、根目录及每个本地化副本中的 README Index、re0-upgrade的 Current 目录、scripts/catalog.cjs),以免触发漂移检查。 - 确认发布版本中包含该贡献后,再用评论关闭 PR。 关闭 PR 时要同时发表评论,致谢并说明情况——绝不悄无声息地关闭,也绝不在发布合并前关闭。第 4 步中的批准已经记录了接受结果;这一步只负责关闭并解释。
- 评论要热情地致谢并说明情况。 在发布说明中注明 PR 编号和作者账号,公开致谢;如果你重命名或重新界定了内容,关闭评论要感谢作者、说明改了什么及原因、指出该内容随哪个版本发布,并将核心想法的功劳归还给作者。
规则
- 对新增内容默认拒绝,但要妥善说明拒绝理由:给出与项目主张相关的理由,保留分支,绝不悄无声息地关闭(将拒绝记录为语料)。
- 保留作者署名。贡献者为其提交署名;维护者的每项修改都作为独立提交,并署维护者之名。
- 接受时批准,并在合并前完成——不要拖到发布后与关闭操作捆绑。批准是对贡献者代码的判定,而不是对可能失败的发布的收据。任何拥有评审权限的协作者或维护者都可以这样做,不限定某位评审者。
- 解释对作者所做的每一处改动,并以维护作者利益为出发点。对于作者未要求的重命名或重新界定,要说明原因。
- 不依赖特定评审者,并能在能力不足时降级执行:运行已安装的流水线技能(
shower、re0-git、re0-release);未安装时,则手动完成相应步骤。
验证
完成前:
- 每项已合并的贡献都保留了作者署名,维护者的修改则作为单独的提交。
- PR 在关闭前已获批准,并附上署名致谢评论后关闭。
- 新技能已在所有名单页面上登记,检查均已通过。
- 每项拒绝都说明了与论点相关的原因,并保留其分支。
- 任何重命名或重新定位都已向作者说明。
评论
支持 Markdown