Professional Codex Setup

把第一次打开的 Codex 配置成专业工作台的中文 skill 与本地 plugin 骨架。

它不是一个激进的“一键全改”脚本，而是一套安全、可审计、跨平台的配置流程：先审计环境，再生成方案，再按六层配置推进，最后验证和复盘。

适合谁

• 刚开始使用 Codex，希望快速建立专业工作习惯的新手。
• 想把 CLAUDE.md、Cursor rules、Copilot instructions 等旧经验迁移到 Codex 的用户。
• 想统一配置 AGENTS.md、验证层、工具层、记忆层和安全边界的个人或团队。
• 想审查第三方 skill、规划插件安装、打包本地 plugin 的进阶用户。

包含什么

skills/professional-codex-setup/
  SKILL.md
  agents/openai.yaml
  references/
    agents-templates.md
    examples-before-after.md
    linux-wsl-setup.md
    macos-setup.md
    plugin-strategy-generator.md
    security-policy.md
    six-layer-setup.md
    third-party-skill-review.md
    tool-layer.md
    validation-layer.md
    windows-setup.md
  scripts/
    codex_setup_audit.py
    codex_setup_audit.ps1
    codex_setup_audit.sh
    generate_plugin_strategy.py
    package_as_plugin.py
    review_third_party_skill.py

plugin/professional-codex-setup/
  .codex-plugin/plugin.json
  skills/professional-codex-setup/

六层配置

1. 指令层：全局和项目级 AGENTS.md。
2. 运行层：低风险 config.toml 建议，不默认改认证、provider、sandbox。
3. 工具层：插件、skills、MCP 的分组策略和按需授权。
4. 验证层：按任务类型选择测试、lint、浏览器、文档渲染等质量门槛。
5. 记忆层：默认文件型知识库，不默认启用 experimental memories。
6. 安全层：备份、回滚、第三方 skill 审查、高风险动作确认。

安装方式

作为 skill 安装

把 skills/professional-codex-setup 复制到你的 Codex skills 目录。

Windows:

Copy-Item -Recurse -Force .\skills\professional-codex-setup "$env:USERPROFILE\.codex\skills\professional-codex-setup"

macOS / Linux:

mkdir -p ~/.codex/skills
cp -R ./skills/professional-codex-setup ~/.codex/skills/professional-codex-setup

作为本地 plugin 使用

仓库里已经包含一个本地 plugin 骨架：

plugin/professional-codex-setup/.codex-plugin/plugin.json

也可以重新生成：

python .\skills\professional-codex-setup\scripts\package_as_plugin.py --output .\plugin

使用方式

只读审计当前环境：

python .\skills\professional-codex-setup\scripts\codex_setup_audit.py --workspace "E:\Codex Workplace"

生成配置草案：

python .\skills\professional-codex-setup\scripts\codex_setup_audit.py --workspace "E:\Codex Workplace" --generate

确认后写入低风险文件：

python .\skills\professional-codex-setup\scripts\codex_setup_audit.py --workspace "E:\Codex Workplace" --generate --write

生成插件安装策略：

python .\skills\professional-codex-setup\scripts\generate_plugin_strategy.py --profile balanced

审查第三方 skill：

python .\skills\professional-codex-setup\scripts\review_third_party_skill.py "<path-to-skill>"

安全边界

默认不会修改：

• auth / provider
• sandbox / approval
• hooks
• MCP 授权
• plugin 授权
• 生产部署配置
• 密钥、令牌、.env

--write 只会写入或更新：

• 全局 AGENTS.md
• 工作区 AGENTS.md
• _knowledge_base/INDEX.md

并且写入前会备份已有文件。

快速验证

python .\tests\quick_validate.py

验证内容包括：

• skill frontmatter 是否存在。
• plugin manifest 是否有效。
• Python 脚本是否可编译。
• 插件策略生成器是否能运行。
• 第三方 skill 审查器是否能运行。

发布到 GitHub

安装并登录 GitHub CLI 后，可以运行：

.\scripts\publish_public_repo.ps1

如果还没有登录：

gh auth login

开源定位

这个项目的重点不是替别人决定所有配置，而是给 Codex 新手一个专业化配置流程：

• 可审计。
• 可备份。
• 可回滚。
• 跨 Windows / macOS / Linux。
• 支持工具层策略，而不是盲目安装。
• 支持第三方 skill 审查。
• 支持打包为 Codex plugin。