用途：为 Claude Code 插件提供按项目、用户本地的配置方式，适合插件需要按项目配置、Hook 需要运行时开关、Agent 状态需跨会话保留、或配置需同时包含结构化数据与提示词/说明的场景。若设置是全局的、Hook 始终开启、状态仅限单次会话或配置纯结构化，则应改用其他方案。
主要能力：配置文件位于 project-root/.claude/plugin-name.local.md，命名需与 plugin.json 中的插件名一致，.local.md 后缀表示用户本地、不提交 git，建议将 .claude/*.local.md 加入 .gitignore。文件由 YAML frontmatter（如 enabled、mode、max_retries、allowed_extensions）和 Markdown 正文组成，正文可存放提示词、指令或文档供 Hook 与 Agent 读取。
使用方式：Shell 脚本（Hook）可用 extract_field 模式读取字段，先以 [[ -f "$STATE_FILE" ]] || exit 0 快速退出，再用 head -50 "$file" | grep -m1 "^${field}:" | sed 's/^[^:]:[[:space:]]//' | tr -d '\r' 提取；正文可用 awk '/^---$/{i++; next} i>=2' "$STATE_FILE" 获取。Skills 与 Agent 通过 Read 工具读取文件、解析 frontmatter 并应用设置。常见模式包括开关式 Hook 激活、跨会话保存 Agent 状态、配置驱动的校验。
限制与注意：文件缺失时应提供合理默认值；需校验数值范围与枚举取值；设置文件建议仅用户可读（chmod 600）；Hook 相关改动需重启 Claude Code 才生效。资料未提供具体收费、平台或效果信息。