用途：为 Claude Code 插件提供按项目存储用户可配置设置与状态的模式，文件位于项目根目录的 .claude/plugin-name.local.md，由用户自行管理，不纳入 git，应写入 .gitignore。
结构：文件由 YAML frontmatter 与 markdown 正文组成。frontmatter 放结构化配置，如 enabled、strict_mode、max_retries、列表字段等；正文可放任务描述、附加指令、回传给 Claude 的提示或文档笔记。
读取方式：hooks（Bash 脚本）先判断文件是否存在，不存在则 exit 0 跳过；再用 sed 提取 --- 之间的 frontmatter，用 grep 与 sed 读取单个字段，用 awk 提取第二个 --- 之后的正文。命令和 agent 也可在步骤或指令中引用该文件，解析后调整行为。
常见模式：用 enabled 控制 hook 临时启用或停用；用 agent_name、coordinator_session 等字段管理多 agent 状态并发送通知；用 validation_level 等字段驱动不同校验行为。
创建与默认值：命令可询问用户偏好后生成该文件；文件不存在时应使用合理默认值。写入用户输入需转义引号，含路径的字段需检查 .. 防止路径穿越，文件建议仅用户可读。
限制：设置变更需重启 Claude Code 才生效，hooks 无法在会话内热替换；文件命名须为 .claude/plugin-name.local.md，不应使用普通 .md 以免被提交。资料未提供具体收费、价格或平台信息。