THX Skill DocsSkill 使用说明
目录

Workflow Case

Walmart Item 活动前检查

Walmart 运营准备给一个 Item 上活动,担心页面信息、关键词机会、竞品价格和内部库存没有对齐。这个案例先把 Item / Product ID、活动目标和关键词放进同一条链路,再输出页面状态、市场信号、内部数据缺口和活动前必须确认的事项。

业务案例工作流反馈闭环
这是业务案例页,用来解释这个 Skill 在真实工作里怎么串成一条链路;它不替代安装页和运行逻辑页。页面暂不放图片,等内容确认后再补视觉图。
1

这条链路解决什么问题

Walmart 运营准备给一个 Item 上活动,担心页面信息、关键词机会、竞品价格和内部库存没有对齐。这个案例先把 Item / Product ID、活动目标和关键词放进同一条链路,再输出页面状态、市场信号、内部数据缺口和活动前必须确认的事项。

使用者

Walmart 运营、运营主管、Listing 和活动同事

交付目标

看 Walmart 链接、Listing 巡检、竞品对比、关键词搜索排名、订单利润、库存配送和掉量排查;通过 thx-walmart 独立 role 的 3 个只读 walmart_* wrapper 做 Item 健康、关键词机会和市场信号诊断。

2

输入层:从哪里开始

用户不需要先把材料整理得很完美,但必须给出足够的业务锚点。Skill 会先判断这些信息是否齐全,再决定是直接处理还是先追问。

Item ID / Product ID / 商品链接

这项用于确定任务范围和输出对象;不明确时先标待确认。

关键词、竞品链接、活动或掉量问题

这项用于确定任务范围和输出对象;不明确时先标待确认。

是否需要内部订单、利润、库存数据

这项用于确定任务范围和输出对象;不明确时先标待确认。

推荐第一句话:

WM开工检查
3

处理层:Skill 如何判断

业务输入 -> 字段识别 -> 任务分流 -> 调用必要规则或数据源 -> 生成结果 -> 自检缺口 -> 输出下一步动作
处理依据说明
来源walmart_item_health 看 Walmart Item / Product 健康
来源walmart_keyword_opportunity 看关键词机会候选
来源walmart_market_signal 看市场、竞品、类目和页面信号
来源Sorftime 优先看 Walmart 前台、搜索、Item / Product 数据
来源Firecrawl / Decodo 只作为兼容兜底或交叉验证
来源领星 ERP 只在安全封装和自家商品映射明确时作为经营证据
规则看外部链接默认优先走 thx-walmart 的 walmart_item_health 或 Sorftime
规则开工检查必须确认 tools/list 里有 3 个 walmart_* wrapper 和 sorftime_walmart_* 工具
规则tools/list 不能出现 amazon_*、boss_*、CEO 聚合、raw 底层工具或写操作
规则Sorftime 不可用时才降级到 Firecrawl / Decodo
规则没有官方后台接口证据时,不输出官方广告 Campaign 或平台后台结论
规则内部经营判断必须标明数据来源;缺口写进 data_gaps
如果这个 Skill 依赖 MCP,页面只说明服务边界和开工检查;员工不需要处理内部凭据,也不在页面里看到配置正文。
4

输出层:结果给谁使用

输出不是一段泛泛的回答,而是要让具体角色能继续推进工作。

输出使用方式
前台 Listing 状态、卖家和配送信息作为本次任务的可交付结果;如果证据不足,需要同时标出缺口和下一步确认方式。
关键词搜索结果和竞品位置作为本次任务的可交付结果;如果证据不足,需要同时标出缺口和下一步确认方式。
Sorftime 返回的 Item / Product / 搜索字段作为本次任务的可交付结果;如果证据不足,需要同时标出缺口和下一步确认方式。
订单利润、库存等内部数据只在可查时输出作为本次任务的可交付结果;如果证据不足,需要同时标出缺口和下一步确认方式。
5

进阶链路:进入知识库和待办

进阶链路里,活动前检查会沉淀成 Walmart 的固定验收表;后续相似活动可以让 Agent 定时提醒还缺哪些确认项,避免只靠人工记忆推进。

知识沉淀

稳定事实、流程规则、术语口径、可复用经验,先作为候选给负责人审核;确认后再进入对应知识库或经验库。

角色待办

如果输出里出现明确负责人、时间、下一步动作,可以整理成角色待办候选,后续由对应 Agent 提醒和跟进。

普通业务知识也不是自动入库。先产出候选,负责人确认后再沉淀,避免把一次性判断写成公司事实。
6

和普通 AI 对话的区别

普通对话THX Skill 工作流
用户问什么就答什么,答案容易散在聊天里。先识别任务类型,再按固定字段、规则和边界输出。
容易把猜测写得像事实。事实、推断、缺口和待确认项分开。
用完即走,很难复用。可复用反馈会进入 Skill 规则、Experience Base 或 GBrain 候选。
不清楚结果给谁看。输出默认面向具体角色:运营、负责人、知识库维护者或管理层。
7

边界和适用范围

  • 这个案例说明业务链路,不等于所有场景都会自动完成。
  • 素材不足、服务不可用或权限不足时,Skill 应明确说明缺口。
  • 涉及敏感内容时,先按 Restricted 边界处理,不写入普通页面和普通知识库。
  • 如果页面内容与实际使用不一致,以负责人确认后的 Skill 规则和运行逻辑页为准。
8

反馈如何进入下一轮

试用时如果发现输出不符合业务习惯,直接按下面格式反馈,方便维护者判断是改内容、改规则,还是补知识库。

本次任务: 当前输出哪里不对: 正确业务口径: 以后希望固定怎么处理: 是否适合沉淀为知识库 / 经验库 / Skill 规则候选: