SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场plugin-engineer

plugin-engineer

编程与开发

查看项目

更新于 10-16 07:44

技能介绍

用途

Plugin Engineer 用于把外部代码仓库转换为 Claude Code 插件，覆盖的对象类型包括 CLI 工具、库（libraries）和 MCP 服务器。其核心价值在于提供一条工程化的流水线，把“外部仓库”逐步转化为“可分发的插件”：

外部仓库 → 研究 → 勘察 → 模式 → 编码化 → 编写 → 打包 → 审计 → 插件

适用（when_to_use）的场景：

  • 将 CLI 工具转变为 Claude Code 插件
  • 创建封装外部库或 API 的技能
  • 为 MCP 服务器构建插件配套（companion）
  • 从第三方仓库中提取自动化机会
  • 围绕外部工具打包工作流模式

不适用（NOT for）的场景：

  • 从零开始创建插件（应使用 claude-plugins）
  • 创建单个技能（应使用 skills-dev）
  • 审计已有的 Claude Code 插件（应使用 claude-plugin-audit）

主要能力

  • 分阶段执行工程流程，每个阶段加载对应的 outfitter 技能，并通过 maintain-tasks 技能跟踪阶段进度（阶段只前进，不回退）。
  • 通过 artifacts/plugin-engineer/ 目录下的产物（artifacts）跟踪进度，目录结构如下：
artifacts/plugin-engineer/
├── discovery.md      # Research output (docs, APIs, community patterns)
├── recon.md          # Codebase analysis (structure, conventions, key files)
├── patterns.md       # Extracted patterns with automation value
├── mapping.md        # Pattern → component mapping decisions
├── components/       # Authored skills, agents, hooks, commands
│   ├── skill-1/
│   ├── skill-2/
│   └── ...
└── audit.md          # Plugin validation results

使用方式

七个阶段

各阶段与其加载的技能、进行状态（activeForm）如下：

阶段 技能 activeForm
1. Discovery outfitter:research "Researching external docs"
2. Recon outfitter:codebase-recon "Analyzing target repo"
3. Patterns outfitter:patterns "Extracting patterns"
4. Mapping outfitter:codify "Mapping to components"
5. Authoring outfitter:skills-dev "Creating components"
6. Packaging outfitter:claude-plugins "Packaging plugin"
7. Audit outfitter:claude-plugin-audit "Validating plugin"
  • 阶段 1 Discovery：加载 outfitter:research 技能，收集外部文档、社区模式、痛点（详见 stage-1-discovery.md）。
  • 阶段 2 Recon：加载 outfitter:codebase-recon 技能，分析结构、API 表面、约定（详见 stage-2-recon.md）。
  • 阶段 3 Patterns：加载 outfitter:patterns 技能，提取工作流、命令序列、决策点（详见 stage-3-patterns.md）。
  • 阶段 4 Mapping：加载 outfitter:codify 技能，将模式映射到组件类型（skill、command、hook、agent，详见 stage-4-mapping.md）。
  • 阶段 5 Authoring：按组件类型加载相应技能，在 artifacts/plugin-engineer/components/ 中创建（详见 stage-5-authoring.md）。
  • 阶段 6 Packaging：加载 outfitter:claude-plugins 技能，创建包含 manifest 与 README 的插件结构。此时会询问：“Do you have an existing marketplace to add this plugin to?” 若回答是，则准备 marketplace 条目（详见 stage-6-packaging.md）。
  • 阶段 7 Audit：通过加载 outfitter:claude-plugin-audit 技能进行委托，在分发前进行验证（详见 stage-7-audit.md）。

流程开始前需先明确目标仓库与插件目标；编写组件时使用 outfitter:skills-dev 或 outfitter:claude-skills；打包使用 outfitter:claude-plugins；验证委托给 outfitter:claude-plugin-audit。

Quick Mode（快速模式）

针对简单仓库（单一用途 CLI、小型 API 封装）提供快速模式：

  • 跳过阶段 3-4，直接从勘察进入编写
  • 创建 1-2 个覆盖主要用例的技能
  • 立即打包

触发条件：用户说 “quick”、仓库主命令少于 5 个，或用途明确单一。

关键决策点

  • 哪些模式需要自动化？高频 + 中等复杂度 = 最佳 ROI；低频 + 高复杂度 = 视受众是否为技术用户而定；一次性模式 = 跳过。
  • 用技能还是命令？多步骤、需引导 → 技能；快速动作、用法显而易见 → 命令；用户入口指向技能 → 两者（命令加载技能）。
  • 是否包含 agents？仅针对需要编排的复杂仓库；大多数插件不需要自定义 agents；考虑现有 agents（analyst、engineer）是否足够。
  • 快速模式还是完整流水线？单一用途工具 → 快速模式；功能众多的复杂工具 → 完整流水线；不确定 → 先做勘察再决定。

约束规则

ALWAYS（始终）：

  • 先做 discovery 再碰代码
  • 每个阶段跟踪产物
  • 在创建组件前验证模式有 3 个以上用例
  • 使用现有技能进行编写（不要重复造轮子）
  • 在宣布完成前运行审计

NEVER（绝不）：

  • 跳过勘察阶段（即使仓库很熟悉）
  • 在没有明确编排需求时创建 agents
  • 未经审计验证就打包
  • 过度工程（更简单的插件优于功能完备的插件）

参考资料

阶段指南：overview.md（快速参考）、stage-1-discovery.md（外部研究）、stage-2-recon.md（代码库分析）、stage-3-patterns.md（模式提取）、stage-4-mapping.md（组件选择）、stage-5-authoring.md（创建组件）、stage-6-packaging.md（插件结构）、stage-7-audit.md（验证）、repo-types.md（CLI vs Library vs MCP 模式）。

加载的技能：outfitter:research（外部发现方法论）、outfitter:codebase-recon（仓库分析方法）、outfitter:patterns（模式提取）、outfitter:codify（模式到组件映射）、outfitter:claude-plugins（插件打包）。

限制

资料未提供关于收费、价格、平台支持范围、运行环境要求、性能指标或具体使用效果的信息。技能所依赖的各阶段指南文件及 outfitter 系列技能的具体内容未在资料中展开，暂未提供。