总览
本章节范围:agent 怎么被扩展与共享——skill、hook、plugin、跨工具约定 目标读者:给 agent 加能力、做 agent 生态集成的工程师
范围与边界 (Scope)
- 包含:skill 系统、hook 系统、plugin 与 marketplace、自定义 subagent、AGENTS.md 约定
- 不包含:
- MCP 协议与工具设计 → 05-工具系统与 MCP
- subagent 作为工具调用 → 05-工具系统与 MCP/05
- CLAUDE.md 文件型记忆 → 03-记忆系统/04
名词定义
| 名词 | 定义 |
|---|---|
| skill | 封装流程性知识的目录模块(SKILL.md + 支撑文件) |
| progressive disclosure | 渐进式披露:默认只加载元数据,触发时才加载正文 |
| hook | 在 agent 生命周期节点自动执行的确定性处理器 |
| PreToolUse / PostToolUse | 工具执行前/后触发的 hook 事件,前者可阻断 |
| plugin | 把 skill/hook/MCP/agent 打包分发的自包含目录 |
| marketplace | plugin 的分发渠道(官方/社区/私有) |
| 自定义 subagent | 用 frontmatter 定义角色/工具/model 的专用 agent |
| AGENTS.md | 工具无关的项目 agent 指令约定文件 |
@tbl-agent-eco-glossary 扩展性与生态章节名词定义:skill、progressive disclosure、hook、PreToolUse/PostToolUse、plugin、marketplace、自定义 subagent、AGENTS.md
本章节所有文档默认这些名词已定义。
子文档索引 (Index)
- 02-skill系统 — progressive disclosure 三层加载、三种触发、skill vs MCP
- 03-hook系统 — 生命周期事件、PreToolUse 阻断、确定性自动化
- 04-plugin与agent生态 — plugin 打包、marketplace、自定义 subagent、AGENTS.md
阅读建议
三篇按"机制 → 打包 → 生态"递进:skill/hook(单点扩展机制,02/03)→ plugin 打包分发 + AGENTS.md 跨工具约定(04)。
参考资料
- Claude Code skills/hooks/plugins 文档、Agent Skills 公告、AGENTS.md 标准,详见各子文档
## 参考资料。