用途：为 Claude Code 插件提供按项目存储的用户配置与状态，让插件行为可由用户自定义，而无需直接修改插件代码。
文件结构：位于项目根目录 .claude/plugin-name.local.md，包含 YAML frontmatter（如 enabled、setting1、numeric_setting、list_setting 等字段）与 markdown 正文（任务描述、附加指令、提示词或说明）。
读取方式：hooks 中先用存在性检查快速退出，再用 sed 提取 --- 之间的 frontmatter，用 grep 与 sed 读取字段；commands 和 agents 也可读取并据此调整行为。正文可用 awk 在第二个 --- 之后提取。
常见模式：用 enabled 字段临时启停 hooks；保存 agent 状态（如 agent_name、task_number、pr_number、coordinator_session、dependencies）；按 validation_level 等配置驱动 strict、standard、lenient 等行为分支。
创建与最佳实践：可由 setup command 询问用户偏好后生成文件并提供模板；文件命名应为 .claude/plugin-name.local.md，建议加入 .gitignore，缺少文件时使用合理默认值，校验数值范围并对用户输入与路径做转义与防目录穿越处理。
限制：设置变更需重启 Claude Code 才能生效，hooks 无法在会话内热替换；资料未提供其他平台兼容性或收费信息。