catui2codex

让 Codex 负责拆解、验收和连接器写入，让一个或多个独立 CatUI 进程完成阅读、分析、脚本及补丁准备。目标是减少主管的重复阅读、生成与返工，不承诺固定 token 节约比例，也不是模型微调。

安装

npx [email protected] install

默认安装到 $CODEX_HOME/skills/catui2codex，未配置 CODEX_HOME 时使用 ~/.codex/skills/catui2codex。已有目录会拒绝覆盖，不自动修改旧技能。可用 --dir /absolute/skills 指定技能父目录。

在 Codex 中使用：

使用 $catui2codex，把独立工作交给 CatUI，你负责审核、整合和验收。

需要本机已安装并配置可用的 CatUI CLI、Python 3.9+；JavaScript 静态检查需要 Node.js。本包不包含 CatUI，不修改账号、模型或全局配置，没有安装时自动执行的生命周期脚本。

分工与交付

• Codex 定义真实输入、边界、资源所有权、禁令和验收标准。
• CatUI 每轮接收固定交付契约，复用已验收模板，同轮自检后交完整产物和短证据。
• 运行器离线检查 JSON、JavaScript 语法及部分 Figma 草稿约束；主管核查关键事实、实际状态与视觉效果。
• 默认最多一轮定点返工，重复错误进入规则或模板。不同进程只能并行处理无依赖、无资源冲突的任务。

运行器仅支持无工具 draft 和只读工具 read，不支持直接编辑，也不是 OS 文件系统沙箱。Figma 连接器能力、授权和客户端支持须在当前环境核实；本包不提供 Figma 写入凭据，也不绕过连接器限制。

包内文件

SKILL.md 是技能入口，references/ 包含执行者契约、运行器说明和 Figma 模板，scripts/run_workers.py 保存完整产物与 usage，scripts/check_artifact.py 提供离线格式检查。所有源文件可读，无运行时 npm 依赖。

python3 "$HOME/.codex/skills/catui2codex/scripts/run_workers.py" tasks.json \
  --run-dir /absolute/output/new-batch --parallel 2 --timeout 300

清单格式见 references/runner.md。命令成功或静态检查通过不代表业务验收通过；收益统计应包含主管审核、失败轮次和整合，并分别计量 Codex 与 CatUI。

MIT License。独立社区技能，与 CatUI、Codex、Figma 官方没有隶属关系。