用途：为 Claude Code 插件提供按项目保存用户配置与状态的模式。配置文件位于项目根目录的 .claude/plugin-name.local.md，采用 YAML frontmatter 加 markdown 正文的结构，frontmatter 存放结构化设置，正文可放提示词或补充上下文。该文件由用户管理，不应提交到 git，需加入 .gitignore。
主要能力：hooks、命令和 agents 均可读取该文件。常见用法包括用 enabled 字段临时启用或停用 hook、存储 agent 状态（如 agent_name、task_number、coordinator_session）、以及按 validation_level 等配置驱动不同行为。
使用方式：在 hook 脚本中先判断文件是否存在，不存在则直接退出；再用 sed 提取 --- 之间的 frontmatter，用 grep 与 sed 读取单个字段，用 awk 提取第二个 --- 之后的正文。命令和 agent 也可通过 Read 工具读取并解析。创建配置可由命令引导用户输入后生成模板。
限制与注意事项：设置变更需要重启 Claude Code 才能生效，hooks 无法在会话内热替换。应提供合理默认值，校验数值范围与文件路径，防止路径穿越，并对用户输入做转义。配置文件建议仅用户可读（chmod 600），不共享、不提交。资料未提供具体收费、价格或平台信息。