用途:为 Claude Code 插件提供按项目、用户本地的配置方案。插件把用户可配置的设置写入项目目录下的 .claude/plugin-name.local.md 文件,YAML frontmatter 承载结构化配置,Markdown 正文承载提示词、任务描述或补充说明。
主要能力:适用于按项目配置(校验级别、启用/禁用、上限)、智能体协调状态(任务分配、会话跟踪)、Hook 激活控制(无需改 hooks.json 即可开关)、循环迭代状态(迭代计数、完成承诺)等场景。文件由用户管理并加入 gitignore,消费者为 hooks、skills、agents。
使用方式:文件结构为 --- 包裹的 YAML frontmatter 加正文。Hook 中读取遵循三步:检查文件是否存在、解析 frontmatter、提取字段,例如用 sed -n '/^---$/,/^---$/{ /^---$/d; p; }' 解析,用 grep 与 sed 提取 enabled 等字段;不存在时快速退出。Skills 与 agents 用 Read 工具读取后内联解析 YAML。正文可用 awk '/^---$/{i++; next} i>=2' 提取。
常见模式:临时激活 Hook(用 enabled 字段控制)、智能体状态管理(agent_name、task_number、pr_number、coordinator_session、dependencies 等字段)、配置驱动行为(validation_level 取 strict/standard/lenient)。
最佳实践与限制:命名用 .claude/plugin-name.local.md,.local 表示用户本地且被 gitignore(.claude/.local.md、.claude/.local.json);文件缺失时提供合理默认值;使用前校验字段值;更新用临时文件加原子移动;设置变更需重启 Claude Code 会话。安全上需清理写入的输入、校验路径防止目录穿越,文件权限建议 chmod 600,不提交 git、不跨用户共享。
资料还提到可参考解析技巧与真实示例文档,以及相关技能 /plugin-creator:hooks-guide、/plugin-creator:component-patterns、/plugin-creator:command-development。具体安装命令与收费信息暂未提供。