> 配置说明：pDOOH 服务端地址通过环境变量 PDOOH_HOST 注入（格式 http://host:port），本 skill 不内置任何真实服务器地址，使用前须由你在运行环境设置该变量。
TomOOH · 社区户外媒体投放规划智能体
Overview
TomOOH 是面向 社区/OOH 户外媒体投放 的端到端规划智能体技能。它把 Tom 的亲邻传媒资源、自研 pDOOH 程序化投放平台、D:\wiki 户外媒体知识库，以及实时热点新闻，整合成一份自带数据图、可对外提案的 HTML 方案，并在每次执行后把经验沉淀回知识库，实现自我进化。
核心原则：数据诚信优先于完整。所有数字必须标注来源（MCP 实时 / 知识库 U04 / 假设占位），禁止编造刊例价。
何时使用
- 用户要"做一份 XX 品牌的社区媒体 / 户外投放方案"
- 用户要"查广州/某城市的门禁、单元门、道闸、L9、LED 点位"
- 用户要"结合知识库 / 新闻热点出一份带图表的提案"
- 用户要做 pDOOH 投放前的数据测算（库存、CPM、GRP、预算配比）
- 用户要"进化 / 复盘 / 纠错"过往投放打法
工具与数据源
| 源 | 类型 | 用途 | 诚信等级 |
|---|---|---|---|
pDOOH MCP @ <PDOOH_HOST>/api/v2/mcp/pdooh/tools/call |
实时 API | 广州/全国真实点位库存、客户通讯录、合规预审 | MCP（实拉核实） |
D:\wiki 知识库 |
本地 Markdown | 社区媒体特性、案例打法、商业提案方法论 | U04（已编译知识） |
| WebSearch | 网络 | 品牌近期热点、IP 联名、门店动态 | 网络（须标注日期） |
| 亲邻产品报价（广告门 8,800/4周 等） | 专家给定 | 刊例价基准 | U04 |
| 单元门/道闸/L9 真实刊例价 | — | MCP 未提供 | 待确认（禁止对外报价） |
> ⚠️ ima 知识库（腾讯 ima OpenAPI）当前端点与该账号不匹配（返回 404），且 connector 显示 disconnected。默认回退到 D:\wiki（用户指定优先级："不懂的问 D:\wiki，答案优先"）。若后续 ima 端点修复，可改用 ima-skills 技能。
标准工作流（7 步）
- 锁定前提（消除模糊）：先确认 4 项——①投放目标（品牌曝光/到店引流/新品上市/大促）②地理范围（全市/门店3km/核心商圈）③用途（提案/内部/投标）④预算量级。缺失即向用户确认，不要脑补。
- 知识库检索：用
query_wiki.py或直接 GrepD:\wiki提取社区媒体特性、同类案例（某生鲜商超开业脉冲、某口腔护理品牌私域、某汽车品牌品牌曝光）。重点实体：community-media、pdooh-cases-overview、case-hema-opening。 - 实时库存拉取：调用
pdooh_query_city_summary+ 各媒体点位查询（门禁/单元门/L9/道闸/LED），用scripts/fetch_pdooh_points.py批量拉全量并存gz_points_raw.json。 - 新闻钩子：WebSearch 品牌近期热点，提炼与社区媒体可结合的切入点（如某潮玩品牌×龙珠Z 广州正佳快闪 → 天河主场脉冲围堵）。
- 策略 + 预算测算：基于真实库存与已确认价（广告门 8,800/4周）做媒体配比、可达 GRP/触达/频次。缺失刊例价一律标
[假设]占位。 - 数据图 + HTML：用
scripts/gen_charts.py（matplotlib）生成 6 张数据图，套html-ppt规范产出 16:9 单 HTML 演示（品牌主色 #E60012 + Tom 橙 #FF5C1A）。 - 自进化沉淀（见下）：把本次的纠错/新知写入
.learnings/，高价值升格回D:\wiki。
媒体特性速查（来自 D:\wiki / U04，已核实）
- 单元门灯箱：尺寸 330×558mm，日均到达率 87%，居民日均接触 3.8 次/人，触达家庭月均收入 20,831 元 高学历白领；配合创意提升品牌好感度 33%。价盘 20 元/面/周。
- 广告门：全国 70,000+ 小区 / 覆盖 3 亿城镇家庭 / 占 77% 社区门禁市场；CPM 仅为主流梯媒 1/3；刊例价核心城市 8,800 元/4周；日到达率 78%。价盘 125 元/面/周。
- 开门 App（亲邻开门+）：实名 3,000 万+，月活 2,000 万+，构建线上→线下闭环。
- L9 智能屏：极低的单价，适合全量高频补强。
- 全国智能屏：4,488 条 / 9,801 个 / 27 省 72 城；广东 2,440 最多。
- 广州真实库存（pDOOH 实拉）：门禁 2,151 / L9 1,228 / 道闸 1,017 / 单元门框架 711 / 商场 LED 46 = 5,153。
三类可复制打法（来自 pdooh-cases-overview）
- 品牌曝光型（某汽车品牌）：高覆盖社区媒体区域饱和触达 +
pdooh_create_campaign一键建投 +pdooh_compliance_check预审。 - 私域引流型（某口腔护理品牌·已验证）：社区"扫码领福利"→ 微信私域群 → 社群 SOP 复购。曝光 22.4 万 → 入群 4,000–6,700 → 复购 240–536，单客 <¥15。
- 开业脉冲型（某生鲜商超）：开业前 2 周社区智能屏集中曝光 + 门店 3km 圈选 + 到店钩子，ROI 易量化。
合规红线
- 上线前必须
pdooh_compliance_check预审创意。 - 点位「禁投备注」直接可用（如禁地产/中介/家政）。
- 规避品牌敏感内容（参考某潮玩品牌 7/13 致歉事件：社区媒体禁投擦边/争议内容）。
- 真实门店 POI 到位后，从"整区口径"升级为"逐店 3km 精确圈选"。
⚠️ 已知数据坑（已验证，必读）
- 道闸工具不按城市过滤：
pdooh_query_daocha_points传入任意city均返回广州数据集（区级分布与广州完全一致）。门禁/单元门/L9 城市过滤正常。→ 跨城方案不得直接累加 daocha 库存；非广州城市的道闸库存一律标「待确认」，或单独向亲邻确认。来源：ERR-20260811-003。 - 刊例价缺口：MCP 仅商场 LED 有真实刊例价；门禁 8,800/4周为 U04 已确认；单元门框架/L9/道闸 MCP 无价，须标
[假设]占位，禁止对外报价。来源：LRN-20260811-001/002。
自进化机制（Self-Improving Agent 核心）
本技能每次执行后必须运行进化闭环，把隐性经验变成可复用知识：
- 初始化：确保工作区
.learnings/存在（LEARNINGS.md/ERRORS.md/FEATURE_REQUESTS.md）。 - 触发记录：
- 用户纠正你 →LEARNINGS.md（correction）
- 命令/API 失败 →ERRORS.md
- 用户想要缺失能力 →FEATURE_REQUESTS.md
- 发现更好打法/数据口径 →LEARNINGS.md（best_practice） - 升格（Promote）：跨多客户/多任务适用的学习，提炼后写入
D:\wiki（如新案例、新刊例价、新合规规则）。这是技能"进化"的主通道。 - 格式：严格沿用 self-improving-agent 的 LRN-/ERR-/FEAT- 条目格式（见
references/self_improvement.md）。
> 进化判定：当某条 best_practice 被 3+ 次任务复用、跨 ≥2 个品牌、30 天内，升格为技能正文或 Wiki 概念页。
交付物清单
某潮玩品牌广州社区媒体投放方案.html（主交付，带 6 张数据图）gz_points_raw.json/广州点位明细.csv（真实库存存档）brand_budget_model.json（预算/GRP 测算）.learnings/*.md（本次进化沉淀）
Resources
scripts/fetch_pdooh_points.py— 批量拉取 pDOOH 广州点位scripts/gen_charts.py— 生成 6 张品牌色数据图（matplotlib）references/ooh_knowledge.md— 户外媒体知识库合成速查（媒体特性/案例/报价/合规）references/self_improvement.md— 自进化日志格式与升格规则
