SuperAPI AI 工具集

contributor-setup

部署与运维

查看项目

更新于 10-30 01:45

技能介绍

用途

contributor-setup 用于解决两类问题:一是本地分支早于 next 分支的智能体规则,导致智能体自行撰写 PR 正文;二是已经提交到 next 的开放 PR 正文检查失败。它把分支一次性更新到最新并修复已失败的正文,之后每个会话启动时会核对智能体插件与检出所固定的版本,并打印需要执行的修复。

主要能力

  • 统计当前分支相比 udecode/plate 远程 next 分支缺少的智能体规则提交,涉及 AGENTS.md、.agents、.claude、.codex 等路径。远程名在 fork 中为 upstream,否则为 origin,使用命令:git fetch <remote> next && git rev-list --count HEAD..<remote>/next -- AGENTS.md .agents .claude .codex。
  • 当上述计数大于 0 时,提示合并 <remote>/next 或变基到其上,并请人工以该技能启动新的智能体会话。
  • 按会话启动检查打印的顺序逐条应用修复;若当前会话因运行时未执行钩子而没有输出,则运行 node .agents/rules/contributor-setup/scripts/doctor.mjs 并应用其输出,直到打印 ok:。
  • 列出由本人提交、目标为 next、且正文检查失败的开放 PR,命令为:gh pr list --repo udecode/plate --author @me --base next --state open --json url,statusCheckRollup --jq '.[] | select(any(.statusCheckRollup[]; .name == "PR body" and .conclusion == "FAILURE")) | .url'。
  • 按 land.mjs 的规则重写每个 PR 正文,并用 gh pr edit <number> --body-file <file> 更新,更新后检查会再次运行;当第 3 步的命令不再输出内容时,该步骤完成。

使用方式

先执行缺少提交数的统计命令。计数大于 0 时,合并或变基到远程 next,并请人工开启新的智能体会话,到此停止。随后按会话启动检查输出的修复项逐条应用;无输出时改用 doctor.mjs 诊断并持续修复至 ok:。接着用 gh pr list 命令找出正文检查失败的开放 PR。对每个 PR,先用 gh pr view <number> --json body --jq .body > <file> 保存正文。若该 PR 恰好改动 docs/plans/ 下的一个计划,则按 plan-page 技能的 PR 章节,以 --into <file> 将该计划渲染进文件;否则保留正文并新增两个章节:## Why 用一小段说明变更存在的原因;## Verification 列出在 PR 头部运行的每条命令或检查及其结果,并指明未测试的内容;若尚无任何运行,先运行该 PR 的聚焦测试。正文末尾以 Beyond the ask: 开头的一行,列出请求未要求的各项改动,或声明没有。最后用 gh pr edit <number> --body-file <file> 更新 PR。后续的变更则按 .agents/pstack/rules/land.md 所述,用 land.mjs 落地,它会以正确的正文向 next 打开 PR。

适用场景

适用于 udecode/plate 仓库中向 next 分支提交 PR 的贡献者,尤其是 PR 正文检查失败、或本地分支落后于 next 的智能体规则、需要一次性对齐并修复已有 PR 正文的情况。

限制

资料仅覆盖上述针对 udecode/plate 仓库与 next 分支的流程,未提供其他仓库、分支或平台的适配信息;收费、价格与效果信息暂未提供。