插件项目设置模式
用项目级本地 Markdown 文件保存并读取可配置的 Claude Code 插件设置。
文档强调用户本地文件、gitignore、权限限制、输入清理、路径遍历检查和原子更新，且示例包含用户确认步骤；但权限、确认、回滚和敏感数据处理并未形成统一强制流程，部分示例会把用户可控正文反馈给 Claude 或通过 tmux 发送，数据流边界和外部影响说明不足，因此扣分。
提供了 Bash 示例、默认值、部分校验和错误消息，核心路径在静态阅读下基本连贯；但依赖 jq、yq、tmux 等未统一声明，sed/grep 解析不是真正的 YAML 解析，缺失字段可能在 set -e 下异常退出，验证脚本也可能把非严格 YAML 判为有效，未见针对关键路径的测试，因此按静态上限扣分。
触发条件、文件命名、配置用途和若干使用场景描述清楚，覆盖 hooks、commands、agents；但未充分说明非适用场景、Claude Code 版本边界、工作目录假设、复杂 YAML 限制或中文使用支持，也未讨论中国大陆网络环境，语义触发边界仍有限，因此扣分。
目录结构清晰，主文档、示例、引用资料和脚本分层合理；有版本号、仓库 Apache-2.0 元数据、官方组织来源及维护线索，也说明了重启要求和 gitignore；但缺少技能级 changelog、稳定性承诺、明确更新路径、完整依赖安装说明、FAQ 和统一 schema，且若干文档假设 README 会补充信息，因此扣分。
该技能能直接提供本地配置文件模式、模板、解析脚本、校验脚本和实现流程，足以完成简单配置场景；但输出是指导和示例而非经过验证的可直接集成实现，解析复杂 YAML、异常输入和安全边界仍需人工修订，静态评估不能超过 7，因此扣分。
源文件包含具体命令、脚本、示例和错误反馈，具备一定可审计性；但没有针对该技能关键路径的提交测试、CI 覆盖或第三方执行证据，所谓真实案例主要是文档内示例，无法独立复现或交叉验证，因此取静态上限。
- 不要把 sed/grep 提取结果当作完整 YAML 解析；复杂结构、引号、重复键、嵌套值和恶意内容应使用严格解析器并验证 schema。
- 相对路径依赖当前工作目录，且正文可能被反馈给模型或通过 tmux 发送；使用前应明确项目边界、敏感信息策略、用户确认、权限和回滚机制。
- 示例依赖 jq、可选的 yq、tmux 和 Claude Code 重启语义，但环境要求未统一声明；应在目标环境中单独验证。
它能做什么 & 适用场景
该技能说明如何使用 `.claude/plugin-name.local.md` 保存插件配置与状态。文件由 YAML frontmatter 和 Markdown 正文组成，可供 hooks、commands 和 agents 读取。它涵盖文件命名、字段解析、默认值、校验、Git 忽略、权限和重启要求。适合需要按项目配置插件行为的 Claude Code 插件开发者，但资料没有提供独立安装命令或完整测试证明。
指导创建 .claude/plugin-name.local.md 文件；使用 sed 提取 YAML frontmatter，使用 grep 和 sed 读取字段，使用 awk 提取 Markdown 正文；示范在 Bash hooks、commands 和 agents 中读取 enabled、字符串、布尔值及数值配置；说明如何生成模板、校验输入、检查路径遍历、设置文件权限，并在配置不存在时采用默认值。
- 插件开发者需要为每个项目保存启用状态、模式或重试次数时，使用本地设置文件。
- 维护安全扫描 hook 的团队需要按项目临时启用或停用检查时，读取 `enabled` 字段。
- 多代理插件需要保存代理名称、任务编号和协调会话时，使用配置文件共享状态。
- 循环执行插件需要保存迭代次数、上限和完成条件时，读取 frontmatter 与正文提示。
优缺点一览
- 提供了可直接复制的文件模板和 Bash 解析示例。
- 覆盖配置缺失时的默认值、字段校验、Git 忽略和权限建议。
- 同时说明 hooks、commands 和 agents 的使用方式。
- 内容明确面向 Claude Code 插件机制，迁移到其他客户端需要调整 hooks、commands、agents 和重启流程。
- 示例主要依赖文本命令解析 YAML，未证明能处理复杂 YAML 结构。
- 来源未提供测试套件、平台兼容性验证或独立安装名称。
如何安装
该技能位于仓库的 plugins/plugin-dev/skills/plugin-settings/SKILL.md。README 说明插件可通过 Claude Code 插件系统安装，命令格式为 /plugin install {plugin-name}@claude-plugins-official；但来源没有明确给出本技能的独立 marketplace 名称或单独安装步骤。
如何使用
向 Claude Code 提出“如何为插件保存项目级配置并读取 YAML frontmatter？”之类的问题。按技能模式在项目根目录创建 .claude/plugin-name.local.md，写入 YAML frontmatter 和 Markdown 正文；在 hook、command 或 agent 中读取它。编辑后退出并重启 Claude Code，使 hooks 载入新设置。