本期定期观察做一次单件深拆，对象是官方插件市场里的 claude-code-setup——核心件叫 claude-automation-recommender，姑且叫它「装机顾问」：扫你的工作流，告诉你该配什么 hook、什么 MCP、什么子代理。它在本刊 9 月 20 日快照对账里只拿了 3.15 分，被归入「配套件」；9 月 28 日翻盘拿下综合第一 4.40 分。这期把它的完整目录树一层层开盖，讲清楚三件事：为什么它曾被低估、五份 reference 分册各自装了什么、以及它和隔壁 plugin-dev 七件套怎么分工。全部文件清单来自本机官方市场快照的实际目录，未采信任何未核实的星标数据。
开盖之前先亮清单，以下为本机 claude-plugins-official 市场快照中 claude-code-setup 插件的全部文件：
claude-code-setup/
├── .claude-plugin/plugin.json # 插件清单
├── README.md # 说明书
├── automation-recommender-example.png # 效果截图
└── skills/claude-automation-recommender/
├── SKILL.md # 入口件
└── references/
├── hooks-patterns.md # Hook 模式库
├── mcp-servers.md # MCP 选型库
├── plugins-reference.md # 插件目录
├── skills-reference.md # 技能目录
└── subagent-templates.md # 子代理模板
就这么多。一个插件、一个技能、零脚本、五份参考文档。这个「瘦入口 + 胖参考」的比例，本身就是本文第一个拆点。
| 件 | 形态 | 9/20 分 | 9/28 分 | 本期分 | 一句话判词 |
|---|---|---|---|---|---|
| claude-automation-recommender | 技能+5分册 | 3.15 | 4.40 | 4.40 | 官方扩展体系的元知识库 |
| plugin-dev 七件套 | 技能×7+代理×3+命令 | 趋势奖 | 未评分 | 4.30 | 造件全工装，重但全 |
| writing-rules（hookify 内） | 单技能 | 3.15 | — | 3.20 | 教写规则，薄 |
| claude-md-improver | 技能+references | 3.30 | — | 3.40 | 改 CLAUDE.md 的专科医生 |
评分口径：延续本刊五维加权（功能 25%、设计 25%、实战 20%、上手 15%、活跃 15%），9/20 与 9/28 两列为快照原始分，本期分依据本机目录树证据复核。plugin-dev 本期首次给分，依据为其 72 个文件的目录厚度（下文详述）。
9 月 20 日那期快照对账，把 hookify、claude-md-improver、claude-automation-recommender 打包成「配置三小件」点评，当时的结论是：轻、专、单文件形态，属于「配套件而非主力件」，单独拎出来都不足以成为装机理由。这个判断错了一半——错的那一半恰好值得所有 Skill 作者记住。
错因在「单文件形态」四个字。当时的点评把它当成了和 writing-rules 一样的薄件，但一周后细看目录才发现：SKILL.md 只是入口，真正的体重全在五份 reference 分册里。这正是官方 skill-creator 一直倡导的「渐进披露」写法：主文件短到几屏读完，细节下沉到 reference，Claude 触发技能后按需加载。判断一个件的厚薄，数 SKILL.md 的行数是外行做法，数整个目录的字节数才是内行做法。
这件事的教训可以写成一条设计定律：渐进披露的代价是「第一眼被低估」——目录越克制，路人越以为你没货。官方用自己的件示范了这条定律，也算是一种行为艺术。
插件壳的三件套里，最值得注意的是那张 automation-recommender-example.png。官方给一个推荐配置的工具专门配了效果截图，说明这类「顾问型」件的销售逻辑和工具型件不同：工具型件靠 description 触发就行，顾问型件得先让用户在市场列表里看懂「它能给我什么」——截图是最短的说服路径。README 与 plugin.json 是标准配置，此处不展开。
按官方渐进披露的惯例（本刊拆 skill-creator、theme-factory 时已验证过官方写法），这类入口件的正文通常只干三件事：说明自己负责什么边界、给出「扫描→诊断→推荐」的工作流骨架、然后把每个环节指向具体的 reference 文件。装机顾问的 SKILL.md 正是这种编排：它自己不背任何 Hook 语法或 MCP 清单，只负责「接诊」。
对比一下反面教材：本刊 9 月 28 日拆过的 telecom-news-digest，全件只有一份 SKILL.md，输出风格全靠一段提示词扛，拿了 3.05 的全场最低分。装机顾问是它的镜像——所有领域知识全部外置，入口件瘦成一张分诊台。
这是全件最值得逐个讲的部位。五个文件名不是随手起的，每个对应 Claude Code 的一个扩展点：
hooks-patterns.md（Hook 模式库）——Hook 是 Claude Code 里最容易被滥用的扩展点，规则写得笨，每次工具调用都被无谓拦截。这份分册装的是「什么场景配什么钩子」的模式集合，等于把官方观察到的社区翻车案例反编译成了正面清单。隔壁 hookify 插件专门为「写规则」立一件，说明官方确实在社区里看到了大量 Hook 用法翻车；两相对照，这份模式库就是药方本体。
mcp-servers.md（MCP 选型库）——MCP 生态已经是几千个服务器的江湖，选哪个、信哪个、怎么配 stdio 还是 HTTP，都是新手劝退点。这份分册把选型知识前置固化，Claude 推荐时不用每次现场调研。
plugins-reference.md（插件目录） 与 skills-reference.md（技能目录）——这两份合起来是「货架说明书」：告诉 Claude 官方体系里有什么可装的件、各自触发条件是什么。注意这是一个很新的知识形态：以前「Claude Code 生态里有什么」这种问题靠人肉刷榜单，现在它被写成文件喂给了 Claude 自己。
subagent-templates.md（子代理模板）——五分册里唯一带「模板」字样的文件。子代理（subagent）是扩展点里配置成本最高的一种，要从零写系统提示词；提供模板等于把这件事的门槛从「会写」降到「会改」。
五份合起来看，这个件的真正身份就清楚了：它不是工具，是官方把自家扩展体系整理成的元知识库。用户问「我想让 Claude 每次 commit 前自动跑 lint 该怎么配」，Claude 触发的不是一段提示词，而是一整套官方编纂的配置工程学。
flowchart TD
subgraph REC["装机顾问五分册"]
A["hooks-patterns"]
B["mcp-servers"]
C["plugins-reference"]
D["skills-reference"]
E["subagent-templates"]
end
subgraph SYS["Claude Code 扩展体系"]
F["Hooks<br/>事件拦截"]
G["MCP<br/>外接工具"]
H["Plugins<br/>打包分发"]
I["Skills<br/>知识注入"]
J["Subagents<br/>分身子"]
end
A --> F
B --> G
C --> H
D --> I
E --> J
这张图能解释 9 月 28 日给它设计质量满分的原因：五分册与扩展点一一对应，不重叠、不遗漏，检索路径最短。Claude 接到配置问题后，一眼就知道该翻哪一册。
flowchart TD
S["用户说出痛点"] --> T["SKILL.md 接诊<br/>识别涉及哪个扩展点"]
T --> U["翻对应分册<br/>按需加载"]
U --> V["输出推荐清单<br/>hook 与 MCP 与件"]
V --> W["写入 settings.json<br/>等配置文件"]
W --> X["用户复核后生效"]
最后一步画成独立节点是有意的：推荐归推荐，落盘 settings.json 的动作应当由用户复核后执行。这也是官方配置类件（如同族的 update-config，本会话内的注册描述即明言服务对象是 settings.json 与 hooks 配置）共同的边界设计——顾问不开药方之外的手。对照本刊 10 月 1 日拆过的编制内四闸（code-review、simplify、verify、security-review），可以看到官方对「件权限」的一贯克制：审查件不修码，配置件不自动改配置。
装机顾问这类件的用户输入有个特点：用户不知道自己要什么，只会描述症状——「每次都要手动跑测试」「context 窗口不够用」「想让它在提交前检查一下」。所以它的触发设计不可能靠单一硬词，得靠一组「配置痛感词」：hooks、settings、permissions、自动化、MCP 服务器之类。这与垂直件（如 3gpp-5g-specs，用户贴出 TS 编号即命中）的触发策略完全相反：垂直件是行话即门铃，顾问件是症状即门铃。
对 Skill 作者的启示：写 description 之前先回答「用户触发这件时，嘴里说的是行话还是症状」。前者把行话堆进 description 即可，后者得把痛点场景写成描述短语。
同在官方市场的 plugin-dev 插件是装机顾问最好的对照组。本机快照里它有 72 个文件：七个技能（skill、command、hook、agent、mcp-integration、plugin-structure、plugin-settings 六大主题加设置件）、三个子代理（plugin-validator、skill-reviewer、agent-creator）、一条 create-plugin 命令，hook-development 还带了三个质检脚本（hook-linter、test-hook、validate-hook-schema）。
两个细节最见功力。其一，plugin-dev 的每个技能都是「SKILL.md + references + examples + scripts」四层结构，比装机顾问多了 examples 和 scripts 两层——因为造件需要可抄的样例和可跑的校验，配机器只需要知识。其二，skill-development 的 references 里躺着一份 skill-creator-original.md——官方把 skill-creator 的原件直接收编成了参考文档，造件知识在官方体系内部完成了一次闭环。
分工由此清晰：装机顾问管「把你现有的 Claude Code 调到最佳状态」，plugin-dev 管「给 Claude 造新器官」。前者是运维件，后者是研发件。本刊 9 月 28 日把趋势奖发给 plugin-dev 七件套时说过一句话：生态的下一个增长点不是「用 AI 的件」，而是「教 AI 用 AI 的件」——现在可以补一句下半句：教 AI 配 AI 的件，和教 AI 造 AI 的件，官方各立了一户。
适用场景：装完 Claude Code 不知从哪调起的新手；团队想统一 hooks 与权限配置规范的技术负责人；「感觉 Claude 不听话但说不清哪不对」的老用户——这类症状多半是配置债，顾问件就是体检报告。
不适用场景：想要现成工具的（它不干活，只出主意）；企业策略锁死 settings.json 的环境（推荐了也落不了地）；期望它推荐社区第三方件的（五分册的知识边界在官方体系内，社区生态那几千个件不在处方里——这是它作为官方件的天花板，也是不越界的安全带）。
# 添加官方插件市场（已添加过可跳过）
/plugin marketplace add anthropics/claude-plugins-official
# 安装装机顾问所在插件
/plugin install claude-code-setup@claude-plugins-official
# 对照组：造件工装
/plugin install plugin-dev@claude-plugins-official
（若市场名与界面显示不一致，以 /plugin 面板为准。）
装机顾问值得记住的不是它推荐了什么，而是它的存在本身：当官方开始把「怎么用好自己」写成 Skill，说明 Skill 这种格式已经被当成了文档的完全替代品——文档是给人看的，Skill 是给 Claude 执行的。你的项目文档还在只给人看吗？这是本期留给大家的问题。
~/.claude/plugins/marketplaces/claude-plugins-official/（claude-code-setup 插件完整目录树：SKILL.md 加五份 references、README、效果截图、plugin.json；plugin-dev 插件 72 文件清单）——本文全部结构拆解依据[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。