Codex可通过workspace.yaml集中管理多仓库代码质量检查规则。在中心目录创建该文件定义检查项,各仓库运行codex check --workspace指定路径即可复用;支持Git submodule引入配置,或用环境变量动态控制规则启用状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在多个Git仓库中统一执行相同的代码质量检查逻辑,但又不想为每个仓库单独维护一套检查脚本或配置文件。
用Codex的Workspace机制集中管理检查流程
Codex支持通过workspace.yaml定义跨仓库复用的检查规则。在任意一个独立目录下创建该文件,它就能被多个仓库引用。
第一步:在你本地选一个中心位置(比如~/codex-checks/),新建workspace.yaml文件。
第二步:在该文件中写入检查定义,例如:
checks: - name: no-console-log pattern: "console\.log\(" message: "禁止提交console.log调试语句" severity: error
第三步:保存后,在任一目标仓库根目录运行codex check --workspace ~/codex-checks/workspace.yaml即可生效。
这一步必须指定--workspace参数,否则Codex默认只读取当前仓库下的.codex.yaml,不会自动向上查找。
通过Git submodule引入检查配置
适合团队协作场景,让所有仓库都指向同一份权威配置。
方法一:将检查配置仓库作为submodule添加到各目标仓库中
进入目标仓库→执行git submodule add https://github.com/your-org/codex-rules.git .codex-rules→提交。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法二:在目标仓库的.codex.yaml中引用submodule路径
extends: .codex-rules/base.yaml
【.codex-rules目录必须已通过git submodule update --init初始化,否则Codex会报找不到文件】
方法三:用Codex CLI的--config参数直接加载submodule内配置
codex check --config .codex-rules/strict.yaml
用环境变量动态切换检查集
当你需要对不同仓库启用不同强度的检查(如dev仓库宽松、prod仓库严格),可以用环境变量控制。
在workspace.yaml中使用${CHECK_LEVEL}占位符:
checks: - name: require-jest-test enabled: ${CHECK_LEVEL} == "strict"
检查时设置环境变量再运行:CHECK_LEVEL=strict codex check --workspace ~/codex-checks/workspace.yaml。
这一步不设默认值,如果忘记设置CHECK_LEVEL,Codex会把enabled解析为false,整条规则静默跳过。

















