Skip to content
Back to search

codex-team-mode

协调探索、执行和独立评审,让复杂任务按明确职责并行推进,由主 Agent 统一验收。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/oil-oil--codex-team-mode/badge.svg)](/listings/oil-oil--codex-team-mode)

HTML

<a href="/listings/oil-oil--codex-team-mode"><img src="/api/listings/oil-oil--codex-team-mode/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add oil-oil/codex-team-mode

Skill 和角色配置分开安装。将 [`agents/`](./agents) 中的 `Explorer.toml`、`Executor.toml`、`Reviewer.toml`、`ExpertAdvisor.toml` 复制到 `~/.codex/agents/`;只给一个项目使用时,复制到该项目的 `.codex/agents/`。角色未立即出现时,新建 Codex 任务或重启。详见[角色配置说明](./skills/team-mode/references/custom-agents.md)。

使用 $team-mode 完成任务。只派发有明确收益的子 Agent,主 Agent 负责最终验收。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 59 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="./assets/readme/agent-map.webp" width="100%" alt="Team Mode:主 Agent 协调探索、执行与复审三条常规路径。">
  3. </p>
  4. # Team Mode 小队模式
  5. Team Mode 是 Codex Skill。主 Agent 负责拆解、未决判断和最终验收;子 Agent 只接手职责明确、确实值得委派的部分。简单任务可以不派任何子 Agent。
  6. ## 角色
  7. | 角色 | 默认配置 | 何时使用 |
  8. | --- | --- | --- |
  9. | Explorer | GPT-6 Luna Medium、Fast | 主 Agent 明确需要探索大量代码,先定位主要文件、入口和调用关系。 |
  10. | Executor | GPT-6 Luna Extra High | 目标和文件归属清楚时,围绕预期结果完成实现。 |
  11. | Reviewer | GPT-6.1 Sol High | 从全新上下文独立检查稳定产物;需要留档时保存 Markdown 审查报告。 |
  12. | ExpertAdvisor | 模型按次选择 | 为复杂决策制定方案,或在主 Agent 难以胜任时执行建模与复杂计算机自动化;也可处理反复未解决的问题。 |
  13. Explorer 默认请求 Fast;其他角色沿用主 Agent 的速度档。GPT-6 Fast 可用时,额度消耗为 Standard 的 2.5 倍,实际生效档位以子 Agent 运行记录为准。
  14. Skill 内置 [Explore](./skills/team-mode/references/explore.md) 与 [Simplify](./skills/team-mode/references/simplify.md):前者定位大型代码库中的相关实现,后者按请求或在提交前检查改动的复杂度。子 Agent 数量由独立问题或审查视角决定;主 Agent 处理发现并完成验收。
  15. 主 Agent 负责拆解用户任务,决定每个子 Agent 的具体问题或交付结果,以及各部分如何衔接。派发时只交代该部分所需的背景、范围和约束;文件位置、故障现象和过往尝试只是线索。子 Agent 在分配的范围内自行选择做法,不重新拆解整个任务。默认以 `fork_turns="none"` 派发;只有 Executor 确实依赖最近对话中的决定时才继承少量相关回合。ExpertAdvisor 不固定模型,由主 Agent 按次选择。子 Agent 提示词与 Skill 调度指令统一使用英语。
  16. ## 调度边界
  17. - Explorer 只做大型代码库的文件定位。少量文件查找和普通资料调研由主 Agent 直接处理。
  18. - Executor 只修改分配给自己的目标;并行任务之间不共享写入所有权。
  19. - Reviewer 可以追查与目标相关的重要证据,不预设必须找到某个问题;需要留档时写 Markdown 报告,保持被审查的产物原样。
  20. - 子 Agent 不继续派发 Agent。主 Agent 检查证据、改动和验收结果后才接受交付。
  21. 当前 Codex 有内置的通用 `default` Agent。本仓库另提供**可选**的 [`default.toml`](./agents/default.toml) 哨兵:GPT-6 Luna Low,安装后会覆盖内置 `default`,拒绝漏传角色的派发。Team Mode 不依赖它。个人哨兵会影响其他 Codex 任务,因此默认安装只复制四个工作角色;需要严格拦截时再单独安装。已有哨兵可移到 `~/.codex/agents-disabled/` 可恢复地停用。
  22. ## 安装
  23. ```bash
  24. npx skills add oil-oil/codex-team-mode
  25. ```
  26. Skill 和角色配置分开安装。将 [`agents/`](./agents) 中的 `Explorer.toml`、`Executor.toml`、`Reviewer.toml`、`ExpertAdvisor.toml` 复制到 `~/.codex/agents/`;只给一个项目使用时,复制到该项目的 `.codex/agents/`。角色未立即出现时,新建 Codex 任务或重启。详见[角色配置说明](./skills/team-mode/references/custom-agents.md)。
  27. ```text
  28. 使用 $team-mode 完成任务。只派发有明确收益的子 Agent,主 Agent 负责最终验收。
  29. ```
  30. ## 诊断
  31. `current_model.py` 按需从本地任务日志读取主 Agent 实际模型;`usage_by_model.py` 统计本地保留会话的模型和用量。日志可能不完整,费用按注明日期的 Standard 费率估算,不能当作账单。
  32. ```bash
  33. python3 skills/team-mode/scripts/current_model.py
  34. python3 skills/team-mode/scripts/usage_by_model.py --days 7 --by-agent --json
  35. python3 -m unittest discover -s tests
  36. ```
  37. 现行 Codex 的自定义角色 TOML 中固定的模型与思考档会优先于派发时传入的值,因此按次选模使用不固定模型的 ExpertAdvisor;参见[官方子 Agent 文档](https://learn.chatgpt.com/docs/agent-configuration/subagents#custom-agents)。
  38. <p align="center">
  39. <a href="https://github.com/oil-oil/beautify-github-readme"><img src="./assets/readme/made-with-beautify.svg" width="300" alt="README 使用 beautify-github-readme 制作"></a>
  40. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.