该资料介绍 Anthropic 参考商务智能体的整体架构，路径位于参考仓库中：commerce_common/、shopping_agent/、merchant_agent/ 及两个 runtime。
用途与循环：一个模型拥有整段对话，一轮由 ShoppingAgent.stream_turn 或 MerchantAgent.stream_turn 驱动，模型读取缓存提示、并发调用工具，最后以文本加展示调用结束，没有路由、分类器或交接。所有调用都经角色执行器（ShoppingToolExecutor、MerchantToolExecutor）走 BaseToolExecutor.execute，该执行不抛异常；达到 max_tool_iterations 后强制无工具轮次。
规则分层：单次调用参数规则放在工具描述（tools/registry.py 的 build_tools）；多数轮次适用的规则放在静态提示（prompt.py 的 build_static_system）；少数多步流程放在按需加载的技能中。
技能：技能是含 SKILL.md 的目录，frontmatter 有 name 与 description，正文由 parse_skill_md 解析。静态提示只带索引（SkillRegistry.index_block），load_skill 返回正文；Agent SDK 下 ensure_project_skills 链接到 .claude/skills/，SKILL_TOOL_ADAPTER 指向 SDK 的 Skill 工具。
后端接口：每个角色实现一个抽象类。StorefrontBackend 有 11 个抽象方法（目录 2、购物车 4、偏好 1、订单 2、政策 1、履约 1），get_account_context、get_disclosure、checkout_handoff 有默认实现，没有方法下单或动钱。MerchantBackend 有 16 个抽象方法（读取 8、变更生命周期 8），execute_analysis_query、get_analysis_schema、get_merchant_context 有默认实现。按尺寸、颜色或档位销售的商品是带 options 的 family 记录，变体各为带 option_values 与 variant_of 的记录。资格、定价、库存与数量规则在后端执行，门控检查来源与上限。未接通的系统用会失败的方法表示，业务完全没有的系统通过 enable_* 开关关闭并移除工具、提示行与接地规则。
委托：DelegateExtension 接收 brief 与 DelegationContext，返回经 result_model 校验的结果，不能写入、展示或再委托，每轮调用受 max_delegate_calls_per_turn 限制。MerchantAgent 接受 extra_delegates，内置 run_analysis；ShoppingAgent 不注册委托。
模型字段：model 运行轮次循环，memory_model 做轮后抽取，analysis_model 运行委托，为 None 时用 model。
禁忌：不要按请求改变 tools[] 或静态提示；不要把多数轮次规则放进技能；不要仅靠提示文本执行上限或权限；不要让模型编写价格、数字或条款；不要向核心包添加领域工具。