SuperAPI AI 工具集

sync-codex

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:在 Codex 环境中独立运行完整的镜像同步与校验流水线,等价于 npm run sync:all && npm run verify:all,但不需要 package.json 或 npm。该运行器是流水线的唯一事实来源,package.json 中的 sync:all/verify:all 脚本会委托给它,因此只复制了 .claude(没有根 package.json)的项目也能运行相同流水线。原名 /codex-sync,现用 $sync-codex 调用。

主要能力:共 16 个阶段,顺序执行,首个非零退出即快速失败。阶段 1-3 会修改文件:migrate 迁移 Claude agents 到 .codex/agents/、镜像 skills 到 .agents/skills/ 并配置 Codex 通知;hooks 生成 .codex/hooks.json 与同步报告;context 重新生成 .codex/CODEX_CONTEXT.md 与 AGENTS.md。阶段 4-16 为只读校验器,包括 codex 工具单元测试、仓库脚本单元测试、三个 hook 套件门禁、七个 codex 校验器以及跨表面分歧预言机。同时会把可移植的 .claude/scripts/codex/codex-notify.mjs 复制到 .codex/scripts/codex/,并向 .codex/config.toml 写入通知与 TUI 状态行键。

使用方式:完整同步运行 node .claude/skills/sync-codex/scripts/run-codex-sync.mjs;加 --verbose 流式输出子进程日志;加 --copy-skills 强制技能复制模式;只跑只读校验用 --only=tests,scripts-tests,hooks-count-drift,hooks-parity,hooks-doc-sync,wf-cycle,sk-proto,residue,sdd,review-validate-coverage,sync-adoption-parity,provenance-markers,sync-divergence;调试时用 --skip=migrate,hooks 跳过阶段。退出码 0 表示全部通过,1 表示编排器失败,非零会从失败阶段传播。工作目录会从脚本路径自动解析到仓库根,不要传 --cwd。

限制与规则:必须按顺序运行全部 16 个阶段;只能编辑 .claude/skills/sync-codex/** 源文件,绝不能编辑自动镜像 .agents/skills/sync-codex/;.claude 是技能、工作流、钩子的来源,生成目标为 .agents/skills/、.codex/CODEX_CONTEXT.md 和 AGENTS.md;仅当用户明确请求 codex 同步时才调用,唯一例外是 $project-skill-protocol 在其三次写入后自动运行;若 Codex 镜像或 AGENTS.md 缺失或过期,应请用户运行 $sync-codex,不要自动运行。流水线幂等,重复运行只产生时间戳差异。其他细节暂未提供。