用途:在 inspect_ai 仓库中落地需要同步修改 ts-mono 子模块的 PR。常见触发原因是 Python 模型变更导致类型生成流水线重新生成子模块内文件,需要跨仓库协作:提交 ts-mono PR、更新本仓库 gitlink、按特定顺序合并。本技能是 AGENTS.md 中禁止改动子模块 gitlink 规则的被认可例外。
主要能力:识别所处状态(尚无分支、需重新生成、PR 未 bump、双 PR 已开等)并进入对应步骤;从 ts-mono origin/main 起分支;运行生成命令;处理兄弟消费者 inspect_scout 的类型同步;完成两阶段落地(第一阶段分支固定、可评审;第二阶段按序快速合并);给出 pitfalls 处理方案。
必要用法与命令:子模块为 src/inspect_ai/_view/ts-mono,指向 meridianlabs-ai/ts-mono 的 main 分支。重新生成命令:python src/inspect_ai/_view/schema.py(仓库根目录、激活 venv,且子模块内已执行 pnpm install)。生成物包括本仓库的 src/inspect_ai/_view/inspect-openapi.json 和子模块内 packages/inspect-common/src/types/generated.ts。子模块推送前检查:在 ts-mono 根目录运行 pnpm typecheck 与 pnpm test(turbo),而非逐包 tsc。查找配对分支可用 git -C <submodule> branch -a --contains HEAD。子模块改动前先 git checkout <branch>,避免在 detached HEAD 上提交。落地后启用自动合并:gh pr merge --auto。比较 gitlink 与 origin/main 时,若 SHA 变化需 bump 并在新提交重建 viewer bundle:pnpm install --frozen-lockfile && pnpm --filter @meridianlabs/log-viewer build,随 dist/ 变更一起提交。
适用场景:check-schema-and-types 变红;改动了流入流水线的 Python 模型(Content、ChatMessage、Event、Citation、ToolChoice、EvalLog 等);需直接编辑子模块代码。
限制:需对 Python PR 头分支有推送权限,组织 fork 的 allow-maintainer-edits 无效;绝不将 gitlink 指向未推送的提交;ts-mono PR 禁止启用 auto-merge,需人工择时合并;仅结构变更需重新生成,docstring 变更不需要;需从安装了本仓库的 venv 重新生成,且子模块 node_modules 需先 pnpm install。超出以上资料的内容(如价格、平台支持等)暂未提供。