# 拆解 anthropics/commerce-agents：官方不再只发技能，开始发图纸
## 概述
## 一、选题逻辑：为什么跳过 6878 星，拆 1564 星
还有一个本机证据支撑“官方货柜正在换货架”的判断：本环境安装的官方 example-skills 插件清单可见 16 件（algorithmic-art、brand-guidelines、canvas-design、doc-coauthoring、docx、frontend-design、internal-comms、mcp-builder、pdf、pptx、skill-creator、slack-gif-creator、theme-factory、web-artifacts-builder、webapp-testing、xlsx），清一色是**单能力技能**——一件管一类活。而 commerce-agents 的描述里没有出现任何“能做某件事”的动词，它卖的是图纸。官方自家货柜上，这两种形态第一次同框。
## 二、评测对比表
权重沿用本栏固定口径：功能完整度 25%、设计质量 25%、实战效果 20%、上手难度 15%、社区活跃度 15%（上手分越高越容易）。社区新星的分数直接沿用今日第 1 轮周报的评级，不重复造表：
| 对象 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 社区 15% | 加权总分 |
|---|---|---|---|---|---|---|
| **commerce-agents**（官方蓝图，本描述级评级 ▲） | ★★★☆ | ★★★★ | ★★★（待验证） | ★★★ | ★★★★★ | **3.7** |
| sepia（去 AI 味写作，沿用一轮评级） | ★★★★ | ★★★★ | ★★★☆（待验证） | ★★★★★ | ★★★★★ | 4.2 |
| scroll-craft（滚动叙事，沿用一轮评级） | ★★★★ | ★★★★★ | ★★★★（待验证） | ★★★★ | ★★★★ | 4.1 |
| goldie（商店截图，沿用一轮评级） | ★★★★ | ★★★★ | ★★★★（待验证） | ★★★ | ★★★★ | 3.9 |
> 评分说明：▲ commerce-agents 全部五格均为描述级估分——仓库内部结构未取得，功能与实战分按“蓝图形态天然非开箱即用”保守给；社区五星的依据是官方组织背书加首日 1564 星的冷启动速度，但要提醒一句：**官方仓库的星数是注意力指标，不是质量指标**。它在本表排最后一名不是看衰，而是如实反映“图纸还没盖成楼”的现状。
## 三、描述逐词拆：一句截断话里的五个设计决定
> Reference blueprint for building shopping and merchant agents with Claude. Examples in retail, comme
就这半句话，能榨出五个设计决定：
**① 名词选了 "blueprint"，不是 skill/tool/framework。** 这是全句最重的一个词。官方在自己的命名体系里开了一个新品类：skill 是装进 `~/.claude/skills/` 的触发包，tool 是挂进上下文的函数，framework 是要学的代码库——而 blueprint 是**供拷贝和改造的图纸**。命名即分发方式：它预期你 `git clone` 下来改，而不是 `npx skills add` 装完即用。对照本栏目拆过的官方 mcp-builder（09-03 期，全文级）——那是一件“教造 MCP 的技能”，仍然是技能形态；commerce-agents 连“教”都省了，直接把成品建筑图摊开给你。
**② "shopping and merchant agents"——买卖双边，一次给齐。** 描述没有写 "a shopping agent"（一个购物助手），而是双主体并列：买方 agent 和卖方 agent。这是描述里信息量最大的三个词。它意味着这份蓝图大概率内含**两个 agent 的互操作场景**——购物Agent 发起请求、商家Agent 应答报价，交易在两个自动化主体之间推进。单 agent 教程生态已经泛滥，“双边”才是官方要立标的增量：它把电商当成了多 agent 协作的**标准沙盘**来推。
**③ 为什么偏偏是电商？因为电商是天然带验收状态机。** 商品目录→购物车→下单→支付→履约，每一步都有业界公认的状态边界，错一步就是可见的故障——这恰好是官方示例最需要的性质：**每一段协作都有可判定的完成标准**。对照科研类（PRAXIST 的 "measurable research"）要用大量篇幅自建度量，电商的度量是现成的。选材逻辑本身就是设计。
**④ "Examples in retail…"——示例先行，垂直切入。** 官方文档哲学一贯是 cookbook 式的：不给抽象框架，给一个能跑的零售场景让你 fork。截断处的 "comme" 大概率续接 "commerce"（推断，不作断言），暗示零售之外还有第二个示例垂直。对想上架自己蓝图仓的作者，这句是可直接抄的写法：**先承诺一个垂直示例，再谈通用性**。
**⑤ "with Claude" 三个词是生态卡位。** 不是 "using Claude Code"，也不是 "for Claude"——蓝图绑定的是 Claude 的模型层能力（工具调用、长程规划），这把 commerce-agents 放进了“官方为自家模型写参考实现”的传统里。对读者的实际含义：蓝图里的提示词工程、工具编排假定的是 Claude 的行为习惯，迁移到其他 harness 时这部分要重调。
## 四、黑箱推演：一份商务蓝图必答的六道题
仓库内部未取得，但“买卖双边 agent 蓝图”要立得住，有几道题**任何实现都绕不开**。用本栏目已拆实的范式当参照系，这是装前验货清单：
**第一题：支付动作的授权边界在哪？** 这是整套蓝图的试金石。可核对的黄金范式是本栏目 9-4 期字节层拆解里的“提议-裁决分离”（reverify：模型提议，确定性工具裁决）——commerce 的对应物应当是**“agent 提议交易，人类确认门放行支付”**。若蓝图允许 agent 直接执行扣款，这蓝图就不是参考实现而是事故模板（内部实现未验证，验货第 1 项）。
**第二题：双边协议是落盘的 schema，还是对话默契？** 本栏目 azure 家族拆解给出的范式是**磁盘文件契约**——下游检查上游落盘产物，不信任对话记忆。买卖 agent 的对应物是共享的消息/报价 schema 文件。协议只存在于提示词默契里，两个 agent 的对话第三轮就会漂移（未验证，验货第 2 项）。
**第三题：商品目录数据从哪来？** 三种可能：MCP 工具实时取、静态 fixture、示例 API。open-seo-mcp-skills（今日一轮已拆）演示了“MCP 工具 + Skill 提示层”的混合架构，若 commerce-agents 选了同款路线，目录数据会走 MCP；若走 fixture，则它是纯教学沙盘，离生产远一层（未验证，验货第 3 项）。
**第四题：交易状态存在哪？** 购物车、订单状态机是长程任务的典型状态。范式答案还是 azure 的 `.azure/deployment-plan.md` 形态——每笔交易一个状态文件，崩溃可恢复。靠对话记忆持有购物车，是长程 agent 最常见的翻车点（未验证，验货第 4 项）。
**第五题：第二个垂直示例在哪？** 本栏目 headcount 拆解（09-03 期）的教训原话可查：“125 个岗位有多少闲岗”的担忧——结构铺得越开，单点质量越难保。蓝图仓的对应风险是：retail 示例精雕，第二个垂直敷衍。examples/ 目录的文件数量与提交密度，是判断官方投入度的最快指标（未验证，验货第 5 项）。
**第六题：它和 Skills 规范到底什么关系？** 决定分发形态的终极问题。仓库里若出现 SKILL.md，它就同时是一件可安装技能；若没有，它就是纯图纸。本栏目 8-29 期记录的 ECC“四路拷贝”与 sepia“77+ 端适配器”对照说明：同一份能力，分发形态的选择本身就是架构决策。官方选哪种，会直接影响后续蓝图类仓库的行业默认形态（未验证，验货第 6 项）。
```mermaid
flowchart LR
A["买方 shopping agent"] <-->|"双边协议
题2：schema 落盘？"| B["卖方 merchant agent"]
A --> C["商品目录
题3：MCP 还是 fixture"]
A --> D["购物车/订单状态
题4：状态文件还是对话记忆"]
B --> C
A --> E["支付动作"]
E --> F{"人类确认门
题1：授权边界"}
F -->|"放行"| G["扣款执行"]
F -->|"驳回"| A
```
## 五、官方家族图谱：三层货柜的第一次齐装
把可核实的官方产物摆到一张图上，anthropics 的货柜结构其实已经清晰：
```mermaid
mindmap
root((anthropics 官方货柜))
技能层
example-skills 十六件
docx pptx xlsx 办公件
webapp-testing 验收件
frontend-design 审美件
元工具层
skill-creator 造技能
mcp-builder 造网关
架构层 本期
commerce-agents 电商蓝图
```
三层各司其职：**技能层**解决“会不会做某件事”，**元工具层**解决“怎么造新器官”（skill-creator 与 mcp-builder 本栏均做过全文级拆解），**架构层**解决“多个器官如何组成系统”。commerce-agents 是架构层的第一个公开样本。这个分层对普通作者的启示比仓库本身更值钱：发布自己的作品时，先想清楚你在哪一层——把架构仓写成技能、或把技能吹成架构，是本栏目在 headcount 和 ECC 两个样本上都见过的定位错位。
## 六、适用与不适用：谁该 clone，谁该划走
**适用**：想给自家业务搭购物/商家 agent 的工程团队（抄状态机与协议结构）；研究多 agent 互操作的开发者（双边场景的官方参考实现目前屈指可数）；打算做垂直行业蓝图仓的作者（抄“蓝图+示例先行”的仓格与文档顺序）。
**不适用**：想一键装进 `~/.claude/skills/` 的个人用户——在 SKILL.md 出现的证据之前，把它当技能装是错误姿势；找“帮我自动下单省钱”成品的普通用户——图纸不是家电；期待开箱即用的效率工具党——上手分三星已经是宽容评分。
## 七、安装与使用
```bash
# 官方蓝图仓：git clone 是唯一已确证的获取方式
git clone https://github.com/anthropics/commerce-agents
cd commerce-agents
# 进仓后先看两处：examples/ 下的 retail 示例（验货第5项）、
# 全仓搜索 SKILL.md（验货第6项：是否可技能化安装）
```
`npx skills add anthropics/commerce-agents` 之类的技能市场安装**未经证实**，在其被官方收录进技能目录之前，请勿轻信第三方转载的安装命令。对照安装（本表其他三件，均为此前各期已给过命令的同族样本）：sepia 与 scroll-craft 走社区技能市场常规安装，goldie 为 `npx skills add kacperkapusciak/goldie`（09-03 期存档口径）。
## 八、推荐排行榜
- **本周官方信号价值最高**：commerce-agents——架构层开柜，比星数本身重要
- **同周社区热度最高**：sepia（1875 星）——去 AI 味写作踩中集体情绪
- **即战力最强（对照系）**：goldie（加权 3.9）——确定性产出，装了就能用
- **最值得抄的仓格**：commerce-agents 的“蓝图+垂直示例”结构，蓝图类作者的免费模板
- **星数溢价最需警惕**：commerce-agents——官方光环下的 1564 星，阅读时建议自动打七折
## 结论
本周 Skills 生态最有分量的官方动作，不是又发了多少件技能，而是发了一张图纸。commerce-agents 透露的路线图很直白：技能层的供给已经溢出（今日一轮周报的判词是“集体卷表达层”），官方把筹码押向了多 agent 协作最难啃的验收密集型场景——电商。对读者，行动清单只有三条：clone 下来读 retail 示例、盯它会不会补 SKILL.md、以及把“蓝图+示例”的仓格抄走。至于它值不值得装——先等它回答六道验货题，尤其是第一道：支付按钮，到底握在谁手里。
## 参考来源
> [!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 等场景全覆盖。
