Plugin Development 是一个围绕插件开发的学习技能,属于 pluginagentmarketplace/custom-plugin-design-system。其目标为掌握插件编写,包括代理实现、技能创建、命令开发与钩子脚本,并学习插件编码的最佳实践。
用途
该技能用于指导编写代理、技能、命令与钩子,并给出配套的模板和质量标准,帮助开发者产出结构一致、可测试的插件内容。资料中明确“Use this skill when”适用于以下场景:编写代理内容、创建新技能、实现命令、设置钩子、测试实现。
主要能力
- 代理实现:提供 YAML 前置元数据模板(description 最多 1024 字符、capabilities 列举具体能力)以及内容结构,包含 Overview、Expert Areas、When to Use、Integration 等章节,并在结尾标注状态与更新日期。
- 技能实现:提供 SKILL.md 模板,含 name(如 skill-id)、description(最多 1024 字符)、Quick Start 可运行代码、核心概念、进阶主题和真实项目,并给出使用时机。
- 命令实现:提供命令 Markdown 文件格式,包含命令说明、用法、选项表、示例输出、提示与相关命令。
- 钩子实现:提供钩子 JSON 结构,包含 hooks 数组(id、name、description、event、condition、action、enabled)与 notifications 配置(enabled、channels)。钩子事件类型包括 command-executed、agent-invoked、skill-loaded、scheduled。
- 质量标准与检查清单:分别给出代理、技能、命令的质量要求与测试要点,例如代理描述清晰、5-10 项具体能力、3-5 个专家领域、总量 250-400 行;技能名称小写加连字符、Quick Start 可运行、3+ 核心概念、2+ 真实项目、200-300 行;命令需有清晰描述、用法示例、选项文档、示例输出、后续步骤、100-150 行。
- 常见实现模式:知识模式(代理解释概念、技能提供示例、命令支持练习)、工作流模式(命令启动流程、代理引导决策、钩子自动化步骤)、集成模式(代理相互推荐、代理链接技能、技能建议命令)。
- 版本控制实践:给出提交信息约定(feat、fix、docs、refactor、test)以及新增代理、技能、命令后的文件变更处理要求。
使用方式
资料以模板和结构说明的形式呈现,未提供安装命令或运行命令。开发时可依照模板填写 YAML 前置元数据和正文结构,按命令文件格式撰写命令,按 JSON 结构配置钩子,并在完成后对照测试清单验证。文末标注 Status 为 Production Ready、SASMP v1.3.0,绑定代理为 02-plugin-developer。
适用场景
适用于需要按统一规范编写代理、技能、命令和钩子的插件开发工作,以及对这些组件进行测试与文档化的场景。
限制
资料未提供具体价格、收费模式、平台支持范围、安装命令、运行环境与效果数据;除文末状态标注外,未提供更多关于使用限制的说明。以上未提及的内容暂未提供。