SuperAPI AI 工具集

advanced-features-2025

编程与开发

查看项目

更新于 10-15 23:41

技能介绍

本资料是 Claude Code 插件高级功能(2025)的参考文档,面向插件作者与团队维护者,介绍四类能力:Agent Skills、Hooks、MCP 服务器集成和团队分发。

Agent Skills 通过 skills/*/SKILL.md 动态加载知识,采用三层加载:frontmatter 在启动时加载触发条件,SKILL.md 正文在激活时加载,references/ 在需要细节时加载。目录结构包含 SKILL.md、references/、examples/、scripts/。SKILL.md 使用 YAML frontmatter 声明 name 与 description,正文建议保持精简,细节放入 references/。

Hooks 通过 hooks/hooks.json 或 plugin.json 内联配置,实现事件自动化。支持的事件包括 PreToolUse、PostToolUse、SessionStart、SessionEnd、UserPromptSubmit、PreCompact、Notification、Stop、SubagentStop。matcher 可匹配 Write、Edit、Bash 等工具,也可用 Write|Edit 组合。可用变量有 ${CLAUDE_PLUGIN_ROOT} 和 ${TOOL_INPUT_*}。常见模式如写入后自动测试、Bash 前校验命令。

MCP 集成在 .mcp.json 中配置 mcpServers,指定 command、args 与 env,可接入本地脚本或外部服务(如 Stripe)。

团队分发在仓库根目录创建 .claude/settings.json,通过 extraKnownMarketplaces 与 plugins.enabled 声明插件,成员克隆仓库并信任文件夹后自动安装。

最佳实践:SKILL.md 控制在 500 行以内,使用具体 matcher 并设置合理超时,用环境变量管理密钥,分发前测试连接。详细模式见 references/ 下的 hooks-advanced.md、mcp-patterns.md、team-distribution.md 及 examples/hook-scripts.md。具体收费、平台支持与效果暂未提供。