配置速查表维度Claude CodeCodexOpencode项目配置文件.claude/CLAUDE.md.codex/AGENTS.mdAGENTS.md项目根Skill 目录项目级.claude/skills/.codex/skills/skills/Skill 目录用户级~/.claude/skills/~/.codex/skills/~/.opencode/skills/状态文件STATE.md项目根STATE.mdSTATE.md循环配置LOOP.mdLOOP.mdLOOP.md调度命令/loop 1d//scheduleAutomations 页面systemd / cron opencode run持续目标/goal/goalopencode run Goal: ...子 Agent 目录.claude/agents/.codex/agents/*.tomlopencode agent name连接器MCP serversMCP Connectorsopencode.json MCPToken 预算loop-budget.mdloop-budget.mdloop-budget.md运行日志loop-run-log.mdloop-run-log.mdloop-run-log.md脚手架/loop 逐步搭建手动AGENTS.mdSTATE.md手动健康检查loop-auditloop-auditloop-audit重要提醒Skill 文件跨工具兼容。同一份 SKILL.md 可以同时放在.claude/skills/、.codex/skills/和skills/下三个工具都能用。格式是公开标准agentskills.io。一、Claude Code 配置1. 配置文件放哪里项目根目录/├── .claude/│ ├── CLAUDE.md # 项目规则循环宪法│ ├── skills/│ │ ├── loop-triage/│ │ │ └── SKILL.md # 分诊技能│ │ ├── minimal-fix/│ │ │ └── SKILL.md # 最小修复技能│ │ └── loop-verifier/│ │ └── SKILL.md # 验证技能│ └── agents/│ ├── implementer.md # 实现者 Agent│ └── reviewer.md # 审查者 Agent├── STATE.md # 循环记忆└── LOOP.md # 循环配置2. CLAUDE.md 配置模板markdown# CLAUDE.md — 循环宪法## 项目规则- 语言: TypeScript / Python- 测试: npm test, pytest- 构建: npm run build## 循环模式- 初始 L1 报告模式不自动改代码- 每次读 STATE.md 再开始工作- 每次跑完写入 STATE.md## 安全边界- 不自动推送和合并- 不碰 .env、auth/、secrets/、payments/- 改代码必须用 git worktree 隔离## 验证- 任何代码改动必须由独立的 Verifier 检查- 验证必须跑真实测试不能只看代码3. 调度命令bash# L1 — 每日分诊报告模式/loop 1d 跑 $loop-triage。读 STATE.md。产出追加到 STATE.md。不改代码。# L2 — 分诊 自动修小问题/loop 1d 跑 $loop-triage。高优先级小修小补开工作树 → $minimal-fix → $loop-verifier → 验证通过开 PR。更新 STATE.md。# /goal — 持续到条件满足/goal test/auth 下全部测试通过lint 干净# /schedule — 定时调度Claude Code Web 界面/schedule 每天早上 9 点跑 daily-triage发状态报告给我4. 特色功能独立的 /goal 判断模型默认用 Haiku 判断是否完成写代码的模型不给自己打分Hooks 集成在.claude/hooks.json配置 GitHub Actions 回调MCP 生态最完整GitHub / Linear / Slack / Jira / Notion 都有原生连接器二、Codex 配置1. 配置文件放哪里项目根目录/├── .codex/│ ├── AGENTS.md # 项目规则│ └── skills/│ ├── loop-triage/│ │ └── SKILL.md│ ├── minimal-fix/│ │ └── SKILL.md│ └── loop-verifier/│ └── SKILL.md├── STATE.md└── LOOP.md2. AGENTS.md 配置模板markdown# AGENTS.md — 循环配置## 循环规则- L1 报告模式前两周不自动修复- 先读 STATE.md再决定做什么- 每次运行结束更新 STATE.md## 安全- 不经批准不推送- 禁止修改 .env、credentials/、secrets/- 每次代码实验用 git worktree 隔离## 预算- 每日 Token 上限 100k- 超过 80% 自动切报告模式- 超过 100% 跳过本次运行3. 调度方式Codex 的调度在网页界面的 Automations 标签页配置不是命令行打开 codex.ai/app进入 Automations 标签页选择项目 → 写 Prompt → 选频率输出发送到 Triage Inbox 或写回 STATE.mdAutomation Prompt 示例L1 分诊markdown跑 loop-triage Skill。读 STATE.md。扫描最近 24 小时 CI 失败和 Open Issue。输出结构化的优先级报告追加到项目根目录的 STATE.md。不改代码只报告。Automation Prompt 示例L2 分诊修复markdown跑 loop-triage Skill。高优先级项中判断为小修小补的开工作树 → 跑 minimal-fix Skill → 跑 loop-verifier Skill → 验证通过的开 PR。中高风险项标记为需人工审查。更新 STATE.md。不改不相关的代码。4. 其他命令bash# /goal — Codex 也支持/goal 计费模块迁移完成旧 API 零调用# exec — 非交互模式跑脚本codex exec 跑 loop-triage Skill只报告不改代码5. 特色功能Automations 从网页配置不需要记命令Triage InboxCodex 自带的分类收件箱适合 L1 报告模式子 Agent TOML 配置在.codex/agents/下用 TOML 文件定义 Agent三、Opencode 配置1. 配置文件放哪里Opencode 不像 Claude Code 和 Codex 有固定的隐藏目录约定。它通过项目根目录的AGENTS.md加载规则Skill 放在skills/目录下项目根目录/├── AGENTS.md # 项目规则├── skills/│ ├── loop-triage/│ │ └── SKILL.md│ ├── minimal-fix/│ │ └── SKILL.md│ └── loop-verifier/│ └── SKILL.md├── STATE.md└── LOOP.md2. AGENTS.md 配置模板markdown# AGENTS.md — Opencode 循环配置## 循环模式- L1 报告模式不改代码- 每次先读 STATE.md 再开始工作- 每次跑完写入 STATE.md## 安全- 不自动推送和合并- 不修改 .env、secrets/、payments/- 改代码用 git worktree 隔离## 验证- 所有代码改动必须由独立 Verifier 检查- Verifier 必须跑真实测试3. 调度方式Opencode 本身没有内置调度器。调度依赖外部 cron 或 systemd timerbash# /etc/cron.d/opencode-daily-triage# 每个工作日早 9 点跑分诊0 9 * * 1-5 cd /path/to/project opencode run 跑 $loop-triage读 STATE.md只报告不改代码 --timeout 300# 用 opencode run 跑目标和循环# L1 — 一次分诊opencode run 跑 $loop-triage。读 STATE.md。产出追加到 STATE.md。# /goal 模式opencode run Goal: test/auth 全部测试通过。Verifier 确认后停。# L2 — 分诊修复手动触发opencode run 跑 $loop-triage。高优先级小修小补开 worktree → $minimal-fix → $loop-verifier → 通过开 PR。更新 STATE.md。4. 特色功能AGENTS.md 最灵活项目根目录直接放不限制目录名称Skill 目录结构简洁skills/name/SKILL.md没有.opencode/前缀外部调度自由度高可以用 systemd、cron、GitHub Actions 任意调度方式export 功能opencode export sessionID导出完整会话适合审计和调试5. 适用场景Opencode 适合需要灵活调度方式的场景——你已经有自己的一套自动化基础设施cron/systemd/GitHub Actions不需要工具内置调度。AGENTS.md 放在项目根目录Skill 放在skills/没有藏起来的配置对团队协作更友好。四、跨工具迁移指南你不需要锁定一个工具。同一个循环设计可以跨工具跑。Skill 文件直接复制bash# 从 Claude Code 复制到 Opencodecp -r .claude/skills/loop-triage skills/loop-triage# 从 Claude Code 复制到 Codexcp -r .claude/skills/loop-triage .codex/skills/loop-triage# 一键同步如果装了 loop-syncnpx cobusgreyling/loop-sync .脚手架生成推荐方式bash# 直接在一个目录下生成 Claude Code 的循环npx cobusgreyling/loop-init . --pattern daily-triage --tool claude# 生成 Codex 的循环npx cobusgreyling/loop-init . --pattern daily-triage --tool codex# 生成 Opencode 的循环npx cobusgreyling/loop-init . --pattern daily-triage --tool opencode跨工具迁移对照要做的事Claude CodeCodexOpencode启动每日循环/loop 1d promptAutomations 页面配置cron opencode run持续目标/goal 条件/goal 条件opencode run Goal: ...调用 Skill$skill-name$skill-name在 prompt 中引用定义子 Agent.claude/agents/*.md.codex/agents/*.tomlopencode agent name设置 MCP.claude/settings.json应用设置opencode.jsonToken 预算loop-budget.mdloop-budget.mdloop-budget.md运行日志loop-run-log.mdloop-run-log.mdloop-run-log.md五、三份可复用的 Skill 文件无论用哪个工具这三份 SKILL.md 都是一模一样的。放在对应的 skills/ 目录下即可。loop-triage分诊markdown---name: loop-triagedescription: 分诊最近 24 小时 CI 失败、Issue 和提交。产出结构化优先级报告供循环消费。写入 STATE.md。user_invocable: true---# Loop Triage Skill你是分诊 Agent。产出优先级列表。## 输入循环提供- 最近 24h CI/测试失败- 负责人名下的 Open Issue- 最近 24-48h main 分支提交- 当前 STATE.md## 输出格式### 1. 高优先级立即处理- 一句话描述- 为什么重要- 建议循环下一步### 2. 观察项### 3. 噪音/忽略### 4. 状态更新minimal-fix最小修复markdown---name: minimal-fixdescription: 对指定问题产出最小代码改动。不改无关代码不重构。user_invocable: true---# Minimal Fix Skill只修一个特定问题最小 diff。## 流程1. 确认根因2. 只改必须改的3. 跑相关测试4. 输出改了什么、为什么、跑了什么## 规则- 一个问题一次调用- 不碰禁用路径列表- 不用工作树时要求隔离loop-verifier独立验证markdown---name: loop-verifierdescription: 独立验证循环产出的代码改动。找理由拒绝不是找理由接受。跑真实测试。user_invocable: true---# Loop Verifier Skill默认立场拒绝。除非证据充分。## 检查清单1. 范围只改了相关文件2. 意图确实解决了声明问题3. 测试跑了测试报告结果4. 不作弊没有跳过测试5. 风险中高风险建议人工审查六、快速起步对照表步骤Claude CodeCodexOpencode第 1 步写.claude/CLAUDE.md写.codex/AGENTS.md写AGENTS.md项目根第 2 步把 3 份 SKILL.md 放.claude/skills/把 3 份 SKILL.md 放.codex/skills/把 3 份 SKILL.md 放skills/第 3 步创建STATE.md模板创建STATE.md创建STATE.md第 4 步/loop 1d 跑 $loop-triage只报告Automations: 分诊 Prompt每天一次cron opencode run 跑 $loop-triage只报告第 5 步读一周 STATE.md调优读一周收件箱调优读一周 STATE.md调优第 6 步加 $minimal-fix $loop-verifier升级 Automation 为 L2cron 命令加 L2 参数健康检查npx cobusgreyling/loop-audit .同上同上