五分钟讲透 Codex 框架
核心定位
Codex = 你的专属工程团队
通过 5 个核心配置、五层架构，打造高效、可控、可复用的 AI 开发团队，你是全栈指挥官。
代码块
Haskell
codex init my-team
codex config 5x
五层架构拆解
Layer 1：记忆层（AGENTS.md/ CODEX.md）
•
目录结构：
◦
CODEX.md/
▪
architecture.rules：架构强制规范，定义系统模块划分、调用链路、数据流转标准；
▪
global.md：全局通用约束，统一命名规范、注释格式、日志标准、权限基线；
▪
project.md：项目专属上下文，存储业务目标、交付预期、项目边界、环境配置。
💡
关键价值：统一命名、结构、仓库规范，让 AI 团队所有成员对齐底层规则。
核心作用：全局配置、项目级规则、代码规范、工程红线，是写死的团队共识。
Layer 2：知识层（skills/）
•
目录结构：
◦
skills/
▪
SKILL.md：能力元描述文件，定义能力触发条件、入参出参、使用场景；
▪
scripts/：能力底层执行脚本，承载工具调用、数据处理、业务逻辑；
▪
context.md：能力私有上下文，存储该技能专属缓存、参考资料、限制条件。
💡
关键价值：沉淀团队最佳实践，避免重复造轮子，让 AI 按场景匹配能力。
核心作用：工作流提取，让 Agent 自动识别、按需调用，变得更聪明、更懂你。
Layer 3：护栏层（hooks/）
•
目录结构：
💡
关键价值：事前拦截风险、事后留痕记录，确保 AI 操作安全可控。
核心作用：特定行为前后自动执行，防危险命令、自动化操作、部署通知，是安心可控的安全护栏。
Layer 4：委派层（subagents/）
•
目录结构：
◦
subagents/
▪
code-reviewer.md：代码评审子智能体，独立上下文负责代码规范校验、漏洞检测、优化建议；
▪
text-runner.md：文本执行子智能体，负责文档生成、脚本运行、内容校验；
▪
explorer.md：资源检索子智能体，负责文件遍历、数据库查询、接口资源探查。
💡
关键价值：每个子智能体有独立上下文窗口、自定义工具与权限，结果回传主线程，保持主线逻辑干净。
核心作用：子智能体，独立上下文、并行执行、互不干扰，提升开发效率与质量。
Layer 5：分发层（plugins/）
•
目录结构：
◦
plugins/
▪
manifest.json：插件元数据清单，记录插件依赖、版本、分层资源、权限声明；
▪
marketplace.url：插件市场远端地址，支持在线拉取、版本更新；
💡
关键价值：支持 NPM 包分发、版本可控，一键安装实现全队配置同步。
核心作用：团队统一安装，技能、规则、子智能体一键同步，确保团队配置完全一致。
架构设计核心优势总结
架构设计核心优势总结
分层解耦，职责单一 五层自上而下约束、自下而上执行，每层仅负责单一职能，新增能力 / 规则无需改动其他层级，扩展性极强。
全链路标准化管控 从顶层记忆规范、能力封装、流程拦截、任务拆分到团队分发，全流程有统一文件标准，杜绝开发碎片化。
安全与质量内置 L3 护栏层嵌入全生命周期钩子，在会话、工具调用前后强制校验，原生具备风险阻断、数据格式化能力。
规模化团队落地能力 L5 分发层提供完整打包、市场分发、批量安装能力，适配企业多团队、多项目统一 AI 开发规范落地。
可复用模块化智能体 L2 技能库、L4 子智能体均可独立打包复用，减少重复开发，构建企业内部 AI 能力资产库。
适用业务场景
企业内部 AI 代码开发、自动化工程智能体搭建；
多智能体协同工作流平台标准化底座；
面向团队交付的可定制 AI 开发工具套件；
基于 MCP 协议的模型上下文管控标准化工程体系。
架构流转逻辑
🔁
CODEX.md（定规则）→ skills/（给能力）→ hooks/（保安全）→ subagents/（做分工）→ plugins/（全团队）
#BGQhhTpLiXqz text{white-space:pre}.fb0{stroke:var(--N900-FG, 0.15)}.fx0{stroke-miterlimit:10}.fa1{fill:#bbbfc4}.fx1{font:normal 400 12px MonospacedNumber,LarkHackSafariFont,LarkEmojiFont,LarkChineseQuote,-apple-system,BlinkMacSystemFont,Helvetica Neue,Tahoma,PingFang SC,Microsoft Yahei,Arial,Hiragino Sans GB,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}.fx2{text-anchor:middle}.fx3{dominant-baseline:central}.fx4{stroke:none}.fc0{fill:var(--text-caption)}.fa2{fill:var(--text-link-disabled)}.fa3{fill:rgb(225, 234, 255)}.fa4{fill:rgb(255, 255, 255)}.fx5{font:700 normal 18px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}.fx6{text-anchor:start}.fx7{dominant-baseline:alphabetic}.fc1{fill:rgb(0, 0, 0)}.fx8{font:400 normal 16px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}.fb1{fill:var(--N900-FG, 0.15)}.fa5{fill:var(--bg-body)}AB1234567角色核心职责架构师开发工程师测试工程师运维工程师数据分析师安全专家设计系统架构实现功能代码保障代码质量部署与监控数据洞察分析安全审计防护
44%
56%
补充要点
🔔
•
外部能力：可通过 MCP 接入外部工具、数据库、API、服务，扩展团队能力边界。
•
团队协作模式：并行执行、消息传递、任务分发、共享权限、复用资产，实现高效协作。