用途与范围
本技能用于评审 Slate 仓库(ianstormtaylor/slate)的 PR,以及 udecode/plate 中 baseRefName 为 main 的 PR。它以 next 分支上的 Plate v2(含 Plite)为参照,把 v2 已有的研究、代码与测试证据带到 PR 上,逐条证明问题,并交回一份 GitHub 评论草稿。基于 next 分支的 PR 以及任何 PR 修复工作不在本技能范围内,按 Babysit 手册处理。与 Babysit 的仅评审路径类似,本次运行不保留计划、页面或决策日志;其运行目录 docs/plans/artifacts/<date>-<repo>-<number>-review/ 被 git 忽略,用于存放 diff、探测测试和草稿。
主要流程
-
读取 PR:用 gh pr view 获取标题、作者、正文、基分支、head SHA、文件、评论、评审与关联 issue,保存 gh pr diff,运行 gh pr checks,并逐个读取关联 issue;完整阅读每个改动过的源文件,正文声明(含其声明的限制)都视为待验证的声明。
-
收集 Plate v2 证据:用 rg --hidden 检索,按若干线索记录 v2 的决定、被否决的方案及原因与路径,包括提及(issue 与 PR 编号、Slate issue 的裸编号、pnpm kb 标签测试)、准则(VISION.md 及 plite.md 或 plate.md)、决策与主题(docs/plans/topics/ 与 markdown-editing-spec.md 的结论段与备选表)、代码与文档(packages/plitejs 或 packages/platejs 中同一职责的实现、测试与 content/docs 教程页)。若 v2 对该问题没有相关记录,评论中应直接说明,而不是借用邻近决策。
-
在 PR head 上证明发现:每个发现都是一个带探测的失败声明,即一个断言正确行为、在 head SHA 上失败的测试。探测在新建临时目录的 detached worktree 中运行,不在克隆自身的检出目录或运行目录中运行。Slate 需从 https://github.com/ianstormtaylor/slate.git 拉取 pull/<n>/head,安装并构建后,核心探测放 packages/slate/test/ 用 mocha 运行,React 探测放 packages/slate-react/test/ 用 jest 运行;Plate main 从 https://github.com/udecode/plate.git 同样拉取,安装与测试遵循 Babysit 手册的 main 线 PR 规则。探测及失败输出复制到运行目录,随后移除 worktree。若发现声称 v2 已处理该场景,需在本检出中运行同一场景,仅在通过时保留该声明。
-
运行评审小组:除非所有者要求快速模式,阅读 .agents/pstack/rules/panel.md 后运行 Babysit 手册的仅评审小组(reviews: external-pr),并以 PR 正文、关联 issue、第 2 步证据和第 3 步探测作为输入;小组发现需经探测或源码行确认后才进入评论。
-
撰写评论草稿:写入 <run>/comment.md,结构包括:模型与投入度及 head SHA(9 字符)、小组信息、最多两句的结论、最严重确认失败的高亮提示、“How Plate v2 does it”(最多三段)、“Findings”(按严重程度排序,含触发步骤、错误结果、原因所在行、修复方式及 v2 做法)、“Smaller points”、“Verified”(最多三条)以及可折叠的复现测试块。v2 源码仅链接到 origin/next 上确实包含该内容的提交,未提交的 v2 工作只描述不链接;不写运行目录等本地路径。
-
写作润色:先运行 pstack:unslop,再以 pstack:bro 逐句复述作为最后一轮,保留代码标识符、SHA、计数与限定条件,并与探测输出和发现汇总核对是否漂移。
-
交回:回复结论、每条发现一行、改变评审的 v2 证据、未检查项及草稿链接。仅在所有者确认后发布;发布前重新读取 headRefOid,head 变动则重跑探测,然后用 gh pr comment 或 gh pr review --comment 发布。
适用场景与限制
适用于需要以 Plate v2 为参照、强调可复现证据的 Slate/Plate main PR 评审。限制包括:不覆盖基于 next 的 PR 与 PR 修复;依赖 gh、rg、pnpm、yarn 等工具与相应仓库检出;评论在所有者确认前保持草稿状态;v2 缺少相关记录时只能如实说明。其他未在资料中说明的事实暂未提供。