多 Agent 适配（Claude Code & Codex）¶
目标：一份内容、两端 plugin、免 clone、低维护。团队主用 Claude Code 与 Codex。
一份内容，两端 plugin¶
| Claude Code | Codex | |
|---|---|---|
| 约定文件 | CLAUDE.md（=@AGENTS.md） |
AGENTS.md（原生读） |
| marketplace 清单 | .claude-plugin/marketplace.json |
.agents/plugins/marketplace.json |
| plugin 清单 | plugins/*/.claude-plugin/plugin.json |
plugins/*/.codex-plugin/plugin.json |
| skills | plugins/*/skills/*/SKILL.md（两端共用同一份） |
同左 |
| 安装 | /plugin marketplace add <url> + /plugin install |
codex plugin marketplace add <url> + codex plugin add |
两端 plugin 清单都由 .claude-plugin/plugin.json 这一单一事实源派生：改了它后跑 node tools/gen-codex-manifests.mjs 同步 .codex-plugin/。skills 一份不复制。
安装（都不需要 clone）¶
Claude Code¶
/plugin marketplace add https://gitee.com/finmate/czerp-ai-enablement.git
/plugin install czerp-context@czerp-ai-enablement
/plugin install czerp-workflow@czerp-ai-enablement
# 按角色追加 …
claude mcp add --transport http --scope user czerp-team-mcp https://serion.cc/jungle/mcp --header "Authorization: Bearer <你的令牌>"
Codex¶
codex plugin marketplace add https://gitee.com/finmate/czerp-ai-enablement.git
codex plugin add czerp-context@czerp-ai-enablement
codex plugin add czerp-workflow@czerp-ai-enablement
# 按角色追加 …
export MCPJUNGLE_TOKEN="<你的令牌>"
codex mcp add czerp-team-mcp --url https://serion.cc/jungle/mcp --bearer-token-env-var MCPJUNGLE_TOKEN
单一事实源原则¶
- 唯一内容：根
AGENTS.md+ 各plugins/*/skills/*/SKILL.md。 CLAUDE.md仅@AGENTS.md一行（非 symlink，Windows 友好）。- SKILL.md 的 frontmatter
description同时驱动两端"何时触发"。 - plugin 清单：
.claude-plugin/plugin.json→ 脚本生成.codex-plugin/plugin.json。
升级¶
# Claude
/plugin marketplace update czerp-ai-enablement && /plugin update <name>@czerp-ai-enablement
# Codex
codex plugin marketplace upgrade czerp-ai-enablement
维护者（改本仓库的人）¶
只有维护者需要 clone：
git clone https://gitee.com/finmate/czerp-ai-enablement.git
# 改 skill / context / 清单后：
node tools/gen-codex-manifests.mjs # 同步 Codex plugin 清单
node tools/sync-legacy-agents.mjs --apply # 部署各代码仓库 AGENTS.md（一次性）