用途：为 Claude Code 插件提供一种按项目保存用户可配置设置与状态的模式，配置写入项目根目录下 .claude/plugin-name.local.md，由 YAML frontmatter 提供结构化配置，markdown 正文可放提示词或附加上下文。该文件由用户管理、不应提交到 git，应加入 .gitignore。
主要能力：hooks（Bash 脚本）、commands、agents 均可读取该文件并据此调整行为。常见模式包括用 enabled 字段临时启用/停用 hook、保存 agent 任务状态与协调信息、以及按配置驱动不同处理逻辑（如 strict/standard/lenient）。解析方式为用 sed 提取 --- 之间的 frontmatter，再用 grep/sed 读取单个字段；正文用 awk 取第二个 --- 之后的内容。文件中提供了读取设置、创建设置文件与校验取值的示例代码与脚本（如 examples/read-settings-hook.sh、scripts/validate-settings.sh）。
使用方式：按 .claude/plugin-name.local.md 命名并在插件 README 提供模板；hook 中先用 quick-exit 模式检查文件存在与 enabled 字段；文件不存在时使用合理默认值；对数值做范围校验，对路径检查目录穿越，对用户输入转义引号，文件权限建议 chmod 600。
限制：设置变更后需要重启 Claude Code 才会生效，hooks 无法在会话内热替换。资料未提供价格、平台支持范围或实际效果等信息，暂未提供。