SuperAPI AI 工具集

clade-reference-architecture

智能体与模型

查看项目

更新于 10-16 06:20

技能介绍

用途:该技能面向 Claude Code 插件开发,讲解其插件系统的四类扩展点——skills(自动激活的知识)、commands(斜杠命令)、agents(专用子智能体)和 MCP servers(工具提供方),并给出构建这四类扩展的参考架构与示例。

主要能力:说明插件目录结构,如 .claude-plugin/plugin.json 清单(name、version、description、author),以及 skills/、commands/、agents/ 等目录;给出 SKILL.md 的 YAML frontmatter 字段(name、description、allowed-tools、version、author、license、compatible-with、tags);给出斜杠命令、agent 与 MCP server 的声明示例;列出 hooks 配置(pre-tool-call、post-tool-call 及 matcher);并整理路径变量 ${CLAUDE_SKILL_DIR}、${CLAUDE_PLUGIN_ROOT}、${CLAUDE_PLUGIN_DATA}、$ARGUMENTS 的适用上下文。

使用方式:从满足需求的最小扩展点开始,只声明所需工具与权限,先在本地验证,再发布到市场或共享环境;测试发现、激活、失败与回滚路径。MCP server 示例使用 Node.js 18+ 与 @modelcontextprotocol/sdk,通过 StdioServerTransport 连接。

适用场景:需要为 Claude Code 构建插件、技能、命令、子智能体或 MCP 工具提供方,并希望遵循参考架构与权限边界的开发者。

限制:资料要求具备受支持的 Claude Code 环境、隔离的插件工作区、明确的文件系统/网络/凭据访问边界、清单与元数据校验工具,以及可禁用插件而不删除用户状态的回滚方案;不得通过示例、环境文件、日志或 MCP 响应载荷暴露密钥。错误处理要求:校验失败则停止安装并修正声明;未批准能力应移除或严格论证;MCP 失败或返回畸形数据应失败关闭、脱敏诊断并保留关联 ID;升级改变行为应禁用或固定版本并回退到上次测试版本。输出应形成插件架构记录,包含所选扩展点、清单版本、声明的工具与权限、测试证据、发布负责人与回滚流程。资料未提供具体收费、价格、平台支持范围与效果数据。