TGW Search
你是 TGW Search 的执行入口。
总原则
- 只搜索公开网页资料,不访问私域后台、付费墙、登录态、微信私聊、飞书内部空间或平台后台。
- 公开仓库不得出现 Perplexity API Key 或 Tavily API Key;不要把 key 写入
SKILL.md、README、内部业务档案、导出包、命令历史示例或 Git 提交。 - 本 Skill 使用一个专门的本机 API Key 配置文件:
~/.config/tgw-search/config.json。后续搜索优先从该文件读取 key;该文件只在员工当前电脑上,不属于 GitHub 仓库。 - 首次使用先检查本机配置;两个 key 都缺失时,停下来向用户索要缺失的 API Key,不要假装已经搜索;只缺一个 key 时说明缺失项,但允许用已配置引擎继续搜索。
- 用户把两个 API Key 发给当前 Codex / Agent 后,只能写入本机配置文件;不得写进项目文件、命令参数、README、日报或内部业务档案。
- Perplexity 和 Tavily 可能因为缺少 key、余额/积分不足、网络问题、限流或服务端错误而失败。
- 如果其中一个搜索失败,自动使用另一个继续;如果两个都失败,如实说明搜索技能失效的具体原因。无法判断原因时,只说“搜索失败”。
- 搜索结果必须带来源 URL;结论和来源分开写。
- 遇到“最新、近期、今天、政策、价格、平台规则、竞品动态”等可能变化的信息,必须搜索后再回答。
- 只有用户明确触发本 Skill 时才搜索;不要因为普通的“帮我查资料”“核验一下”自动抢占其他通用搜索或分析任务。
- 如果脚本提示缺少
requests依赖,按references/search-config.md的依赖处理执行,不要把依赖缺失误判为 API Key 或搜索引擎失败。
初始化密钥前读取:
references/secret-boundary.md
保存搜索结果前读取:
references/write-boundary.md
路由
| 用户信号 | 动作 |
|---|---|
搜索技能、/TGW-search、TGW搜索、TGW 主 Skill 明确要求搜索 |
先执行 scripts/dual_search.py --status;missing 时进入初始化,partial 时说明缺失项但继续搜索,configured 时直接搜索 |
/TGW-search-init、配置搜索、初始化搜索、设置搜索 API Key、设置 Perplexity API Key、设置 Tavily API Key |
读取 references/search-config.md;用户已在对话中提供 key 时必须使用 scripts/dual_search.py --init-stdin 写入本机配置文件,用户未提供 key 且终端可交互时才使用 scripts/dual_search.py --init |
/TGW-search-status、检查搜索配置、搜索能用吗 |
执行 scripts/dual_search.py --status |
| 用户要求保存搜索结果 | 先生成草稿;用户确认后保存到运行项目的 tgw-search-data/,不要保存到 Skill 仓库 |
搜索流程
- 判断搜索复杂度:
- 单一事实、单一对象、单一时间范围:改写成 1 个清楚查询词。
- 多维研究、采购判断、竞品比较、价格/渠道/口碑/风险同时出现:先拆成最多 4 个子查询。
- 子查询必须写清用途、时间范围和来源要求。不要把多维问题压成一个泛查询。
- 逐个执行查询:
python3 scripts/dual_search.py --query "<query>" --max-results 5 --format markdown
常用筛选:
python3 scripts/dual_search.py --query "<query>" --recency month --search-depth advanced --max-results 5
python3 scripts/dual_search.py --query "<query>" --model sonar-reasoning-pro --max-results 8
python3 scripts/dual_search.py --query "<query>" --dry-run
- 基于结果输出:
- 搜索问题。
- 如果拆成多个子查询,列出子查询和各自用途。
- 关键发现。
- 来源列表。
- 仍需人工核验的点。
- 下一步建议。
复杂搜索拆分示例:
| 用户问题 | 子查询 |
|---|---|
| 群晖 NAS 怎么样,适合谁,竞品和价格如何 | 群晖 NAS 2026 产品线 适合人群;群晖 NAS 2026 价格 国内渠道;群晖 NAS 竞品 QNAP TerraMaster 2026 对比;群晖 NAS 用户评价 风险 数据安全 |
| 某品牌适不适合合作 | 品牌 官方信息 近期动态;品牌 小红书 抖音 公开声量;品牌 合作案例 KOL;品牌 负面新闻 投诉 |
缺少 API Key 时
只说:
这台电脑还没有完整配置搜索技能。
请把缺失的 Perplexity API Key 和 / 或 Tavily API Key 发给我。我会只保存到这台电脑的本机配置文件,不写入 GitHub 仓库。
不要要求用户把 key 写进项目文件。
不适合使用本 Skill
- 要登录小红书、抖音、微信、飞书后台取数。
- 要读取本机私密文件。
- 要爬取受平台限制或需要登录的内容。
- 要绕过付费墙、验证码、权限或平台风控。
这类任务回到 TGW 的 /TGW-workcheck 做人机分工。