Claude 代码技能与代理工厂

一套全面的工具集，用于大规模生成可直接投入生产的 Claude 技能和 Claude 代码代理。该仓库提供了模板、示例以及强大的提示工程系统，帮助您在所有平台上为 Claude AI 创建自定义技能和专业代理。

🚀 快速入门（3 种捷径）

捷径 1：交互式构建器（最快）

我想构建一些东西

factory-guide 代理会询问您的需求，并将其委派给专业指南。

捷径 2：使用斜杠命令

/build skill              # 交互式技能构建器
/build agent              # 交互式代理构建器
/build prompt             # 交互式提示构建器
/build hook               # 交互式钩子构建器

捷径 3：使用现成技能

# 安装提示工厂（69 个专业预设）
cp -r generated-skills/prompt-factory ~/.claude/skills/

# 向 Claude 提问
“我需要一个关于[角色名称]的提示”

---

📋 内置命令

本工具包包含 10 个斜杠命令 和 5 个交互式代理，以简化您的工作流程：

工作流命令

命令	目的	示例
/build	交互式构建器（技能/代理/提示/钩子）	/build skill 或 /build hook
/build-hook	构建 Claude 代码钩子（问答、别名）	/build-hook
/validate-output	验证生成的输出 + 自动 ZIP	/validate-output hook [路径]
/install-skill	将技能安装到 Claude 代码中	/install-skill [路径]
/install-hook	将钩子安装到设置中	/install-hook [路径] [user|project]
/test-factory	运行测试示例	/test-factory
/factory-status	检查系统状态（所有工厂）	/factory-status
/sync-agents-md	从 CLAUDE.md 生成 AGENTS.md	/sync-agents-md
/codex-exec	执行 Codex CLI 命令	/codex-exec analysis "task"
/sync-todos-to-github	将 TodoWrite 任务转换为 GitHub 问题	/sync-todos-to-github "Sprint 12"

交互式指南代理

代理	目的	激活方式
factory-guide	协调器 - 委托给专家	“我想构建一些东西”
skills-guide	构建 Claude 技能（4-5 个问题）	“构建一个技能”
prompts-guide	使用提示工厂（69 个预设）	“生成一个提示”
agents-guide	构建 Claude 代码代理（5-6 个问题）	“创建一个代理”
hooks-guide	构建 Claude 代码钩子（5-7 个问题）	“构建一个钩子”

完整文档请参阅 .claude/agents/README.md 和 .claude/commands/README.md。

---

🎯 主要功能

1. 技能工厂

生成完整的、可用于生产的 Claude 技能，包括：

• 格式正确的 SKILL.md 文件，带有 YAML 前言
• 必要时附带 Python 实现文件
• 示例输入输出数据
• 完整的文档和使用指南
• 易于分发的 ZIP 包

模板：SKILLS_FACTORY_PROMPT.md 捷径：/build skill 或 “我想构建一个技能”

2. 代理工厂

创建专业化的 Claude 代码代理，具备以下特性：

• 增强的 YAML 前言（名称、描述、工具、模型、颜色、领域、专长）
• 支持 MCP 集成
• 自动调用能力
• 工具访问配置

模板：AGENTS_FACTORY_PROMPT.md 捷径：/build agent 或 “我想创建一个代理”

3. 提示工厂

为任何角色生成超级提示，包括：

• 69 个跨 15 个领域的专业预设
• 多种输出格式（XML、Claude、ChatGPT、Gemini）
• 7 点质量验证
• 核心模式与高级模式

现成技能：generated-skills/prompt-factory/ 捷径：安装技能后，只需说“我需要一个关于[角色]的提示”。

4. 钩子工厂

生成用于工作流自动化的 Claude 代码钩子，具备以下特点：

• 7 种事件类型（会话开始、工具使用后、子代理停止等）
• 安全性验证（工具检测、静默失败、无破坏性操作）
• 针对不同语言的模板（Python/Black、JS/Prettier、Rust/rustfmt、Go/gofmt）
• 交互式问答生成（5-7 个问题）
• 安装前自动安全检查

模板：HOOKS_FACTORY_PROMPT.md 实现：generated-skills/hook-factory/ 捷径：/build hook 或 “我想构建一个钩子”。

5. 斜杠命令工厂

创建自定义斜杠命令，包括：

• 17 种预设命令（商业、开发、文档、分析）
• 三种官方 Anthropic 模式（简单、多阶段、代理风格）
• 全面的四层验证
• 自动生成的 bash 权限

