THX Skill DocsSkill 使用说明
目录

Install

THX Amazon 助手 安装步骤

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

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

当前 Skill 支持哪些入口

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

发给 Agent 的安装指令

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

打开纯文本安装指令

请帮我安装并检查 THX Amazon 助手。 我会上传一个 zip 安装包:THX-amazon-assistant.zip。 请你做这些事: 1. 读取 zip 里的 SKILL.md,确认 Skill id 是 THX-amazon-assistant。 2. 按当前运行环境安装或启用这个 Skill;不要解压后只读单个文件。 3. 这个 Skill 需要 thx-amazon 角色 MCP;请同时读取管理员私下发放的 THX-MCP-amazon-ops-2026-06-23.private.zip,原样导入对应当前客户端的配置。开工前必须确认 tools/list 里有 role_mcp_health、8 个 amazon_* 只读运营 wrapper、Sorftime Amazon 只读工具,以及 lingxing_read_full、sorftime_read_full、backend_read_full 三类 full-read 工具,并确认没有 boss_*、raw 底层工具或写操作工具。月度复盘 wrapper 必须包含 amazon_monthly_parent_asin_profit、amazon_monthly_ads_campaigns、amazon_monthly_ads_portfolios;结果要先输出数据源、时间范围、筛选条件、返回行数、关键字段、cache.status 和 data_freshness,再做结论。开工检查必须包含 wrapper smoke + full-read capability;真实经营明细只在业务任务需要时读取。 4. 如果我同时提供了私密 MCP 包,请先解压私密包,按当前运行环境选择 workbuddy / codex / claude-code 配置文件,原样导入,不要编辑配置字段。 5. 安装完成后,用下面这句做 smoke test: AMZ开工检查 6. 如果失败,请按“Skill 未识别 / MCP 不可用 / 权限不足 / 用户素材缺失 / 输出规则不对”分类反馈,不要只说不能用。
3

MCP / 开工自检指令

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

打开纯文本自检指令

请检查 THX Amazon 助手的 MCP / 云端数据服务状态。 1. 确认 Skill 是否已识别:THX-amazon-assistant。 2. 检查 thx-amazon 角色 MCP 是否可用;如果未预置,请提示需要管理员私下发放 THX-MCP-amazon-ops-2026-06-23.private.zip。 3. tools/list 应包含 role_mcp_health、8 个 amazon_* 只读运营 wrapper,以及 Sorftime Amazon 只读 wrapper;必须包含 amazon_sku_health、amazon_ad_anomaly、amazon_listing_competitor_signal、amazon_refund_return_anomaly、amazon_keyword_opportunity、amazon_monthly_parent_asin_profit、amazon_monthly_ads_campaigns、amazon_monthly_ads_portfolios、sorftime_amazon_capabilities、sorftime_amazon_product_detail、sorftime_amazon_keyword_search_results、lingxing_full_read_capabilities、lingxing_read_full、sorftime_full_read_capabilities、sorftime_read_full、backend_full_read_capabilities、backend_read_full。 4. tools/list 不应包含 boss_*、CEO 经营聚合、raw lx_get_*、raw SP-API、raw Ads、raw Sorftime,或 update_ / send_ / delete_ / move_ / save_ 等写操作工具。 5. 调用 role_mcp_health,只输出服务状态摘要,不输出任何内部凭据。 6. 先调用 role_mcp_health;再任选一个 amazon_* 稳定运营 wrapper 做 dry_run=true,只确认标准结构是否包含结论、证据来源、data_gaps、下一步运营动作建议、需要人工确认项;不要拉取或粘贴真实经营明细。 7. 如果要做月度复盘,先说明三张表的数据源、时间范围、筛选条件、返回行数、关键字段、cache.status 和 data_freshness;历史月份默认复用缓存/快照,需要重拉才使用 refresh_cache=true。 8. 调用 lingxing_full_read_capabilities、sorftime_full_read_capabilities、backend_full_read_capabilities,确认当前 role 有完整只读入口;必要时只用低敏公开参数做一个 read_full 真实只读调用,不输出 token、Authorization 或大段原始明细。 9. Sorftime direct 工具可作为外部数据源检查;如需测试,给 direct 工具预留更长等待时间,失败时标记为外部数据源 / 传输偶发,不要要求重装 MCP。 10. 如果失败,请区分:THX role 凭据未配置、私密包未导入、底层服务不可用、权限不足、full-read 缺失、网络/transport 问题、用户没有提供 SKU / ASIN / 关键词。 11. 不输出真实内部凭据,也不要要求我在聊天里粘贴内部凭据。
Codex / WorkBuddy / Claude Code 的具体 MCP 配置由私密包提供。员工不复制配置正文;Agent 负责按当前客户端导入并检查,只输出 MCP 名称、role/scope 和可用工具。
4

WorkBuddy 安装流程

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

Codex 安装流程

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

安装后怎么验证

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

反馈方式

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

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