THX Skill DocsSkill 使用说明
目录

Install

THX Walmart 助手 安装步骤

这页只讲当前 Skill 怎么安装、需要什么服务、第一次怎么验证。不跳回总览,不混入其他 Skill。

THX Skill使用说明运行逻辑
需要 MCP 的 Skill 必须同时提供私密 MCP 包;页面只给发给 Agent 的安装 / 自检指令,不展示配置正文。
1

当前 Skill 支持哪些入口

入口当前口径
WorkBuddy支持。按本页上传 Skill zip;需要 MCP 的 Skill 同时把私密 MCP zip 交给 Agent 导入和检查。
Codex支持管理员安装、排障和真实任务验证。Codex 自己检查本机 Skill 目录和 MCP,不把配置责任转给同事。
Claude Code / OpenClaw可作为后续入口,正式开放前需要单独确认安装目录、MCP 权限和验证口径。
2

发给 Agent 的安装指令

把下面整段连同 zip 一起发给对方 Agent。这样同事不需要在聊天里反复转述安装步骤。

打开纯文本安装指令

请帮我安装并检查 THX Walmart 助手。 我会上传一个 zip 安装包:THX-walmart-assistant.zip。 请你做这些事: 1. 读取 zip 里的 SKILL.md,确认 Skill id 是 THX-walmart-assistant。 2. 按当前运行环境安装或启用这个 Skill;不要解压后只读单个文件。 3. 这个 Skill 需要 thx-walmart 角色 MCP;请同时读取管理员私下发放的 THX-MCP-walmart-ops-2026-06-23.private.zip,原样导入对应当前客户端的配置。开工前必须确认 tools/list 里有 role_mcp_health、3 个 walmart_* 只读运营 wrapper 和 Sorftime Walmart 只读工具存在,并确认没有 amazon_*、boss_*、raw 底层工具或写操作工具。开工检查只硬测稳定运营 wrapper;Sorftime direct 工具只确认存在,不作为安装成功硬门槛。 4. 如果我同时提供了私密 MCP 包,请先解压私密包,按当前运行环境选择 workbuddy / codex / claude-code 配置文件,原样导入,不要编辑配置字段。 5. 安装完成后,用下面这句做 smoke test: WM开工检查 6. 如果失败,请按“Skill 未识别 / MCP 不可用 / 权限不足 / 用户素材缺失 / 输出规则不对”分类反馈,不要只说不能用。
3

MCP / 开工自检指令

安装后让 Agent 先跑这段自检,再开始真实任务。

打开纯文本自检指令

请检查 THX Walmart 助手的 MCP / 云端数据服务状态。 1. 确认 Skill 是否已识别:THX-walmart-assistant。 2. 检查 thx-walmart 角色 MCP 是否可用;如果未预置,请提示需要管理员私下发放 THX-MCP-walmart-ops-2026-06-23.private.zip。 3. tools/list 必须包含 role_mcp_health、walmart_item_health、walmart_keyword_opportunity、walmart_market_signal、sorftime_walmart_capabilities、sorftime_walmart_product_detail、sorftime_walmart_keyword_search_results。 4. tools/list 不能出现 amazon_*、boss_*、CEO 聚合、raw 底层工具或 update_/send_/delete_/move_/save_ 等写操作。 5. 调用 role_mcp_health,只输出服务状态摘要,不输出任何内部凭据。 6. 依次测试三个稳定运营 wrapper:walmart_item_health、walmart_keyword_opportunity、walmart_market_signal。只输出是否返回标准结构、evidence_sources 是否非空、data_gaps 类型;不要输出真实经营明细。 7. Sorftime direct 工具只确认存在,不作为安装成功硬门槛;如需测试,给 sorftime_walmart_product_detail 和 sorftime_walmart_keyword_search_results 预留更长等待时间,失败时标记为外部数据源 / 传输偶发,不要要求重装 MCP。 8. 如果失败,请区分:THX role 凭据未配置、私密包未导入、服务端凭据缺失或过期、网络/transport 问题、用户没有提供 Item ID / Product ID / 关键词。 9. 不输出真实内部凭据,也不要要求我在聊天里粘贴内部凭据。
Codex / WorkBuddy / Claude Code 的具体 MCP 配置由私密包提供。员工不复制配置正文;Agent 负责按当前客户端导入并检查,只输出 MCP 名称、role/scope 和可用工具。
4

WorkBuddy 安装流程

  1. 下载通用 Skill 包 THX-walmart-assistant.zip,不要解压 zip。
  2. 同时准备管理员私下发放的私密 MCP 包;Amazon / Walmart 等角色包必须和当前 Skill 匹配。
  3. 把 Skill zip、私密 MCP zip 和本页“发给 Agent 的安装指令”一起发给 Agent。
  4. 让 Agent 解压私密包,选择当前客户端的配置文件,原样导入并确认 MCP 服务处于启用状态。
  5. 新建对话,选择 THX-walmart-assistant
  6. 发送开工检查或第一句真实任务:WM开工检查
这个 Skill 使用 thx-walmart 角色 MCP。公司已预置时,同事无需自行配置;如果对方 Agent 没有预置 MCP,管理员一对一发放对应私密 MCP 包。Sorftime 原始 key 只放在 THX 服务端,不进入员工页面。
请把 Skill zip 和管理员私下发放的 THX-MCP-walmart-ops-2026-06-23.private.zip 一起交给你的 Agent。 让 Agent 解压私密 MCP 包,按当前运行环境选择 workbuddy / codex / claude-code 配置文件,原样导入,不要编辑配置字段。 安装后执行本页开工检查;检查结果只输出 MCP 名称、role/scope 和可用工具,不输出任何内部凭据。
5

Codex 安装流程

  1. 下载 Skill zip。
  2. 解压后确认根目录是 THX-walmart-assistant,里面能看到 SKILL.md
  3. 把整个目录放入 Codex 可读取的 Skills 目录,或让管理员确认 ~/.codex/skills 已有正确软链接。
  4. 刷新 Codex 会话。
  5. 发送真实需求验证:WM开工检查
Codex 安装和 MCP 检查由管理员或 Codex 自己完成,不让 CEO 或普通同事手动拼 Codex MCP 配置。
6

安装后怎么验证

检查项通过标准
zip下载 HTTP 200,解压后根目录正确,能看到 SKILL.md
入口WorkBuddy 或 Codex 能识别当前 Skill,不误触发其他 Skill。
MCPAgent 已导入私密 MCP 包,开工检查通过;失败时先区分是私密包未导入、服务未启用、权限不足,还是用户资料缺失。
真实任务第一句真实任务能得到符合本 Skill 输出对象的结果。
7

反馈方式

反馈时不要只说“不对”。请直接说明哪里不对、希望以后固定怎么处理,负责人才能判断是否要改 Skill 或沉淀为公司规则。

哪里不对: 希望以后固定怎么处理: 本次输入材料: 本次输出里可复用的地方: 是否需要给负责人审核: