alirezarezvani/claude-code-skill-factory · 上手攻略

  • 仓库：alirezarezvani/claude-code-skill-factory
  • 链接：https://github.com/alirezarezvani/claude-code-skill-factory
  • 分类：Claude Code · 开发者工具 · Agent 框架
  • 作者：Jay
  • 更新：2026-08-13

这是什么

Claude Code Skill Factory 是一个用自然语言交互构建生产级 Claude Skills、Claude Code Agents、自定义 Slash Commands 和 LLM Prompts 的开源工具包。

简单说：你要写一个 Claude Skill，不用从零憋文档，直接回答几个问题，Factory Agent 帮你生成完整的 SKILL.md + Python 实现 + 示例数据 + ZIP 分发包。

同时它自带 9 个可直接安装的生产级 Skills（含 Prompt Factory、Hook Factory、Agent Factory 等）和一套 Slash Commands（/build、/validate-output、/install-skill 等共 10 条）。

⚠️ 版本说明：README 提到 dev 分支有部分文档内容（如 documentation/templates/、generated-skills/），主分支可能不包含所有功能模块，建议同时查看 dev 分支。

解决什么问题

手动从头构建 Claude Skill 的痛点：

  • SKILL.md 格式复杂：YAML frontmatter + 描述结构不熟悉容易出错。
  • 不知道该问什么问题：Claude Code 不知道你做的是什么场景，生成出来的 skill 很泛泛。
  • 没有可参考模板：想做 MCP 集成 / 代码审查 / 内容生成，不知道从哪起步。
  • 发布和分发麻烦：写完 skill 不知道该怎么打包和安装。

Skill Factory 通过交互式 Builder Agent（4-7 个引导问题）+ Preset 模板库解决这个问题，生成结果可以直接安装到 Claude Code。

快速安装

方式一：直接 clone

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

方式二：安装现成 Skill（无需 clone）

# 安装 Prompt Factory（69 个专业预设）
cp -r generated-skills/prompt-factory ~/.claude/skills/
# 然后直接问 Claude："I need a prompt for Senior DevOps Engineer"

核心 Slash Commands（clone 后可用）

# 构建交互（skill / agent / prompt / hook）
/build

# 构建 Hook
/build-hook

# 验证输出并自动打包 ZIP
/validate-output hook [path]

# 安装 skill 到 Claude Code
/install-skill [path]

# 安装 hook 到 settings
/install-hook [path] [user|project]

# 运行测试示例
/test-factory

# 检查所有 Factory 状态
/factory-status

# CLAUDE.md → AGENTS.md 同步（Codex CLI 兼容）
/sync-agents-md

# 执行 Codex CLI 命令
/codex-exec analysis "task"

# TodoWrite → GitHub Issues 同步
/sync-todos-to-github "Sprint 12"

核心用法

构建一个 Skill（四步）

# Step 1：启动 Builder
/build skill

# Step 2：回答 4-5 个问题
# （Claude 引导你完成 skill 描述、场景、工具等）

# Step 3：验证输出
/validate-output

# Step 4：安装
/install-skill <output-path>

Builder Agent 会生成： - 格式正确的 SKILL.md（含 YAML frontmatter） - Python 实现文件（如果需要） - 示例输入/输出数据 - 完整使用文档 - ZIP 分发包

构建一个 Claude Code Agent（五六步）

/build agent
# 引导问题包括：名称、描述、工具权限、模型选择、配色、领域、专业级别

生成的 Agent 支持： - MCP 集成 - 自动调用（Auto-invocation） - 工具访问精细配置

使用 Prompt Factory（69 个预设）

# Step 1：一次性安装
cp -r generated-skills/prompt-factory ~/.claude/skills/

# Step 2：直接请求
"I need a prompt for a Senior DevOps Engineer"

# Step 3：选择格式（XML / Claude / ChatGPT / Gemini）
# + 选择级别（Core / Advanced）
# + 7-point 质量验证

覆盖 15 个领域，含： - 商业分析 - 开发 - 文档 - 架构设计 - 等等

构建 Claude Code Hooks

/build-hook
# 5-7 个引导问题，生成：
# - 7 种事件类型（SessionStart、PostToolUse、SubagentStop 等）
# - 安全验证（工具检测、静默失败、无破坏性操作）
# - 语言特定模板（Python/Black、JS/Prettier、Rust/rustfmt、Go/gofmt）

