CodexSkills

一套用于规划、文档访问、前端开发和浏览器自动化的 Codex/智能体 (Agent) 技能集合。

可用技能

智能体编排

• planner: 创建全面的、分阶段的实施计划，包含冲刺和原子任务。用于规划实施、分解功能或创建结构化路线图。
• plan-harder: 增强型规划变体，用于更详细的分析和任务分解。
• parallel-task: 通过启动多个并行子智能体同时完成任务来执行计划文件。需要来自 planner 的现有计划文件。
• llm-council: 多智能体编排系统，用于规划复杂任务。生成多个 AI 规划器（Claude, Codex, Gemini）以生成独立计划，然后使用评审智能体综合最佳方案。包括实时 Web 用户界面 (UI) 用于监控进度并交互式优化计划。

文档访问

• ctx7old: 通过 Context7 CLI 获取最新的库文档。
• openai-docs-skill: 通过 CLI 使用 OpenAI Docs 模型上下文协议 (MCP) 服务器查询 OpenAI 开发者文档。
• markdown-url: 在需要访问的任何网站前缀加上 https://markdown.new/ 以获得干净、Markdown 友好的视图。
• read-github: 通过 gitmcp.io MCP 服务读取和搜索 GitHub 仓库文档。将 github.com/owner/repo URL (统一资源定位符) 转换为 gitmcp.io/owner/repo 以便 大语言模型 (LLM) 友好地访问仓库。

前端与设计

• frontend-design: 独特的系统设计指导（源自 Anthropic）。
• frontend-responsive-ui: 响应式 UI 标准（源自 Anthropic）。
• vercel-react-best-practices: React/Next.js 性能指导（源自 Vercel）。

Codex 工具集

• create-hook: 创建或更新全局或项目范围的 Codex 钩子 (Hook)。引导用户完成范围、钩子类型和行为，然后编写钩子配置和脚本。
• pluginstaller: 从 GitHub 仓库安装 Codex 插件到仓库或个人市场。处理插件发现、验证和市场注册。
• role-creator: 创建和更新自定义 Codex 智能体为独立的 TOML 文件。收集所需输入并将智能体定义写入全局或项目范围。

浏览器自动化

• gemini-computer-use: Gemini 2.5 Computer Use 浏览器控制智能体技能（Playwright + 安全确认循环）。
• agent-browser: Vercel Labs 提供的基于 Rust 的快速无头浏览器自动化 CLI，具有适用于 AI 智能体的快照/动作模式。

安装

使用 skills.sh 命令行界面 (CLI) 安装技能：

# List available skills before installing
npx skills add am-will/codex-skills --list

# Install specific skills to user scope (global)
npx skills add am-will/codex-skills --skill planner --skill context7 -g

# Install all skills interactively (prompts for selection)
npx skills add am-will/codex-skills -g

# Install to specific agents
npx skills add am-will/codex-skills --skill planner -a claude-code -a codex -g

# Install to current project (instead of global)
npx skills add am-will/codex-skills --skill planner

# Non-interactive install (skip prompts)
npx skills add am-will/codex-skills --skill planner -g -y

CLI 选项：

标志	用途
-g, --global	安装到用户目录（所有项目的全局范围）
-a, --agent <agents...>	针对特定智能体（claude-code, codex 等）
-s, --skill <skills...>	按名称安装特定技能
-l, --list	列出可用技能而不进行安装
-y, --yes	跳过确认提示

其他命令：

npx skills list          # 显示已安装的技能
npx skills remove <name> # 卸载技能
npx skills update        # 更新所有已安装的技能

关于浏览器工具的说明：该仓库包含两个浏览器自动化工具（gemini-computer-use 和 agent-browser）。你不需要同时安装两者——选择最适合你工作流程的一个。我推荐 agent-browser 以获得速度和简洁性。

关于 Context7 的说明：ctx7old 技能需要在 CONTEXT7_API_KEY 中设置 Context7 API 密钥。请参阅 skills/ctx7old/.env.example 进行设置。

关于 Gemini Computer Use 技能的说明：此技能需要 GEMINI_API_KEY。请让 Codex 帮助你设置它。

关于 llm-council 的说明：此技能需要多个提供商（Claude/Anthropic, OpenAI for Codex, Google for Gemini）的 API 密钥或活跃订阅。在技能目录中运行 ./setup.sh 进行配置。包括一个实时 Web UI，会在规划会话期间自动启动。

