Plugin/Skill/Agent/Coordinator 正确关系

一、四大核心角色官方定义（Claude Certified 标准）

角色	定位	核心特性	能否独立运行
Plugin（插件）	功能分发/扩展包	封装 Skills、Agents、Commands 等，是交付单元	❌ 仅用于安装/分发
Skill（技能）	离散执行单元	无自主决策，仅执行具体操作（搜索/计算/文件操作）	❌ 需挂载到 Agent
Agent（代理）	智能执行主体	有推理/决策/独立上下文，分 Coordinator、Subagent	✅ 可执行任务
Coordinator（协调者）	顶层中枢代理	仅负责任务分解、委派、结果聚合，不直接挂载 Skill	✅ 控制多代理系统

二、核心层级关系

1. 从属链：Plugin（包裹）→ 包含 Skill + Agent；Agent（主体）→ 挂载 Skill（工具）；Coordinator（中枢）→ 调度 Subagent
2. 可见性铁律
   • Coordinator 运行时不可见 Plugin，仅感知注册后的 Agent/Skill
   • Plugin 是安装载体，运行时对 Coordinator 完全透明
   • Skill 无独立全局注册表，标准架构中仅依附 Agent 存在

三、CC CLI 版本与 Coordinator 引入

1. v1.x 及更早：无 Coordinator，仅单 Agent + 插件 Skill 直接调用
2. v2.0+：正式引入 Coordinator，对应 Claude Certified 认证多代理架构，为兼容旧插件保留双运行系统

四、CC CLI 两套运行系统（关键兼容机制）

1. 认证标准系统（考试考点）

• 路径：Coordinator → Subagent → Skill
• 规则：Subagent 需放至 ~/.claude/agents/ 或 .claude/agents/ 注册；Coordinator 仅调度注册的 Subagent；Skill 仅由 Subagent 挂载调用

2. 实际兼容系统（你遇到的场景）

• 路径：Coordinator/主 Agent → 直接调用插件 Skill → 插件私有 Agent
• 规则：插件 Skill 自动加载；插件私有 Agent 不拷贝、不注册，仅被同插件 Skill 内部触发；Coordinator 无感知

五、插件类型判断标准

1. Skill-only 插件（99%）：仅含 Skills，安装无 Agents 文件生成，Skill 自动可用
2. Agent 插件：含标准 Subagent 配置，需手动复制到 ~/.claude/agents/ 才会被 Coordinator 识别
3. 复合插件：同时含 Skill + Agent，Skill 自动加载，Agent 为私有不自动注册

六、everything-claude-code 终极真相

1. 属性：标准复合插件，内置标准格式 Agents + 40+ Skills，Agents 格式完全合规
2. 核心现象解释
   • 未拷贝至 ~/.claude/agents/：CC CLI 安全机制，禁止插件自动写入全局 Agent 注册表
   • Agent 能被调用：插件内置 Skill 直接触发同插件私有 Agent，属于插件内部调用，不走 Coordinator 全局注册表
   • Coordinator 不可见：该 Agent 是插件私有资源，未注册到全局，Coordinator 无感知
3. 调用链路：用户触发 → 插件 Skill 执行 → Skill 主动调用插件内置私有 Agent → 完成任务

七、核心规则总结

1. Coordinator 是 CC CLI v2.0+ 专属概念，为认证架构核心
2. 插件 Skill 自动加载，插件 Agent 绝不自动注册，需手动复制到全局目录
3. 私有 Agent 可由插件内部 Skill 直接调用，无需进入 Coordinator 注册表
4. everything-claude-code 的 Agent 被调用，是其自身 Skill 触发的插件内部调用，与全局 Coordinator 调度无关

如何判断一个插件是skill插件还是AGent插件

一、先明确：CC CLI 只有两种插件

1. Skill Plugin（纯技能插件）
   • 只有工具能力（搜索、文件、Git、Everything 搜索等）
   • 无 Agent 定义
   • 安装后不生成 .claude/agents/ 文件
   • 占所有插件的 99%
2. Agent Plugin（代理插件）
   • 包含完整 Subagent 配置
   • 安装后自动拷贝文件到 .claude/agents/
   • 极少，只有专门的多代理插件才是

---

二、4 种 100% 准确的判断方法（你直接照着做）

方法1：用 CLI 命令查看插件详情（最简单）

claude plugins show 插件名

• 如果输出只有 skills 列表 → Skill 插件
• 如果输出有 agents 字段 → Agent 插件

方法2：看是否生成 agents 文件（最直观）

安装插件后，查看项目目录：

ls .claude/agents/

• 空的 → 绝对是 Skill 插件
• 有 .md/.json 文件 → Agent 插件

方法3：查看插件本地目录结构（最权威）

插件真实安装路径：

# 全局插件
ls ~/.claude/plugins/插件名/

# 项目插件
ls .claude/plugins/插件名/

判断标准：

• 只有 skills/ 文件夹 → Skill 插件
• 有 agents/ 文件夹 → Agent 插件

方法4：看插件仓库源码（开源插件）

• 源码只有 skills/ → Skill 插件
• 源码有 agents/ → Agent 插件

三、Coordinator 如何处理这两种插件？

插件类型	是否生成 agents	Coordinator 如何发现
Skill 插件	❌ 不生成	直接扫描插件目录，加载全局 Skill
Agent 插件	✅ 生成	扫描 .claude/agents/，作为 Subagent 调度

注意：上面讲的是Subagents模式，Agent Teams模式下，subagent间是可以通讯的

Agent teams：https://code.claude.com/docs/zh-CN/agent-teams

参考资料