模板：MASTER_SLASH_COMMANDS_PROMPT.md 捷径：直接使用模板，或通过 /build 命令结合自定义工作流。

6. Codex CLI 桥接

实现 Claude 代码与 Codex CLI 的互操作性，具备以下功能：

• 自动将 CLAUDE.md 转换为 AGENTS.md
• 基于引用的架构（无重复）
• 安全机制和自动验证
• 支持跨工具团队协作

技能：generated-skills/codex-cli-bridge/ 捷径：运行 /sync-agents-md 以同步文档。

---

🔄 完整工作流示例

示例 1：2 分钟内构建一个技能

# 第一步：启动构建器
/build skill

# 第二步：回答 4-5 个问题
# （Claude 会引导您完成整个过程）

# 第三步：验证输出
/validate-output

# 第四步：安装
/install-skill

# 完成！您的技能已准备就绪

示例 2：生成跨平台提示

# 第一步：安装提示工厂（仅需一次）
cp -r generated-skills/prompt-factory ~/.claude/skills/

# 第二步：向 Claude 提问
“我需要一个关于高级 DevOps 工程师的提示”

# 第三步：回答 5-7 个问题
# （选择格式：XML、Claude、ChatGPT 或 Gemini）

# 完成！复制并粘贴到您喜欢的 LLM 中

示例 3：为 Codex CLI 团队同步文档

# 第一步：确保项目中存在 CLAUDE.md
# （若缺失，请先运行 /init）

# 第二步：为 Codex CLI 用户生成 AGENTS.md
/sync-agents-md

# 第三步：提交到仓库
git add AGENTS.md
git commit -m "docs: 添加 AGENTS.md 以兼容 Codex CLI"

# 完成！Codex CLI 用户现在可以参考您的技能

---

📁 仓库结构

claude-code-skills-factory/
├── README.md                              # 本文件
├── CLAUDE.md                              # 仓库使用指南
├── AGENTS.md                              # Codex CLI 文档（自动生成）
├── CHANGELOG.md                           # 版本历史
├── .claude/
│   ├── agents/                            # 5 个交互式引导代理
│   │   ├── factory-guide.md              # 协调器
│   │   ├── skills-guide.md               # 技能构建器
│   │   ├── prompts-guide.md              # 提示词生成器
│   │   ├── agents-guide.md               # 代理创建者
│   │   └── hooks-guide.md                # 钩子构建器
│   └── commands/                          # 8 个斜杠命令
│       ├── build.md                       # 交互式构建工具
│       ├── build-hook.md                  # 钩子构建工具
│       ├── validate-output.md             # 验证 + 打包 ZIP
│       ├── install-skill.md               # 安装指南
│       ├── test-factory.md                # 测试运行器
│       ├── factory-status.md              # 状态检查器
│       ├── sync-agents-md.md              # CLAUDE.md → AGENTS.md
│       └── codex-exec.md                  # Codex CLI 执行器
├── claude-skills-examples/                # 3 个参考实现
├── documentation/
│   ├── references/                        # Anthropic 官方示例
│   └── templates/                         # 4 个工厂提示模板
├── generated-skills/                      # 9 个生产就绪技能
│   ├── aws-solution-architect/            # AWS 架构与 IaC
│   ├── content-trend-researcher/          # 多平台内容研究
│   ├── ms365-tenant-manager/              # Microsoft 365 管理
│   ├── agent-factory/                     # 代理生成系统
│   ├── prompt-factory/                    # 提示词生成利器
│   ├── slash-command-factory/             # 斜杠命令生成
│   ├── codex-cli-bridge/                  # Claude Code ↔ Codex CLI 桥接
│   ├── hook-factory/                      # Claude Code 钩子自动化
│   └── claude-md-enhancer/                # CLAUDE.md 生成与维护
├── generated-agents/                      # 专用代理
│   └── claude-md-guardian/                # CLAUDE.md 维护代理
└── generated-commands/                    # 自定义斜杠命令
    └── enhance-claude-md/                 # CLAUDE.md 增强命令

---

🎁 包含的生产级技能

所有技能均包含完整实现、文档、示例及分发包：

1. AWS 解决方案架构师（53 KB）

无服务器架构、IaC 模板、成本优化

• 查看技能

2. 内容趋势研究员（35 KB）

多平台趋势分析、SEO 优化大纲

• 查看技能

3. Microsoft 365 租户管理员（40 KB）

M365 管理、PowerShell 自动化

• 查看技能

4. 代理工厂（12 KB）

