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

路由

搜索流程

1. 判断搜索复杂度：

- 单一事实、单一对象、单一时间范围：改写成 1 个清楚查询词。 - 多维研究、采购判断、竞品比较、价格/渠道/口碑/风险同时出现：先拆成最多 4 个子查询。

1. 子查询必须写清用途、时间范围和来源要求。不要把多维问题压成一个泛查询。
2. 逐个执行查询：

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

1. 基于结果输出：

- 搜索问题。 - 如果拆成多个子查询，列出子查询和各自用途。 - 关键发现。 - 来源列表。 - 仍需人工核验的点。 - 下一步建议。

复杂搜索拆分示例：

缺少 API Key 时

只说：

这台电脑还没有完整配置搜索技能。
请把缺失的 Perplexity API Key 和 / 或 Tavily API Key 发给我。我会只保存到这台电脑的本机配置文件，不写入 GitHub 仓库。

不要要求用户把 key 写进项目文件。

不适合使用本 Skill

• 要登录小红书、抖音、微信、飞书后台取数。
• 要读取本机私密文件。
• 要爬取受平台限制或需要登录的内容。
• 要绕过付费墙、验证码、权限或平台风控。

这类任务回到 TGW 的 /TGW-workcheck 做人机分工。