用途：在设计插件配置时，帮助区分 Claude Code 官方设置、插件自带默认值、应用自有数据与 Agent Master 发现元数据，为每项配置选择合适机制。
主要能力：
- 设置分类：Claude Code 行为、权限、环境或插件启用放入官方 settings.json 层级（用户、项目、本地、托管）；插件支持的默认值放 <plugin-root>/settings.json（目前支持键为 agent、subagentStatusLine，未知键被忽略）；插件身份与元数据放 .claude-plugin/plugin.json；按用户选项放 userConfig；项目自有配置需自定义 schema 与读取器。
- 官方设置：~/.claude/settings.json（个人）、.claude/settings.json（团队共享）、.claude/settings.local.json（个人本地覆盖）、托管设置。优先级从高到低为托管、命令行、本地项目、共享项目、用户设置。可用 /status 查看已加载设置源。
- userConfig：在 .claude-plugin/plugin.json 声明类型、标题、描述、敏感、必填等，启用时提示填写；用 ${user_config.KEY} 引用，敏感值勿插入 skill/agent 内容；在 hook 中读取 CLAUDE_PLUGIN_OPTION_<KEY>；不要插入 shell 命令字段。非敏感值存于用户设置的 pluginConfigs[<plugin-id>].options，敏感值用 macOS Keychain 或凭据存储。
- 自定义约定：.claude/<plugin-name>.local.md 仅当插件自有 Markdown+YAML 格式时使用，须自行实现版本化 schema、解析与校验；自定义文件不一定需要重启，取决于消费者读取方式。持久生成数据放 ${CLAUDE_PLUGIN_DATA}，${CLAUDE_PLUGIN_ROOT} 视为只读。
- Agent Master：可在 setup/manifest.json 的 skillInterfaces 声明技能 UI，含 skill、label、description，不含任意 URL；它仅作发现入口，不持久化配置或授权。
限制与注意：不要把项目自有文件当成官方设置源；不要手工编辑 pluginConfigs；密钥不得进入日志、Markdown 或提交文件；未提供的具体价格、平台支持等暂未说明。