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 安装流程
- 下载通用 Skill 包
THX-amazon-assistant.zip,不要解压 zip。 - 同时准备管理员私下发放的私密 MCP 包;Amazon / Walmart 等角色包必须和当前 Skill 匹配。
- 把 Skill zip、私密 MCP zip 和本页“发给 Agent 的安装指令”一起发给 Agent。
- 让 Agent 解压私密包,选择当前客户端的配置文件,原样导入并确认 MCP 服务处于启用状态。
- 新建对话,选择
THX-amazon-assistant。 - 发送开工检查或第一句真实任务:
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 安装流程
- 使用管理员发放的 Skill zip。
- 解压后确认根目录是
THX-amazon-assistant,里面能看到SKILL.md。 - 把整个目录放入 Codex 可读取的 Skills 目录,或让管理员确认
~/.codex/skills已有正确软链接。 - 刷新 Codex 会话。
- 发送真实需求验证:
AMZ开工检查
Codex 安装和 MCP 检查由管理员或 Codex 自己完成,不让 CEO 或普通同事手动拼 Codex MCP 配置。
6
安装后怎么验证
| 检查项 | 通过标准 |
|---|---|
| zip | 下载 HTTP 200,解压后根目录正确,能看到 SKILL.md。 |
| 入口 | WorkBuddy 或 Codex 能识别当前 Skill,不误触发其他 Skill。 |
| MCP | Agent 已导入私密 MCP 包,开工检查通过;失败时先区分是私密包未导入、服务未启用、权限不足,还是用户资料缺失。 |
| 真实任务 | 第一句真实任务能得到符合本 Skill 输出对象的结果。 |
7
反馈方式
反馈时不要只说“不对”。请直接说明哪里不对、希望以后固定怎么处理,负责人才能判断是否要改 Skill 或沉淀为公司规则。
哪里不对:
希望以后固定怎么处理:
本次输入材料:
本次输出里可复用的地方:
是否需要给负责人审核:
