用途:该技能文档围绕插件的文件夹结构、manifest(plugin.json)设计与架构模式展开,目标是让插件组织得可扩展、可维护。资料来自 pluginagentmarketplace/custom-plugin-design-system 的插件架构技能页。
主要能力:给出推荐的最小目录布局(.claude-plugin/plugin.json、agents/、skills/、commands/、hooks/、README.md);说明 manifest 字段与规则(name 用小写连字符、10-50 字符,version 用语义化版本,description 50-256 字符,agents、commands、skills 为定义数组,hooks 可选并指向 hooks.json);给出 agent 的 YAML frontmatter 结构(description 最多 1024 字符、capabilities 列表)与 01-primary-agent.md 式命名约定;说明 skill 目录结构(固定名为 SKILL.md,可选 resources/)及 SKILL.md 的 frontmatter 与章节格式;说明 command 文件格式(用途、用法、选项表、示例、后续步骤)与 hook 配置字段(id、name、event、condition、action、enabled);并列出单一职责、分层架构(命令→智能体→技能→钩子)、代理协作等模式,以及从简单到复杂的三阶段扩展路径和常见错误。
使用方式:按推荐布局组织插件文件,在 plugin.json 中注册各 agent、command、skill 与 hook 路径,agent 与 skill 以带 YAML frontmatter 的 Markdown 编写,命令以 /command-name 形式作为用户入口。
适用场景:设计插件结构、编写 plugin.json、整理 agents 与 skills、规划插件增长时使用。
限制:资料仅描述结构与约定,未提供安装命令、收费信息、运行环境或效果保证;页面标注状态为生产就绪、SASMP v1.3.0、绑定代理 01-plugin-architect。