通过增强版 YAML 生成自定义 Claude Code 代理

• 查看技能

5. 提示词工厂（427 KB）

69 个专业预设、多格式输出、7 点验证

• 查看技能
• 最受欢迎：优先安装以立即提升生产力

6. 斜杠命令工厂（26 KB）

17 个预设、Anthropic 官方模式、4 层验证

• 查看技能

7. Codex CLI 桥接（48 KB）

Claude Code ↔ Codex CLI 互操作性、AGENTS.md 生成

• 查看技能
• 支持跨工具团队协作

8. 钩子工厂 v2.0（92 KB）🆕

通过交互式 7 问问答构建自定义 Claude Code 钩子，具备自动安装和增强验证功能

• 查看技能
• v2.0：10 个生产模板、Python + Bash 自动化安装程序、敏感信息检测、事件特定验证

9. CLAUDE.md 增强器（50 KB）🆕

以 100% 原生格式合规的方式分析、生成并增强 CLAUDE.md 文件，提供交互式初始化和自动维护功能

• 查看技能
• 生态系统：技能 + 代理 + 斜杠命令，实现 CLAUDE.md 生命周期的全面管理
• 特性：交互式工作流、质量评分（0-100）、模块化架构、7 个内置示例
• 配套代理：claude-md-guardian - 背景维护，支持自动同步
• 斜杠命令：/enhance-claude-md - 初始化或增强 CLAUDE.md 文件

---

💡 参考示例

三个功能完备的示例技能，展示了不同模式：

• 财务报表分析 - 计算引擎 + 解读层
• 财务模型创建 - DCF 估值、敏感性分析、蒙特卡洛模拟
• 品牌规范应用 - 企业品牌应用

详细实现请参阅 claude-skills-examples/。

---

✨ 核心特性

• 生产就绪输出：规范的 YAML 前置内容、类型注解 Python 代码、错误处理
• 交互式工作流：通过 4 个专业代理引导对话流程
• 内置自动化：7 个用于常见任务的斜杠命令
• 完整打包：包含文档、示例和 ZIP 文件
• 智能检测：自动判断何时需要 Python 代码，何时仅需提示词
• 多格式支持：支持 XML、Claude、ChatGPT、Gemini 等多种输出格式
• 官方模式：基于 Anthropic 的文档和示例
• 跨平台：兼容 Claude AI（桌面/浏览器）、Claude Code 和 API
• 跨工具兼容性：可与 OpenAI Codex CLI 桥接

---

📚 文档

• 技能指南：documentation/references/claude-skills-instructions.md - Anthropic 完整文档
• 代理指南：documentation/references/claude-agents-instructions.md - Anthropic 完整文档
• Codex CLI 参考：documentation/references/openai-codex-cli-instructions.md - OpenAI Codex CLI 完整文档
• 斜杠命令示例：documentation/references/ - Anthropic 官方示例
• 工厂模板：documentation/templates/ - 4 个生成模板
• 项目指南：CLAUDE.md - 仓库结构和工作流程
• 交互式代理：.claude/agents/README.md - 代理使用指南
• 斜杠命令：.claude/commands/README.md - 命令参考

---

🔗 补充资源

Claude Code Tresor - alirezarezvani/claude-code-tresor

• 开箱即用的开发工作流工具（8种技能、8个代理、4条斜杠命令）
• 通过经过验证的模式立即提升生产力
• 一键安装

Claude 技能库 - alirezarezvani/claude-skills

• 涵盖8个专业领域的37+项特定领域生产级技能
• 营销、产品、工程及高层管理咨询方面的专业知识
• 经过实战检验、ROI显著的框架

它们如何协同工作：

• 本工厂：为独特需求创建自定义技能/代理
• Tresor：部署现成的开发工作流工具
• 技能库：采用特定领域的专业技能

---

🌐 外部资源

• Anthropic 技能文档：https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview
• 技能市场：https://github.com/anthropics/skills
• 工程博客：https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
• API 文档：https://docs.claude.com/en/api/skills-guide

---

🤝 贡献方式

这是一个参考性仓库。如需贡献：

1. 分叉该仓库
2. 将新的示例技能添加到 claude-skills-examples/ 目录下
3. 确保技能符合格式规范
4. 包含完整的实现代码及示例
5. 提交拉取请求

---

📄 许可证

本仓库提供用于创建 Claude 技能的示例和模板。您使用这些模板生成的技能可按您的意愿自由使用。

---

📊 版本信息

