用途：为编码智能体运行时（尤其是终端优先的 CLI）设计或评审插件体系，这些运行时可从可安装扩展中加载技能、钩子、MCP 服务器、命令、智能体和输出样式。端到端编码智能体设计请用 ../ai-coding-agents/SKILL.md。
主要能力：定义能力族与宿主所有的扩展点；编写声明式清单契约与校验路径；划分安装时与运行时信任边界；实现确定性发现与激活顺序；把插件状态分为安装意图、落盘内容与活动内存组件三层；显式设计重载语义、缓存失效与部分失败处理；处理受管策略与内置插件交互；维护缓存身份、兼容边界与升级/降级/回滚。
必要做法：宿主唯一拥有优先级、信任与激活权；清单声明式、无需执行插件代码即可检查；内置件可像插件但对 UI 与注册表，但信任与启用规则由宿主控制；插件组件名按插件 ID 命名空间化；优先可重载注册表，副作用不安全时允许需重启；缓存按兼容边界而非显示版本标识；git 子目录与路径安装视为不同缓存身份。
适用场景：为编码智能体 CLI 设计插件系统；添加提供命令、技能、钩子、智能体或 MCP 服务器的扩展；区分内置能力与市场/仓库本地插件；评审信任边界与宿主优先级；在 CLI 升级、降级、回滚与缓存迁移中保持插件可用。
限制：仅覆盖编码智能体插件架构；MCP 服务器设计、钩子编写、子智能体定义、通用 CLI/SDK 设计、定时任务、版本固定与技能打包请分别改用对应技能。资料未提供具体收费、平台与效果数据。