Claude Code 插件设置模式
用项目级本地 Markdown 文件保存并读取插件配置与状态。
文档说明了用户本地文件、gitignore、输入校验、路径遍历检查和权限建议，且没有发现恶意外传或凭据窃取；但多数安全措施只是建议，示例中的 heredoc、简单解析和用户可控正文仍可能导致注入、敏感信息暴露或不安全写入，因此扣分。
提供了脚本、默认值、部分校验、原子更新和错误信息，快乐路径基本连贯；但 sed/grep 解析并非完整 YAML 解析，字段缺失可能因 set -e 直接失败，验证器也可能把额外标记误判为有效，未见测试或执行证据，因此受静态上限限制并扣分。
触发描述覆盖插件设置、状态文件、YAML frontmatter 和项目级配置，受众与基本场景清楚；但未充分定义复杂 YAML、并发更新、不同工作目录、非 Bash 环境等不适用范围，也未明确语义触发边界，因此扣分。
文档分为概览、模板、解析、示例、脚本、最佳实践和工作流，结构清晰，并包含版本号与官方组织归属；但许可证条款、变更记录、维护负责人、更新路径和依赖安装说明不完整，引用的资源也未在证据中独立验证，因此扣分。
模板、示例和两个辅助脚本能直接帮助用户建立并读取简单配置文件，具有明显的手工操作节省价值；但输出依赖用户自行整合到插件，解析能力有限且部分示例不够安全，未有代表性结果验证，因此扣分。
选定路径包含可审计的源码、脚本和具体示例，可核对主要设计主张；但没有提交测试套件、CI 覆盖或第三方执行结果，静态审查无法确认关键路径，因此仅给有限分数。
- 不要将 sed/grep 解析器当作通用 YAML 解析器；复杂值、冒号、换行、列表和引号可能被错误处理。
- 从用户设置正文构造提示或 JSON 时必须始终使用安全的参数化构造，并严格限制可写路径和敏感字段。
- 示例建议重启 Claude Code，但未证明所有相关运行时都必须重启；应由实际插件实现和测试确认生命周期行为。
- 未提供针对关键脚本的测试或执行记录，部署前应补充异常输入、缺失字段、恶意路径和并发更新测试。
它能做什么 & 适用场景
该技能介绍使用 `.claude/plugin-name.local.md` 保存插件配置和状态的方法。文件由 YAML frontmatter 与 Markdown 正文组成，适用于项目级设置、提示词和附加上下文。文档涵盖钩子、命令和代理如何读取这些文件，以及字段解析、默认值、校验、权限和 Git 忽略规则。它适合需要让插件行为可配置、又不希望把个人设置提交到仓库的团队。
说明如何创建 .claude/plugin-name.local.md 文件，使用 YAML frontmatter 保存布尔值、字符串、数字和列表，并在 Markdown 正文中保存提示词或上下文。提供 Bash 中使用 sed、grep 和 awk 读取 frontmatter 与正文的示例，也说明命令和代理如何读取设置。文档还给出启用状态检查、默认值、数值校验、路径遍历检查、文件权限、.gitignore 配置和重启 Claude Code 的做法。
- 插件开发者需要按项目启用或停用钩子时，用本地设置文件控制 `enabled` 字段。
- 团队需要保存多代理任务编号、协调会话和依赖关系时，用 Markdown 状态文件传递这些信息。
- 项目需要根据严格、标准或宽松模式改变验证逻辑时，在 frontmatter 中保存配置并由钩子读取。
- 插件需要保存不应提交到 Git 的用户本地配置、提示词或附加说明时，使用 `.local.md` 文件。
优缺点一览
- 提供清晰的项目级配置文件约定。
- 同时支持结构化 YAML 配置和 Markdown 上下文。
- 包含 Bash 解析、默认值、校验、权限和 Git 忽略示例。
- 覆盖钩子、命令和代理等插件组件的使用方式。
- 没有说明该技能的独立安装或启用命令。
- 示例依赖 Bash、sed、grep 和 awk，其他运行环境可能需要适配。
- 设置修改需要重启 Claude Code，不能在当前会话中热更新。
- 来源没有提供测试结果或跨平台验证信息。
如何安装
该来源没有说明此技能的单独安装命令；它位于仓库的 plugins/plugin-dev/skills/plugin-settings/SKILL.md。README 说明应先安装 Claude Code，例如 macOS/Linux 使用 curl -fsSL https://claude.ai/install.sh | bash，然后进入项目目录运行 claude。插件集合的具体启用或复制步骤未在来源中说明。
如何使用
在项目根目录创建 .claude/plugin-name.local.md，写入 YAML frontmatter 和 Markdown 正文，例如 enabled: true、mode: standard。让插件的钩子、命令或代理读取该文件；保存或修改后退出并重启 Claude Code，因为文档说明设置变更不会在会话内热加载。具体触发命令未在来源中规定。