SkillMap

Sep 14, 2026

用 CodexSkills 把一份计划拆给多个并行 Agent 执行

一个 1033 星的 Codex 技能合集：先把功能拆成分阶段计划，再把任务分发给并行子 Agent 执行，还附带 51 个 hook bundle 的目录。

#tutorial#agent-tools#ai-agents#developer-tools#workflow

有些功能对单个 Agent 会话来说太大了：规划、后端、前端，然后还要验证。CodexSkills 把这类工作一分为二——一个 planner 技能负责写出分阶段的实施计划，一个执行技能负责用并行子 Agent 执行这份计划文件。

为什么这个 Skill 重要

CodexSkills（am-will/codex-skills，最新排行榜快照中 1033 星）是一组覆盖规划、文档访问、前端开发和浏览器自动化的 Agent 技能。README 把技能分成六类：Agent Orchestration（编排）、Documentation Access（文档访问）、Prompting（提示词）、Frontend & Design（前端与设计）、Codex Tooling（Codex 工具）和 Browser Automation（浏览器自动化）。截至 9 月 14 日，仓库的 skills/ 目录里有 22 个技能文件夹，包括 planner、plan-harder、parallel-task 和 llm-council。同一次检查也发现一个问题：README 列出的 Context7 文档技能 ctx7old 当天并不在目录里，安装示例中的 --skill context7 参数也找不到对应文件夹——安装那一个之前，先列目录确认。

安装

按 README 记载的方式用 skills CLI 安装：

# 安装前先列出可用技能
npx skills add am-will/codex-skills --list

# 把规划组合安装到用户目录
npx skills add am-will/codex-skills --skill planner --skill parallel-task -g

用 -a claude-code -a codex 指定目标 Agent，用 -y 跳过确认提示。

实战：给网站加 OAuth 登录，不必拖成一个长会话

  1. 先做计划。让 Agent 规划这个功能：planner 会创建带冲刺（sprint）和原子任务的完整分阶段实施计划。需要更细的分析变体时用 plan-harder。
  2. 并行展开。parallel-task 通过启动多个并行子 Agent 同时完成任务来执行计划文件。它要求先有 planner 生成的计划文件——这两个技能是设计成一对的。
  3. 子 Agent 跑的时候顺带查文档。read-github 把 github.com/owner/repo 转换成 gitmcp.io/owner/repo，方便模型读取仓库文档；markdown-url 给任意网址加上 https://markdown.new/ 前缀，得到干净的 Markdown 视图。
  4. 浏览器里验证。agent-browser 是 Vercel Labs 出的 Rust 无头浏览器自动化 CLI，为 Agent 提供快照/操作（snapshot/act）模式。README 提到两个浏览器工具不必都装，并推荐 agent-browser，理由是速度和简单。
用 planner 规划给这个 Web 应用添加 OAuth 登录，然后用 parallel-task
执行这份计划文件。

遇到真正有争议的设计决策时，llm-council 会派出多个 AI 规划器（Claude、Codex、Gemini）各自生成独立计划，再由一个裁判 Agent 综合出最佳方案。它带一个规划会话中自动启动的实时 Web 界面，并且需要 Claude/Anthropic、OpenAI 和 Google 三家的 API key 或有效订阅——在技能目录里运行 ./setup.sh 完成配置。

Hook 目录

hooks/ 目录提供了另一层能力：51 个可安装的 Codex hook bundle，分 11 类，从 automation（18 个）和 security（4 个）到 testing（1 个）。README 记载的脚本化安装方式是（旁边也记载了手工复制安装的替代方案）：

python3 hooks/aitmpl-codex/install-bundle.py \
  hooks/aitmpl-codex/<category>/<bundle> <target-repo>

仓库还有一个 agents/ 目录，存放基于 TOML 的多 Agent 定义——架构师、前端、后端、安全等专门角色，以及用于并行任务执行的 worker 层级。

技巧

  • 安装前先跑 --list 看目录里实际有什么——README 列表和文件夹集合已经出现漂移（见上文 ctx7old）。
  • gemini-computer-use 需要 GEMINI_API_KEY；README 建议让 Codex 帮你完成配置。
  • parallel-task 需要先有计划文件——从 planner 开始，而不是直接上执行器。
  • hook bundle 是针对 Codex 事件模型适配的；兼容性细节看仓库里的 hooks/README.md。

何时不用这个 Skill

这些技能面向 Codex 风格的 Agent 工作流，hook 目录更是专门为 Codex hooks 编写——如果你的 Agent 不支持 Codex hooks，hook 目录并不适用。另外 llm-council 会让 API 开销在三家提供商上成倍增加；普通的 planner + parallel-task 组合才是更省钱的默认选择。

查看 排行榜 了解更多 skill。