用途：为 Claude Code 插件提供按项目存储用户配置与状态的模式。文件位于项目根目录的 .claude/plugin-name.local.md，采用 YAML frontmatter 加 markdown 正文的结构，由用户自行管理，不应提交到 git，需加入 .gitignore。
主要能力：hooks、命令和 agents 均可读取该文件。frontmatter 可存布尔、字符串、数值、列表等字段，正文可放任务描述、附加指令、反馈给 Claude 的提示或文档。常见模式包括用 enabled 字段临时启停 hook、存储多智能体协作状态、以及按配置驱动校验行为。
使用方式：在 hook 脚本中先判断文件是否存在，不存在则 exit 0；再用 sed 提取 --- 之间的 frontmatter，用 grep 与 sed 读取单个字段，用 awk 提取第二个 --- 之后的正文。命令和 agent 也可通过 Read 工具读取并解析。创建设置文件可由命令引导用户输入后生成。
限制与注意：设置变更需重启 Claude Code 才生效，hook 无法在会话内热替换。应提供合理默认值，校验数值范围与文件路径（防路径穿越），转义用户输入，设置文件建议权限 600。资料未提供具体收费、平台或效果信息。