还有一个本机证据支撑“官方货柜正在换货架”的判断:本环境安装的官方 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 项)。
flowchart LR
A["买方 shopping agent"] <-->|"双边协议<br/>题2:schema 落盘?"| B["卖方 merchant agent"]
A --> C["商品目录<br/>题3:MCP 还是 fixture"]
A --> D["购物车/订单状态<br/>题4:状态文件还是对话记忆"]
B --> C
A --> E["支付动作"]
E --> F{"人类确认门<br/>题1:授权边界"}
F -->|"放行"| G["扣款执行"]
F -->|"驳回"| A
把可核实的官方产物摆到一张图上,anthropics 的货柜结构其实已经清晰:
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 两个样本上都见过的定位错位。
适用:想给自家业务搭购物/商家 agent 的工程团队(抄状态机与协议结构);研究多 agent 互操作的开发者(双边场景的官方参考实现目前屈指可数);打算做垂直行业蓝图仓的作者(抄“蓝图+示例先行”的仓格与文档顺序)。
不适用:想一键装进 ~/.claude/skills/ 的个人用户——在 SKILL.md 出现的证据之前,把它当技能装是错误姿势;找“帮我自动下单省钱”成品的普通用户——图纸不是家电;期待开箱即用的效率工具党——上手分三星已经是宽容评分。
# 官方蓝图仓: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 期存档口径)。
本周 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 等场景全覆盖。