---

Codex 钩子目录

hooks/ 目录包含 50 个即插即用的 Codex 钩子 (Hook) 包目录，源自 davila7/claude-code-templates 并适配了 Codex 事件模型。

类别：

类别	包数量	示例
automation	18	Slack/Discord/Telegram 通知、Vercel 自动部署、依赖检查器、变更日志记录器
development-tools	8	调试窗口、保存时 lint、智能格式化、文件备份、worktree ghostty
git	3	常规提交、防止直接推送、验证分支名称
git-workflow	2	自动 git-add、智能提交
monitoring	2	停止时桌面通知、LangSmith 追踪
performance	2	性能预算守卫、性能监控器
post-tool	4	格式化 JS/Python 文件、git-add 更改、更改后运行测试
pre-tool	4	编辑前备份、console-log 清理器、bash 前通知、更新搜索年份
quality-gates	3	计划门控、范围守卫、TDD 门控
security	4	危险命令阻止器、文件保护、秘密扫描器、安全扫描器
testing	1	测试运行器

安装一个包：

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

手动安装：将包的 hooks.json 复制到 <repo>/.codex/hooks.json，将其 .codex/hooks/ 脚本复制到 <repo>/.codex/hooks/，然后重启 Codex。

有关兼容性、测试框架和包结构的完整详情，请参见 hooks/README.md。

---

Codex 自定义多智能体

agents/ 目录包含 Codex 的自定义多智能体配置。这些基于 TOML 的智能体 (Agent) 定义提供专用角色（架构师、前端、后端、安全等）和工作层级的并行任务执行。与 Codex 配合使用以启动专为你的工作流定制的目的构建智能体。

codex-skills 快速上手指南

codex-skills 是一个专为 Codex/Agent 设计的技能集合，提供规划、文档访问、前端开发及浏览器自动化等功能。本指南将帮助您快速集成并使用这些技能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 运行环境：已安装 Node.js 和 npm（用于执行 npx 命令）。
• 目标平台：适用于 Codex 及其相关 Agent 环境。
• API 密钥（按需配置）：
  • 使用 ctx7old 技能需设置 CONTEXT7_API_KEY。
  • 使用 gemini-computer-use 技能需设置 GEMINI_API_KEY。
  • 使用 llm-council 技能需配置多个提供商的 API Key（Claude/OpenAI/Gemini）。

提示：若网络环境受限，建议在使用 npx 前配置国内 npm 镜像以提升下载速度。

安装步骤

1. 安装核心技能包

使用 skills.sh CLI 工具进行安装。默认安装到用户全局范围（所有项目可用）：

# 交互式安装所有技能
npx skills add am-will/codex-skills -g

# 仅安装特定技能（例如 planner）
npx skills add am-will/codex-skills --skill planner -g

# 非交互式安装（跳过确认）
npx skills add am-will/codex-skills --skill planner -g -y

常用参数说明：

• -g, --global：安装到用户目录（全局）。
• -a, --agent <agents...>：指定目标 Agent（如 claude-code, codex）。
• -s, --skill <skills...>：指定要安装的特定技能名称。
• -l, --list：列出可用技能而不安装。

2. 安装 Hooks 工具包（可选）

仓库包含 50 个预配置的 Codex Hooks 包，可用于自动化工作流。

# 安装特定分类下的 Bundle
python3 hooks/aitmpl-codex/install-bundle.py hooks/aitmpl-codex/<category>/<bundle> <target-repo>

3. 管理已安装技能

# 查看已安装的技能
npx skills list

# 卸载特定技能
npx skills remove <name>

# 更新所有已安装技能
npx skills update

基本使用

1. 验证安装

安装完成后，可在 Agent 中直接调用已集成的技能名称。例如，在 Codex 会话中使用规划技能：

planner: Create a roadmap for implementing a new feature...

2. 浏览器自动化选择

仓库提供了两种浏览器自动化工具，二选一即可：

• agent-browser：基于 Rust 的无头浏览器，速度快，推荐首选。
• gemini-computer-use：Gemini 2.5 计算机使用技能。

3. 自定义 Agent

如需使用多智能体协作，可参考 agents/ 目录中的 TOML 配置文件，将其加载至 Codex 以启动专用角色（如架构师、前端专家等）。

---

注意：部分技能依赖外部 API 服务，请确保已在环境变量中正确配置相应的密钥，否则可能导致技能无法正常工作。