# 拆装机顾问：官方教你调教 Claude ## 概述 本期定期观察做一次单件深拆，对象是官方插件市场里的 `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 个文件的目录厚度（下文详述）。 ## 翻案故事：它为什么先被打了 3.15 9 月 20 日那期快照对账，把 hookify、claude-md-improver、claude-automation-recommender 打包成「配置三小件」点评，当时的结论是：轻、专、单文件形态，属于「配套件而非主力件」，单独拎出来都不足以成为装机理由。这个判断错了一半——错的那一半恰好值得所有 Skill 作者记住。 错因在「单文件形态」四个字。当时的点评把它当成了和 writing-rules 一样的薄件，但一周后细看目录才发现：**SKILL.md 只是入口，真正的体重全在五份 reference 分册里**。这正是官方 skill-creator 一直倡导的「渐进披露」写法：主文件短到几屏读完，细节下沉到 reference，Claude 触发技能后按需加载。判断一个件的厚薄，数 SKILL.md 的行数是外行做法，数整个目录的字节数才是内行做法。 这件事的教训可以写成一条设计定律：**渐进披露的代价是「第一眼被低估」**——目录越克制，路人越以为你没货。官方用自己的件示范了这条定律，也算是一种行为艺术。 ## 逐文件开盖 ### 第一层：plugin.json + README + 一张截图 插件壳的三件套里，最值得注意的是那张 `automation-recommender-example.png`。官方给一个推荐配置的工具专门配了效果截图，说明这类「顾问型」件的销售逻辑和工具型件不同：工具型件靠 description 触发就行，顾问型件得先让用户在市场列表里看懂「它能给我什么」——截图是最短的说服路径。README 与 plugin.json 是标准配置，此处不展开。 ### 第二层：SKILL.md，克制到只剩流程 按官方渐进披露的惯例（本刊拆 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 触发的不是一段提示词，而是一整套官方编纂的配置工程学。 ## 五大扩展点地图 ```mermaid 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
事件拦截"] G["MCP
外接工具"] H["Plugins
打包分发"] I["Skills
知识注入"] J["Subagents
分身子"] end A --> F B --> G C --> H D --> I E --> J ``` 这张图能解释 9 月 28 日给它设计质量满分的原因：五分册与扩展点一一对应，不重叠、不遗漏，检索路径最短。Claude 接到配置问题后，一眼就知道该翻哪一册。 ## 工作流：一次「体检」怎么跑 ```mermaid flowchart TD S["用户说出痛点"] --> T["SKILL.md 接诊
识别涉及哪个扩展点"] T --> U["翻对应分册
按需加载"] U --> V["输出推荐清单
hook 与 MCP 与件"] V --> W["写入 settings.json
等配置文件"] 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 的分工：配机器的和造机器的 同在官方市场的 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 的环境（推荐了也落不了地）；期望它推荐社区第三方件的（五分册的知识边界在官方体系内，社区生态那几千个件不在处方里——这是它作为官方件的天花板，也是不越界的安全带）。 ## 安装命令 ```bash # 添加官方插件市场（已添加过可跳过） /plugin marketplace add anthropics/claude-plugins-official # 安装装机顾问所在插件 /plugin install claude-code-setup@claude-plugins-official # 对照组：造件工装 /plugin install plugin-dev@claude-plugins-official ``` （若市场名与界面显示不一致，以 `/plugin` 面板为准。） ## 推荐排行榜 - **综合榜**：claude-automation-recommender 4.40 > plugin-dev 七件套 4.30 > claude-md-improver 3.40 > writing-rules 3.20 - **设计奖**：装机顾问——五分册对五大扩展点，一一对应零冗余，渐进披露的标准答卷 - **翻案奖**：还是它——从 3.15 到 4.40，八天里完成了一次「目录厚度重估」 - **工装奖**：plugin-dev——三个验证子代理加三个 Hook 质检脚本，官方唯一带自检工具的插件 - **警示奖**：writing-rules 与 claude-md-improver——单文件形态的「配套件」们，好上手，但厚度撑不起高频使用 ## 结语 装机顾问值得记住的不是它推荐了什么，而是它的存在本身：当官方开始把「怎么用好自己」写成 Skill，说明 Skill 这种格式已经被当成了文档的完全替代品——文档是给人看的，Skill 是给 Claude 执行的。你的项目文档还在只给人看吗？这是本期留给大家的问题。 ## 参考来源 1. 本机官方插件市场快照 `~/.claude/plugins/marketplaces/claude-plugins-official/`（claude-code-setup 插件完整目录树：SKILL.md 加五份 references、README、效果截图、plugin.json；plugin-dev 插件 72 文件清单）——本文全部结构拆解依据 2. 本刊 2026-09-28《装机盘里长出一条电信产线》— claude-automation-recommender 4.40 分评测、官方市场板块与 external_plugins 十三家清单 3. 本刊 2026-09-20 快照对账 — 「配置三小件」板块：hookify、claude-md-improver、claude-automation-recommender 首次点评与 3.15 分原始记录 4. 本刊 2026-10-01《效率件进了编制：官方四闸拆解》— 官方编制插件清单表中 claude-code-setup「技能+5份reference」一行记录 5. [anthropics/skills](https://github.com/anthropics/skills) — 官方示例技能仓库，本刊多期引用的官方包背景来源 > [!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 等场景全覆盖。