用途：为 Claude Code 插件提供按项目存储用户配置与状态的模式。文件位于项目根目录 .claude/plugin-name.local.md，结构为 YAML frontmatter 加 Markdown 正文；frontmatter 存结构化配置，正文可放提示词或补充说明。该文件由用户管理，不应提交到 git，需加入 .gitignore（如 .claude/*.local.md）。
主要能力：hooks、命令和 agent 均可读取该文件。常见模式包括用 enabled 字段临时启用或停用 hook、存储 agent 状态与协调信息、以及按 validation_level 等配置驱动行为。
使用方式：hook 中先判断文件是否存在，不存在则 exit 0；再用 sed 提取 --- 之间的 frontmatter，用 grep 与 sed 读取字段，用 awk 读取第二个 --- 之后的正文。命令和 agent 可用 Read 工具读取并解析。创建配置可由命令引导用户输入后生成模板。
限制与注意：修改设置后需重启 Claude Code 才能生效，hook 无法在会话内热切换。写入用户输入时应转义引号，含路径时需检查 .. 防止路径穿越，文件建议仅用户可读。该 .local.md 文件独立于 Claude Code 的 settings 优先级体系，是插件自行读取的按项目状态文件。资料未提供具体收费、平台或效果信息。