如何给AI Agent装上业务大脑commerce-agents的SKILL.md技能体系深度解析含10个现成流程模板【免费下载链接】commerce-agentsReference blueprint for building shopping and merchant agents with Claude. Examples in retail, commerce, telecom, and entertainment included.项目地址: https://gitcode.com/gh_mirrors/co/commerce-agentscommerce-agents是一套用 Claude 构建购物 Agent 与商家 Agent 的开源参考蓝图覆盖零售、出行、电信、娱乐四个行业。它的核心设计是SKILL.md 技能体系把搜索导购、库存告警、定价促销等业务流程写成一份份 Markdown 技能文件让 AI Agent 直接获得可落地的业务大脑。本文带你拆解这套体系的 3 段式结构并盘点10 个现成流程模板帮你快速给自己的 Agent 装上业务技能。一句话理解 SKILL.mdAgent 的技能包在 commerce-agents 中一个技能 一个目录 一份SKILL.md文件。加载逻辑在 skills.py 中实现结构非常清晰YAML frontmatter头部元数据必须包含name技能名和description技能描述含何时用、何时不用Markdown 正文技能本体真正的业务流程指令告诉 Agent 如何分步完成任务关键机制是按需加载见 load_skill_dir 与 SkillRegistryAgent 的系统提示词里只放一份技能索引——每个技能一行名字 一句话描述index_block对话中 Agent 判断当前请求属于哪个技能才调用load_skill拉取该技能的完整正文这就好比新员工入职手册目录永远在手边只有干到哪个流程才翻开哪一章。好处是提示词永不臃肿而业务深度一点没少。SKILL.md 的三段式写法模板拆解以商家侧的 inventory-operations 技能 为例每个 SKILL.md 都遵循相同的骨架第一段frontmatter 声明技能边界description字段不仅是摘要更是路由规则。例如它明确写出 Not needed for performance questions with no operational action attached没有操作动作的纯数据提问不属于本技能——Agent 靠这句话就能把请求分发给正确的技能。第二段事实来源规则防幻觉护栏每个技能开头都会规定哪些数字只能来自哪个工具。比如库存技能的每日简报必须由get_inventory_alerts、get_order_issues、get_business_snapshot一次拉齐禁止用昨天的简报或记忆当数据源。这一条直接杜绝了 Agent 编造数字。第三段分步操作流程 交接规则正文按子场景分节##小节每节都是拿到什么 → 判断什么 → 用什么工具 → 输出什么的可执行步骤结尾通常声明交接Hand-off哪些事不归自己管转给哪个兄弟技能。10 个现成流程模板一览 ️仓库为两个角色各准备了 5 个技能共 10 个可直接复用的流程模板️ 购物 Agent 侧面向消费者技能解决什么路径search-discovery把模糊需求变成 3~6 个候选 一个推荐SKILL.mdpurchase-research教用户这个品类怎么买选购标准课SKILL.mdplanning-goals按天/按人/按预算拆解的整单规划如旅行装备清单SKILL.mdcustomer-care查单、退货、换货、退款、破损处理SKILL.mdmemory-personalization记住/纠正/忘掉用户偏好个性化推荐SKILL.md 商家 Agent 侧面向店主/运营技能解决什么路径catalog-listings商品标题/描述/属性优化与批量质检SKILL.mdinventory-operations库存告警、慢动销处理、订单异常分诊SKILL.mdpricing-promotions调价、打折、日期绑定的促销带护栏校验SKILL.mdmarketing-campaigns拉新/召回/临期提醒等营销活动草稿SKILL.mdperformance-insights指标异动归因为什么涨了/跌了SKILL.md深入 3 个模板看好技能长什么样 模板 1search-discovery —— 把送礼需求翻译成搜索动作这个技能最精彩的地方是把隐含约束直接变成搜索条件而不是反问用户从消息里提取预算、收礼人、日期、尺寸、用途塞进过滤器只有缺了这个事实就搜不了比如订房却没日期才问而且一次只问一个问题并附上候选答案按钮。输出端规定3~6 个候选、推荐款排第一、每个候选的推荐理由必须点名它满足了用户的哪条约束。模板 2inventory-operations —— 商家侧的每日作战简报它规定了简报的完整生产流程一次拉齐告警 订单异常 经营快照 昨日未处理变更 → 按涉及金额 → 时间窗紧迫度排序 → 压缩到 3~6 条 → 每条给出问题、数字、下一步动作并把动作做成一键按钮直接衔接暂存变更。慢动销场景更给出了标准三选项留着、降价、下架并要求把剩余量、动销速度、过期日期、利润率四个数字摆出来让店主判断。模板 3pricing-promotions —— 自带护栏的定价流程定价是最容易出事故的领域这个模板把护栏写进了流程调价幅度必须受max_price_delta_pct永久调价上限和max_promotion_discount_pct促销深度上限约束超出上限的诉求不能偷偷按上限执行必须先说明上限、给出范围内的替代方案利润数字只能引用工具返回值禁止自己算。这正是AI 做生意必须的安全感来源——所有写操作都是暂存变更等人工审批后才真正生效设计原则见 docs/safety.md。这套体系最值得偷师的 4 个设计 描述即路由frontmatter 的description写清何时用 何时不用10 个技能互不越界Agent 靠自然语言就能选对技能技能间显式交接如库存技能把降价移交给 pricing-promotions附上交接时要带的上下文剩余量、库龄、日动销形成流水线数字必须可溯源每个技能都规定数据只能来自本轮对话中工具的真实返回推算值必须连输入一起展示所有写入先暂存商家侧任何变更都经stage_*工具生成带 diff 的预览店主确认后才落地如何把它搬进自己的项目 按目录约定放技能每个技能一个子目录内含SKILL.mdname全局唯一即可被 load_skills 自动扫描注册无需改代码实现后端接口购物侧实现 StorefrontBackend对接你的商品/购物车/订单/政策系统商家侧实现 MerchantBackend对接分析/目录/库存/定价/营销系统映射方法见 docs/backends.md参考四个垂直行业样例examples/下的 retail、travel、telecom、entertainment 演示了同一套技能库如何在不同行业落地listing 一词在产品/房型/套餐/票档间自动泛化用脚手架起步仓库内置 plugins/commerce-builder/ 插件/scaffold-commerce-agent命令可交互式生成适配你系统的 Agent 工程/review-commerce-agent则能审查已有实现这套 SKILL.md 技能体系证明了AI Agent 的业务能力不必全靠聪明更多可以来自结构化的流程文档。10 个模板就是 10 套经过推敲的业务 SOP读完它们你会明白一个靠谱的电商 Agent 到底该在每一步做什么、说什么、不说什么。【免费下载链接】commerce-agentsReference blueprint for building shopping and merchant agents with Claude. Examples in retail, commerce, telecom, and entertainment included.项目地址: https://gitcode.com/gh_mirrors/co/commerce-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考