Claude Code--Feishu-Skill-demo

Claude Code 的插件架构包含 5类，组合起来使用威力无穷。
1. Slash Commands（斜杠命令）
2. Subagents（子智能体/子代理）
3. MCP Servers（模型上下文协议服务器）
4. Hooks（钩子）

|---------------|---------------------------------------------------|-------------|
| 五类插件 | 官方文档 | |
| 1. Commands | https://code.claude.com/docs/zh-CN/slash-commands | 功能合并到skills |
| 1. Skills | https://code.claude.com/docs/zh-CN/skills | |
| 1. Agents | https://code.claude.com/docs/zh-CN/sub-agents | |
| 1. Hooks | https://code.claude.com/docs/zh-CN/hooks-guide | |
| 1. MCP Server | https://code.claude.com/docs/zh-CN/mcp | |

组件交互关系

复制代码

根据 Anthropic 最新的 Claude Code 插件架构 ，"Plugin" 其实是一个容器概念。一个插件包（Plugin）除了可以包含 Skills（技能） 之外，还可以包含另外 4 个核心组件。

你可以把 Claude Code 想象成一个操作系统，而 Plugin 是安装包，这个包里不仅有"说明书"（Skills），还有"快捷键"、"专门的员工"、"外部接口"和"自动触发器"。

以下是除 Skills 之外的 4 大核心组件详解：

Slash Commands（斜杠命令）

定义：用户主动触发的快捷指令，以 / 开头。

作用：将复杂的 Prompt 或一连串操作封装成一个简单的命令。
与 Skills 的区别 ：Skills 是 AI 隐式触发（根据上下文自动决定用不用）；Slash Commands 是用户显式触发（你输入命令它才动）。
典型场景：
- /format：一键运行代码格式化工具（Black/Prettier）。
- /deploy：执行一整套部署脚本。
- /test：运行当前项目的测试套件。
文件位置 ：插件目录下的 commands/*.md。

Subagents（子智能体/子代理）

定义：拥有特定人设（Persona）、特定工具集和特定系统提示词的"专家版"Claude。

作用：处理需要特定领域知识或特定视角的复杂任务。
与 Skills 的区别：Skill 是"知识"，Subagent 是"人"。你可以让一个 Subagent 掌握多个 Skills。
典型场景：
- Security Agent：一个专门负责找漏洞的代理，性格"多疑"，只关注安全，不关注代码美观。
- QA Agent：专门负责写测试用例的代理，加载了特定的测试框架文档。
- Product Manager Agent：不写代码，只负责把用户需求拆解成技术文档。
文件位置 ：插件目录下的 agents/*.md。

MCP Servers（模型上下文协议服务器）

定义：连接外部数据和工具的标准化接口（Model Context Protocol）。

作用：给 Claude 装上"手"和"眼"，让它能操作外部世界。这是 Claude Code 最强大的扩展点。
与 Skills 的区别 ：Skill 告诉 AI "怎么做" （方法论）；MCP 提供 "能用的工具"（实际操作能力）。
典型场景：
- PostgreSQL MCP：让 Claude 直接连接数据库执行 SQL 查询。
- GitHub MCP：让 Claude 读取 Issue、拉取 PR、查看 CI/CD 日志。
- Slack MCP：让 Claude 读取团队聊天记录或发送通知。
文件位置 ：在 plugin.json 或 .mcp.json 中定义配置。

Hooks（钩子）

定义：在特定事件发生时自动触发的脚本或逻辑。

作用：强制执行工作流、安全检查或自动化任务，无需用户干预。
与 Skills 的区别 ：Skill 是为了完成任务；Hooks 是为了监管任务或善后。
典型场景：
- PreToolUse（工具使用前） ：安全拦截。例如，当 Claude 试图运行 rm -rf 或连接公网 IP 时，Hook 脚本自动拦截并报错。
- PostToolUse（工具使用后）：自动修正。例如，Claude 修改文件后，Hook 自动运行 Linter 检查语法错误并反馈给 AI。
- UserPromptSubmit：在用户发送消息前自动附加特定的上下文（如当前时间、Git 分支信息）。
文件位置 ：在 hooks/hooks.json 中定义。

总结：Claude Code 插件的"五脏六腑"

一个功能完整的 Claude Code 插件（Plugin）通常是以上组件的组合。我们可以用**"装修施工队"**来打个比方：

|-------------|----------|-------------------------|--------------|
| 组件名称 | 角色比喻 | 功能描述 | 触发方式 |
| Skills | 施工图纸/SOP | 教 AI 如何贴瓷砖、如何走电线（知识与流程） | AI 自动看（按需加载） |
| Commands | 快捷按钮 | 一键呼叫"开始搬砖"或"清理现场"（封装操作） | 用户按 (/cmd) |
| Subagents | 特种工 | 水电工、木工、油漆工（特定角色与专长） | 切换角色 |
| MCP Servers | 电动工具 | 电钻、切割机、测距仪（连接外部能力的工具） | AI 调用 |
| Hooks | 监理/安保 | 进门检查安全帽，干完活检查是否漏水（自动监控） | 自动触发 |

实际插件案例

如果你安装了一个名为 webapp-dev-kit 的插件，它可能包含：

Skill : react-best-practices（教 Claude 怎么写高质量 React 组件）。
Command : /component（一键生成组件模版）。
Subagent : ui-designer（专注于调整 CSS 样式的子智能体）。
MCP : browser-tools（让 Claude 能控制浏览器进行截图或测试）。
Hook : auto-prettier（每次写完代码自动美化格式）。

Feishu SkillsDemo
1. 安装
2. 【find】Search 文档
3. 【cat】看文档
4. 【ls】获取文档的子文档目录树
5. 【markdown】飞书->本地markdown
  1. 不同格式的markdown