生成 Slash Commands

支持 17 种预设命令，涵盖商业/开发/文档/分析场景，基于 Anthropic 三种官方 Pattern（Simple / Multi-Phase / Agent-Style）生成。

项目结构

claude-code-skill-factory/
├── .claude/
│   ├── agents/              # 5 个交互式 Guide Agents
│   │   ├── factory-guide.md    # 调度器
│   │   ├── skills-guide.md     # Skills Builder
│   │   ├── prompts-guide.md    # Prompts Generator
│   │   ├── agents-guide.md     # Agents Creator
│   │   └── hooks-guide.md      # Hooks Builder
│   └── commands/            # 8 条 Slash Commands
│       ├── build.md
│       ├── build-hook.md
│       ├── validate-output.md
│       ├── install-skill.md
│       ├── test-factory.md
│       ├── factory-status.md
│       ├── sync-agents-md.md
│       └── codex-exec.md
├── documentation/
│   └── templates/           # 4 个 Factory Prompt 模板
├── generated-skills/         # 9 个可直接安装的生产级 Skills
│   ├── aws-solution-architect/
│   ├── content-trend-researcher/
│   ├── ms365-tenant-manager/
│   ├── agent-factory/
│   ├── prompt-factory/
│   ├── slash-command-factory/
│   ├── codex-cli-bridge/
│   └── ...
└── claude-skills-examples/  # 3 个参考实现

典型适用场景

场景 为什么用 Skill Factory
快速创建领域专用 Skill 回答几个问题，得到完整 SKILL.md
团队标准化 Skill 模板 统一生成的 skill 格式一致，便于维护
一键分发 69 种专业 Prompt Prompt Factory 预设，无需每次重写
自动化 Code Review Hook Hook Factory 生成 Black/Prettier/rustfmt 集成
Claude Code ↔ Codex CLI 协作 sync-agents-md 让两个工具共享同一套文档

坑与注意

  1. dev 分支依赖：README 中的 documentation/templates/ 和 generated-skills/ 链接指向 dev 分支，clone 默认分支可能不包含这些目录，完整使用需要切到 dev 分支。

  2. /build 命令依赖 CLAUDE.md 存在：某些 Builder 流程假设项目已有 CLAUDE.md，如果缺失需要先运行 /init 初始化。

  3. Prompt Factory 是"复制即用"而非"直接对话"：安装 Prompt Factory 后需要手动 cp -r 到 ~/.claude/skills/，不是 npm install 那种安装方式。

  4. /validate-output 生成的 ZIP 位置：默认输出到当前目录，CI/CD 集成时需要注意路径。

  5. Skill 生成的代码质量取决于引导问题的答案：如果回答过于模糊（如"我要一个通用的 skill"），生成结果也会很泛。建议先想清楚场景再启动 Builder。

  6. 与 Anthropic 官方 Agent Skills 的关系：Factory 生成的内容遵循 Anthropic 官方 Skills 规范，但本身不是 Anthropic 官方出品，生成结果需要自己测试验证。

  7. codex-exec 需要 Codex CLI：该命令需要本地安装 Codex CLI，不是 Claude Code 自带。

与同类对比

方案 定位 交互式构建 预设数量 代码生成
Skill Factory 交互式 Builder ✅ /build 9 个可直接用 ✅ SKILL.md + Python
Anthropic 官方 Skills 参考模板 ❌ 官方示例 ❌ 仅文档
claude-skills (alirezarezvani) 单 Skill 仓库 ❌ 单个 ❌ 仅文档
手动编写 SKILL.md 原始方式 ❌ 0 手动

Skill Factory 的核心优势是降低 Claude Skill 的制作门槛，让非专家也能快速产出结构正确、内容充实的 Skill。

一句话推荐结论

需要批量生成 Claude Skills、Agent 或专业领域 Prompts 的团队和个人，Skill Factory 是目前最完整的交互式解决方案；只需一两个简单 Skill 的话，直接参考官方规范手写 SKILL.md 也完全够用。

原始仓库：https://github.com/alirezarezvani/claude-code-skill-factory（dev 分支含完整模板）