Umbraco skill reviewer 是面向技能市场维护者的审阅工具,用于把技能 PR 从“已打开”推进到“可合并”,流程为审阅、修复、验证、汇总。该工具属于维护者工具链,不随任何插件发布。它复用其他编写技能而非重复其内容:标准来自 umbraco-skill-author 的一致性检查清单,运行时证明来自 dotnet test 门禁(umbraco-reference-instance)和仓库根目录的 scripts/boot-check.mjs,评测来自 umbraco-skill-evaluator。
基本规则(由维护者确定):审阅与更新独立运行,发现问题直接修复并推送到 PR 分支;无法推送时,按 fix-and-push.md 的描述以拉取请求形式把修复提交到作者分支。发布汇总评论和设置标签无需事先询问,也不留建议性评论以免来回往复。只有在发现异常时才运行评测,异常信号列在 verify.md 中。标签仅作装饰,可自由替换为 for-ai-review、ai-review-done 和 ai-review-pending-edits。始终不批准、不请求修改、不合并,合并由人工完成。不得声称运行过实际未执行的检查,评论和报告中都一样,因为评论是人工判断是否合并的依据。
使用流程分四个阶段:1. 审阅技能,参考 review.md,在按 fix-and-push.md 设置的工作树中产出书面发现清单(格式见 review.md 末尾);2. 在 PR 分支上修复,参考 fix-and-push.md,以作者口吻在 PR 分支提交;3. 验证,参考 verify.md,得到校验、门禁和启动结果,仅在出现异常信号时运行评测;4. 推送并汇总,参考 fix-and-push.md 并使用 scripts/push-review.mjs,推送提交、发布一条汇总评论并切换标签。
处理多个 PR 时从 batch.md 开始:它用 scripts/review-queue.mjs 列出队列,用 scripts/setup-review-worktree.mjs 设置工作树,为每个 PR 运行一个审阅者,然后用 --follow-ups 完成此前已审阅的 PR。最后以表格报告,每个 PR 一行,列出 PR、技能、修复内容、验证内容,以及留给人工处理的事项(设计问题、无法修复的测试夹具、无法运行的检查及原因)。