用途是构建和维护一个可评分的总可寻址市场（TAM）：用 Apollo Company Search 发现目标公司，将其 upsert 到 Supabase，计算 ICP 匹配分（0-100）并分配层级（1/2/3），再通过 Apollo People Search（免费）为 Tier 1-2 公司自动建立人物观察名单。提供三种模式：build 首次构建、refresh 更新现有 TAM（重新评分、检测层级变化、弃用过期公司）、status 只读报告当前状态。
使用前需在 .env 中配置 APOLLO_API_KEY、SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY，Supabase 表结构见 tools/supabase/schema.sql，该技能写入 companies 和 people 表。每个客户/细分创建一个 JSON 配置，包含 company_filters、scoring（五维权重与层级阈值）、watchlist、mode、max_pages 等，存放到 skills/capabilities/tam-builder/configs/{client-name}.json。
数据库写入策略：未经用户明确批准不得写入 Supabase。必须先运行 --preview 查看总量与成本，再运行 --sample（配合 --test 限 1 页）在内存中评分预览、不写库，向用户展示层级分布与样例公司并确认后，才可执行实际写入。首次运行绝不能使用 --yes，该标志仅用于已预先批准的自动/定时刷新。
常用命令：采样预览 python3 skills/capabilities/tam-builder/scripts/tam_builder.py --config ... --mode build --sample --test；构建（用户批准后）加 --mode build；刷新用 --mode refresh；状态报告用 --mode status。其他标志：--dry-run、--preview、--skip-watchlist。模式上限：Test 1 页/100 公司，Standard 50 页/5000 公司，Full 200 页/20000 公司。
ICP 评分为纯函数、无 API 调用，按员工数、行业、融资阶段、地域、关键词五个维度加权。阈值 >=75 为 Tier 1，>=50 为 Tier 2，否则 Tier 3（可配置）。refresh 模式有弃用规则：连续两次未被搜索返回则标记 deprecated，员工数降为 0 立即弃用，tam_status 为 converted 的公司豁免。限制：依赖 Apollo 与 Supabase；写入需人工批准；首次运行禁用 --yes。