插件工厂

创建Claude Code插件和技能的综合工具包

概述

插件工厂提供了创建、开发和分发Claude Code插件所需的一切。无论您是构建简单的命令插件还是包含技能、代理、钩子和MCP服务器的复杂系统，此插件都会引导您完成整个过程。

内容概览

该插件包含两个互补的技能：

1. 插件创建者

用于创建和管理Claude Code插件的主要技能。

在以下情况下使用此技能：

• 从零开始创建新插件
• 理解插件结构和组件
• 向插件添加命令、代理、钩子或MCP服务器
• 了解插件分发和市场
• 排查插件问题

主要功能：

• 完整的插件创建工作流程
• 构建脚本（init_plugin.py）生成插件结构
• 全面的参考文档
• 测试和调试指南
• 分发策略

2. 技能创建者

专门用于创建Agent技能（可以独立存在或作为插件的一部分）的技能。

在以下情况下使用此技能：

• 创建新的Agent技能
• 将技能添加到现有插件中
• 理解技能结构和最佳实践
• 打包和验证技能

主要功能：

• 原始Anthropic技能创建者的技能创建工作流程
• 构建脚本（init_skill.py）生成技能结构
• 验证和打包工具
• 关于Agent技能规范的参考文档

安装

从GitHub安装

# 在Claude Code中
/plugin marketplace add anthropics/skills
/plugin install plugin-factory@anthropic-agent-skills

从本地目录安装（开发）

# 克隆此仓库
git clone <repo-url>

# 在Claude Code中
/plugin marketplace add ./path/to/plugin-factory
/plugin install plugin-factory@marketplace-name

使用方法

创建新插件

只需让Claude为您创建一个插件：

创建一个名为“my-tools”的插件，用于团队开发工作流

Claude将使用插件创建者技能引导您完成以下步骤：

1. 定义插件的目的
2. 选择组件（命令、代理、技能、钩子、MCP）
3. 使用init_plugin.py构建结构
4. 创建并配置组件
5. 本地测试
6. 分发选项

创建新技能

请求Claude为您创建一个技能：

创建一个新的PDF处理技能

Claude将使用技能创建者技能帮助您：

1. 正确地构建技能
2. 生成带有正确前言的SKILL.md文件
3. 组织支持资源（脚本、参考资料、资产）
4. 验证并打包技能

参考文档

两种技能都包括全面的参考文档：

插件创建者参考：

• 插件概述和快速入门
• 完整的插件技术规格
• 斜杠命令指南
• 子代理配置
• 钩子参考
• MCP集成指南
• 插件市场

技能创建者参考：

• Agent技能规范
• 额外的Agent技能文档

组件概述

技能

两种技能位于skills/目录下：

• plugin-creator/ - 主要插件创建技能
• skill-creator/ - 技能创建技能

脚本

每个技能的scripts/目录下的实用脚本：

插件创建者脚本：

• init_plugin.py - 构建新的插件结构

技能创建者脚本：

• init_skill.py - 构建新的技能结构
• package_skill.py - 打包技能以供分发
• quick_validate.py - 验证技能结构

要求

• Claude Code 1.0或更高版本
• Python 3.6+（用于构建脚本）
• 对命令行工具的基本熟悉

开发

要修改或扩展此插件：

1. 克隆仓库
2. 修改技能或脚本
3. 使用开发市场进行本地测试
4. 提交改进的拉取请求

架构

plugin-factory/
├── .claude-plugin/
│   └── plugin.json                 # 插件元数据
├── skills/
│   ├── plugin-creator/
│   │   ├── SKILL.md               # 插件创建工作流程
│   │   ├── references/            # 7个全面文档
│   │   └── scripts/
│   │       └── init_plugin.py     # 插件构建
│   └── skill-creator/
│       ├── SKILL.md               # 技能创建工作流程
│       ├── LICENSE.txt
│       ├── references/
│       │   ├── agent_skills_spec.md
│       │   └── additional/
│       │       └── Agent Skills.md
│       └── scripts/
│           ├── init_skill.py      # 技能构建
│           ├── package_skill.py   # 技能打包
│           └── quick_validate.py  # 验证
└── README.md

示例

示例1：创建团队工具插件

创建一个名为“team-tools”的插件，包含：
- 用于部署工作流的/deploy命令
- 用于PR审查的code-reviewer代理
- 文件编辑后运行linters的钩子

示例2：向现有插件添加技能

向我现有的dev-tools插件添加一个新的API文档技能

示例3：理解插件组件

解释插件中的命令、技能和代理之间的区别

最佳实践

1. 从简单开始：从一两个组件开始，按需扩展
2. 使用构建脚本：始终使用init_plugin.py和init_skill.py脚本
3. 本地测试：开发期间使用本地市场
4. 彻底记录：包含清晰的README和示例
5. 正确版本化：遵循语义版本化
6. 逻辑组织：将相关组件分组在一起

故障排除

常见问题及解决方案：

插件未加载：

• 验证.claude-plugin/plugin.json语法
• 检查组件目录是否位于插件根目录
• 使用claude --debug查看加载错误

技能未激活：

• 确保SKILL.md具有正确的YAML前言
• 检查description字段是否具体且可操作
• 验证技能目录是否位于插件根目录下的skills/中

脚本未执行：

• 检查文件权限（chmod +x script.sh）
• 验证路径使用${CLAUDE_PLUGIN_ROOT}
• 首先独立测试脚本

贡献

欢迎贡献！请：

1. 彻底测试您的更改
2. 更新文档
3. 遵循现有的代码风格
4. 为新特性包含示例

许可

Apache 2.0

致谢

• 技能创建者基于原始Anthropic技能创建者
• 插件创建者专门为这个插件创建
• 参考文档来自官方Claude Code文档

支持

对于问题或疑问：

• 查看每个技能中包含的全面参考文档
• 查阅官方Claude Code文档
• 在仓库中打开一个问题

版本历史

1.0.0（初始发布）

• 包含完整工作流程的插件创建者技能
• 技能创建者技能（来自Anthropic）
• init_plugin.py构建脚本
• 全面的参考文档
• 示例模板和最佳实践