摘要：configured-agent 是 Anthropic 在 Smithery 上发布的 Skill，用 YAML frontmatter + 四行 bash 代码解决 Claude Code 插件的配置存储与读取问题。它不是库，是设计模式加复制即用的脚本模板，让每个插件不用重新发明配置轮子。
写 Claude Code 插件的人迟早会撞上一堵墙：插件需要记住用户的选择，但你不能写数据库，不能装 Redis，连环境变量都不好使。Claude Code 的插件运行在 hooks、commands 和 agents 里，每次启动都是全新的 shell 进程。
多数人第一反应是写个 JSON 配置文件丢在项目根目录。然后你会发现在 bash 里解析 JSON 有多痛。即使你用 jq 绕过去，存什么格式、怎么读写、用户怎么改，每个插件都得重新发明一遍轮子。
configured-agent 就是 Anthropic 在 Smithery 上发布的一个 Skill，专门解决这个“插件到底把配置放哪”的月经问题。
它到底是什么？
它本质上不是库，不是依赖，而是一套经过验证的模式和代码模板。
它选了一个看似简单但极其精准的切入点：用 YAML frontmatter + Markdown 作为配置载体，用 bash 原生工具（sed 和 awk）做解析。不需要引入外部依赖，不需要安装额外的解析器，任何 Unix-like 系统都能跑——Windows 用 Git Bash 或 WSL 也一样。
文件格式是标准的 YAML frontmatter，夹在两个 --- 之间，正文部分放 Markdown：
--- enabled: true mode: standard max_retries: 3 --- # Plugin Configuration This plugin is configured for standard validation mode. Contact @team-lead with questions.
解决了什么问题？
1. 配置存储的标准化
每个插件不用自己设计配置格式、自己写解析逻辑。一个 .claude/插件名.local.md 文件搞定所有配置。local.md 的后缀意味着它应该被加入 .gitignore，避免本地配置和敏感信息被提交进仓库。
2. 解析逻辑的复用
configured-agent 甚至已经把解析模板写好了。核心解析代码只有四行：
STATE_FILE=".claude/my-plugin.local.md"
[[ ! -f "$STATE_FILE" ]] && exit 0
FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$STATE_FILE")
ENABLED=$(echo "$FRONTMATTER" | grep '^enabled:' | sed 's/enabled: *//')没有 yq、没有 jq，纯 sed + grep 搞定。
3. “沉默即优雅”的默认行为
这是整套模式里最聪明的一步。插件的 hook 脚本启动后，第一时间检查 .claude/插件名.local.md 是否存在。不存在就直接 exit 0，不报错、不中断、不留痕迹。
很多插件的 hook 脚本一上来就疯狂报 Warning，configured-agent 的策略是：没有配置就等于用户没装这个插件，跟 Claude Code 本身的行为逻辑保持一致。
和 CLAUDE.md、Memory 有什么区别？
Claude Code 生态里已经有多种记忆机制，但各自解决的问题不同：
- CLAUDE.md：项目级记忆，每次会话自动加载，属于“项目该知道的事”
- Auto Memory：跨会话记住用户偏好、项目规范、过往决策，由 Claude 自己写笔记-
- Subagent Memory：每个子 Agent 自己的持久化知识库，在 v2.1.33 版本引入
而 configured-agent 解决的是插件开发者的问题——它不是帮 Claude 记住东西，而是帮插件的配置找到一个标准化的存放和读取方式。
更宏观地看，Configure 这个体系本身正在做另一件事：给 Agent 一个属于用户的记忆层——CLAUDE.md 属于代码仓库，Configure 属于用户本人。用户的开发偏好、跨仓库的经验、其他 Agent 学到的东西，都可以通过 Configure 在不同 Agent 之间共享。今天 Claude Code 学会的事，明天 Codex 就能知道。而 configured-agent 正是这个体系在 Claude Code 插件层面的具体落地形态。
怎么用？
前置条件极低。configured-agent 不是需要安装的包，它是一套约定和代码模板。你只需要一个能用 Claude Code 的项目。
- 在项目根目录创建 .claude/插件名.local.md 文件
- 用 YAML frontmatter 写配置
- 在插件的 hook 脚本里用那四行 sed 代码读配置
- 把 .claude/*.local.md 加入 .gitignore
就这么简单。
一句话总结
configured-agent 解决的不是“AI 能不能记住”的问题，而是“插件的配置到底放哪、怎么读” 这个更基础的问题。它用 YAML frontmatter + 四行 bash 代码，把每个插件都得重新发明一遍的轮子，变成了一个可以直接复用的模式。
资源 | 链接 |
Smithery 页面 | smithery.ai/skills/anthropics/configured-agent |
Claude Code 官方文档 | docs.anthropic.com |
在一个插件生态越来越丰富的系统里，这种“约定优于配置”的底层设计，往往比花哨的功能更能决定生态能长多大。
