用途:为 Claude Code 插件提供按项目存储用户配置与状态的方案,文件位于项目根目录的 .claude/plugin-name.local.md,使用 YAML frontmatter 存结构化配置,Markdown 正文存提示词或补充上下文。该文件由用户管理,不应提交到 git,应加入 .gitignore。
主要能力:hooks、命令和 agents 均可读取该文件;可控制 hook 是否启用、切换验证级别、保存 agent 状态(如 agent_name、task_number、coordinator_session)以及循环迭代参数等。
使用方式:在 frontmatter 中写 enabled、mode、max_retries 等字段,正文写任务说明或提示词。Bash hook 中常用 sed 提取 frontmatter、grep 读取字段、awk 读取正文,并先判断文件是否存在,不存在则 exit 0 使用默认值。命令和 agent 也可通过 Read 工具读取并解析。
限制与注意:修改设置后需重启 Claude Code 才能生效,hooks 无法在会话内热替换;写入用户输入时应转义引号,含路径的字段需检查路径穿越,文件建议权限 600 且不共享。资料未提供具体收费、价格或平台信息。