当前版本：1.4.0
最后更新：2025年10月30日
兼容性：Claude 技能（所有平台）、Claude Code 代理、Claude Code 斜杠命令

最新变更（v1.4.0）：

• ✨ 新增 Codex CLI Bridge 技能，实现 Claude Code 与 OpenAI Codex CLI 的互操作
• ✨ 新增 /sync-agents-md 和 /codex-exec 斜杠命令
• ✨ 增加 AGENTS.md 自动生成功能，以提升跨工具兼容性
• 📝 整合 README.md，更聚焦于核心功能与快捷方式
• 🚀 优化快速入门，新增3个快捷方式及工作流示例

上一版本变更（v1.3.0）：

• 新增 MASTER_SLASH_COMMANDS_PROMPT.md 模板，采用 Anthropic 官方模式
• 斜杠命令工厂 v2.0，包含17个预设及4层验证机制
• 提供三种官方命令模式（简单型、多阶段型、代理风格）

上一版本变更（v1.2.0）：

• 新增提示词工厂技能，涵盖15个领域的69个预设
• 支持多种输出格式（XML/Claude/ChatGPT/Gemini）
• 引入7点质量验证体系

详情请参阅：CHANGELOG.md 以获取完整版本历史

---

📈 星标趋势图

---

准备开始构建了吗？ 试试上面的快捷方式之一，或者浏览工厂模板，即可开始生成可用于生产的技能、代理、提示词或斜杠命令！

Claude Code Skills & Agents Factory 快速上手指南

本工具是一套用于规模化生成生产级 Claude Skills 和 Claude Code Agents 的综合工具箱，提供模板、示例及强大的提示词工程系统。

环境准备

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

• 操作系统：macOS, Linux 或 Windows (WSL2 推荐)
• 核心依赖：已安装并配置好 Claude Code CLI 工具
• 前置知识：熟悉基本的终端命令操作
• 目录结构：确保项目根目录下存在 .claude 配置文件夹（若不存在，运行 claude 初始化项目即可生成）

注意：本项目主要依赖本地文件系统和 Claude Code 的原生功能，无需额外安装 Python 包或 Node.js 依赖即可使用核心构建功能。

安装步骤

本项目采用“技能复制”模式，无需复杂的编译过程。只需将预生成的技能包复制到 Claude 的技能目录即可。

1. 克隆或下载项目

git clone https://github.com/your-repo/claude-code-skill-factory.git
cd claude-code-skill-factory

2. 安装核心技能库（推荐）

最快速的方式是安装包含 69 个专业预设的 Prompt Factory 技能：

cp -r generated-skills/prompt-factory ~/.claude/skills/

3. 验证安装

启动 Claude Code 并询问：

I need a prompt for [role name]

如果 Claude 能识别并调用相关技能，即表示安装成功。

基本使用

本工具提供三种快捷启动方式，适合不同场景。

方式一：交互式构建（最快上手）

直接告诉 Claude 你想构建什么，内置的 factory-guide 代理会自动引导你完成流程。

操作步骤：

1. 在终端输入 claude 进入交互模式。
2. 输入以下指令：

   I want to build something
   

3. 根据 Claude 的提问（通常 4-7 个问题）回答需求，它将自动委托给专家代理（如技能构建器、代理构建器等）生成代码。

方式二：使用斜杠命令（精准控制）

如果你明确知道要构建的类型，可以直接使用内置的 Slash Commands。

常用命令示例：

• 构建技能 (Skill):

  /build skill
  

• 构建智能体 (Agent):

  /build agent
  

• 构建钩子 (Hook):

  /build hook
  

• 构建提示词 (Prompt):

  /build prompt
  

完整工作流示例（构建一个技能）：

# 1. 启动构建器
/build skill

# 2. 跟随指引回答问题 (Claude 会引导你)

# 3. 验证输出并打包
/validate-output

# 4. 安装到本地
/install-skill

方式三：直接使用现成技能

项目 generated-skills 目录下包含了多个开箱即用的生产级技能，你可以按需复制使用。

示例：安装 AWS 架构师技能

cp -r generated-skills/aws-solution-architect ~/.claude/skills/

安装后，即可在对话中直接调用该技能处理 Serverless 架构或 IaC 模板任务。

高级功能：Codex CLI 协同

如果你团队中同时使用 Claude Code 和 Codex CLI，可以使用同步命令生成兼容文档：

/sync-agents-md

此命令会将 CLAUDE.md 自动转换为 AGENTS.md，确保跨工具协作无障碍。