通信工程监理商机获取

为监理企业开拓业务市场，自动从公开渠道发现潜在监理业务与关联土地信息，汇总为日报/周报，并对高价值线索发邮件预警。技能包内置两项"开箱必填"基本要素——公司基础信息（company_profile）+ 预警接收邮箱（target_email），均以占位形式随包提供、由最终用户自行填写；包内不预置任何特定公司信息。

〇、运行模式判定（自动 / 手动）

本技能有两种触发方式，行为不同：

> - 哨兵标记由"三、周期性调度"创建的自动化提示词写入；手动运行不会带该标记，自动回落到手动模式。
> - 自动模式的执行位置取决于自动化创建方式：桌面端自动化在本地执行（需电脑开机且 WorkBuddy 运行中）；微信小程序「云端工作」模式下的自动化在腾讯云沙箱执行（不依赖电脑开机，但无法访问本地文件）。详见"三、周期性调度"的云端迁移说明。
> - 新线索即时预警的发信方式与自动化模式一致（桌面端 / 云端）。
> - 用户想看界面结果时，在对话直接输入"跑一下今天的监理商机日报"即可（手动模式）。

一、触发与配置

触发词示例：监理商机 / 监理招标 / 商机日报 / 商机周报 / 数据中心 用地 / 监控监理机会 / 帮我找监理项目 / 设置公司档案 / 光伏 监理 招标 / 电力 监理 招标 / 资质覆盖与外延机会分析。

运行前读取配置 references/config.json：
- company_profile：公司档案（company_name / business_types / qualifications / business_scope / target_regions / marketing_materials）。若 company_name 仍为"待设置"，必须先执行"步骤 0"再检索。
- target_email：预警邮件目标邮箱。若该值仍为 your-email@example.com 或为空，必须先向用户确认目标邮箱再发送，禁止发到占位符。
- email_mode：alerts_only（仅高价值发邮件，默认）/ digest（每次也把日报邮件发送）。
- high_value_threshold：高价值阈值，默认 70。
- qualification_scope_map：业务域 ⇄ 资质覆盖词的映射，决定"资质内/资质外"判定（见步骤 3）。
- default_geo_priority / default_domain_weights / stage_weights：评分默认权重；配置公司档案后，业务类型与重点区域会动态覆盖其中部分权重（详见 references/scoring.md）。

二、工作流（六步）

建档案 → 检索 → 抽取结构化 → 评分分级 → 生成报告 → 邮件预警

步骤 0　开箱配置（首次运行前必填：公司档案 + 预警邮箱）

> 这两项（邮箱、公司基础信息）是技能包的"基本要素"，结构随包就位、默认占位，由最终用户自行填写。不填也能跑（用通用权重），但预警邮件在 target_email 仍是占位符前不会发出。字段说明与配置模板见 references/setup.md。

必填项 1 · 公司基础信息 company_profile（名称 / 业务类型 / 重点区域 / 宣传资料）：
1. 检查 company_profile.company_name 是否为"待设置"或空。若是，向用户采集：
- 公司名称（如"XX建设咨询有限公司"）。
- 业务类型：贵司实际承接的监理专业，如 通信工程监理、数据中心监理、传输/管线监理、无线/5G监理、机房配套监理、土建/房建监理、新能源/光伏监理、电力/输变电监理、风电与储能监理、智能化/弱电监理、市政与机电安装监理。可多选。
- 资质清单 qualifications（v1.4 关键）：贵司持有的监理资质全称（如 通信工程监理甲级、电力工程监理乙级、房屋建筑工程监理甲级）。这是判定"资质内 / 资质外"的唯一依据，直接决定线索进主表还是进「资质外机会」。填得越准，报告越有用。
- 业务范围 business_scope（v1.4 新增）：一段自由文本（如"通信工程、数据中心、机房配套、分布式光伏与配电工程监理"），可与资质互为补充；资质证书里写不全的口子可以补在这里。
- 重点拓展区域：按三层次模型填写，可跨层多选——南京（本地）、江苏/苏州/无锡…（省内）、以及省外省份或 全国（表示全国范围布局）。若填 全国，评分不压低任何地域，全国线索保留其三层次权重参与排序。
- 宣传资料（可选但强烈建议）：资质证书、业绩清单、公司简介等文件（PDF/Word/图片）。若提供，用 Read 解析，抽取资质等级、专业范围、典型业绩、优势区域，据此预填 business_types、qualifications、business_scope 与 target_regions，再与用户确认。
2. 将确认后的档案写回 config.json 的 company_profile（或直接用 Edit 修改文件）。
3. 核对收录域 ⊋ 资质域：技能包收录 11 个域，通常多于用户资质。若用户资质只覆盖少数域，属预期状态——报告会自动列出未覆盖域作为外延/联合投标方向，无需向用户提示"漏配"。反过来，若某域用户实际能接却被判"资质外"，把该域词补进 qualifications 即可（覆盖词表见 config.json 的 qualification_scope_map）。

必填项 2 · 预警接收邮箱 target_email：
1. 检查是否为占位符 your-email@example.com 或空。若是，向用户确认目标邮箱并写入。
2. 占位符/空值禁止发信（避免误发到示例地址）；填入真实邮箱后方可发预警。

填好后：评分会提升匹配业务域与重点区域的权重，报告按贵司实际可承接范围给出跟进建议；更换公司时只需改此档案。

步骤 1　多渠道检索

读取 references/sources.md，按"业务域 × 地域 × 阶段"组合执行 ≥12 次 WebSearch（日报 freshness=m1，周报 freshness=m1，土地可 m3）。
- 覆盖：招投标公共服务平台、全国公共资源、政府采购网、三大运营商采购网、铁塔、各地交易中心、土地市场网(landchina.com)、自然资源规划局，以及 v1.4 新增的电网与发电集团官方招标平台——国家电网（电子商务平台 ecp.sgcc.com.cn ＋ 国网招投标网 newbidding.sgcc.com.cn，后者管设计/施工/监理标）、南方电网（供应链统一服务平台 bidding.csg.cn）、五大发电集团（国家能源国能e招 chnenergybidding.com.cn、国家电投 espic.com.cn、中广核 ecp.cgnpc.com.cn、三峡 eps.ctg.com.cn、华能 ec.chng.com.cn ／华电 chdtp.com ／大唐 cdt-ec.com）。这些平台是光伏/电力/储能监理线索的官方一手来源，命中后必须 WebFetch 回官方源核实关键字段。
- 地域三层次覆盖（v1.3）：检索须同时覆盖 ①南京（本地）②省内（江苏）③全国（江苏以外） 三个层次，避免只盯江苏漏掉省外大单；重点省级行政区（广东/北京/上海/浙江/四川/湖北等）作为全国层高频词。运营商总部采购网（移动/联通/电信/铁塔）天然全国，必查。
- 结合公司档案定制查询：在通用模板基础上，叠加贵司 business_types / qualifications 的专业词（如"电力监理""光伏监理"）与 target_regions 的地名，提升命中相关度。
- 跨行业广度 > 资质（v1.4 核心）：一轮检索须覆盖技能包全部 11 个业务域（见 references/sources.md 的 A/B/C/D 组模板），不能只查自己有的资质。D 组（光伏 / 电力输变电 / 储能风电 / 智能化弱电 / 市政机电）即便用户暂无资质也必须查——收录它们的意义是暴露赛道与资质缺口，以及找联合体承接。判定"资质内/资质外"由脚本依 qualification_scope_map 自动完成，检索侧不区分。
- 对每条命中用 WebFetch 打开官方源补全：预算/投资、投标截止日、采购人、代理与电话、是否在招标期。
- 仅用公开信息，检索词不含任何工程敏感信息（项目名/地址/人名）。

订阅层（官方源直连，提升时效与覆盖·v1.2 新增）：在 WebSearch 之前先运行 scripts/fetch_feeds.py，按 references/sources_feed.json 直连官方 RSS/列表页抓取，与 WebSearch 结果合并，减少搜索召回盲区与天级延迟：

python <skill>/scripts/fetch_feeds.py --feeds <skill>/references/sources_feed.json \
  --out leads_raw.json --merge leads_search.json --status leads_feeds.status.json --limit 30

• leads_search.json 为 WebSearch 归一化结果；--merge 将其并入同一输出。
• --status 输出各源抓取状态，failed 源即「覆盖缺口」，须在下轮补充或改走 WebSearch 兜底（详见步骤 6 覆盖缺口分析）。
• 该脚本纯标准库、零第三方依赖，任一源失败只记缺口不阻断。

步骤 2　抽取结构化线索

把结果整理为 JSON 数组，字段见 references/sources.md 的"线索字段抽取规范"。土地类置 is_land:true，非监理的通信/数据中心施工设计标标记 derivative。写入临时文件 leads_raw.json。

步骤 3　评分与分级

运行脚本（确定性去重+评分+分级+分类+行动清单+增量库+即时预警）：

python <skill>/scripts/score_leads.py leads_raw.json \
  --config <skill>/references/config.json \
  --mode daily --out report_daily.md --store leads_store.json \
  --alert-md report_daily.alert.md --new-alert-md report_daily.new.md

• 去重：按"标题+来源URL"合并多平台转载，仅留官方源。
• 评分：score=100×(0.45×业务域+0.25×地域+0.20×阶段+0.10×信息完整度)（详见 references/scoring.md）；业务域与地域权重由公司档案动态调权。地域权重采用三层次模型（南京 1.0 / 省内 0.85 / 全国 0.6 / 海外 0.2，重点省份微加权），由 config.json 的 geo_tiers 定义；每条线索自动打 geo_tier 标签（南京/省内/全国/海外）。
• 资质覆盖判定（v1.4 核心）：按 qualification_scope_map 给每条线索打 coverage = 资质内 / 资质外 / 未判定。资质外域照常收录、照常打分，但不进"建议立即跟进"主表，改列「三、资质外机会」，跟进类改写为「资质外·外延/联合投标」并给三条出路（组联合体 / 资质扩张依据 / 先建联摸门槛）。资质内域的权重被抬到 ≥0.9。
• 分级：高价值（≥阈值 且 核心监理域 且 招标中/报名临近/土地挂牌 且 非资质外）、中价值、低价值；资质外线索记为「中价值（资质外·仅参考）」。全国层线索凭高业务域+高阶段同样可达高价值（如"全国 通信工程监理 招标中"≈80 分）。
• 可跟进性分类（A–E 类）：A 公开招标可立即行动 / B 有联系方式可主动对接 / C 潜在关联机会需分析/战略储备 / D 早期信号提前布局 / E 已错过仅记录（详见 references/scoring.md）。
• 自动抽取 summary/title 中的真实投标/报名截止日写入 deadline 字段，供报告与预警展示。
• 增量库（store·v1.2 升级）：--store leads_store.json 使线索库跨轮次持久；自动去重（标题+来源），新线索入库并打 ingest_date，重复出现更新 last_seen；当某线索阶段由"招标中"变为"已中标/公示"时自动标记 status_changed 并告警（跟进落单/已错过），永不丢失历史。本轮新增与状态变更同时写入 <out>.delta.json，报告"七、状态生命周期与累计追踪"展示库规模与变更明细。
• 即时预警（new-alert·v1.2 新增）：--new-alert-md 生成「即时增量预警」，仅含本轮新增的 A/B 类高价值线索与状态变更，供事件驱动即时发信（新线索一出现即提醒，不等次日 08:30 批次）。
• 输出：report_daily.md 日报、report_daily.md.scored.json 全量、report_daily.md.high.json 高价值线索、report_daily.alert.md「行动清单」预警正文（供步骤 5 发批次邮件）、report_daily.new.md「即时增量预警」正文（供即时发信）、<store>.delta.json 增量明细。

步骤 4　生成日报 / 周报

• 日报 mode daily；周报 mode weekly（传入本周累计线索或复用 leads_store.json）。
• 报告模板见 references/templates.md，含：顶部地域分层速览（南京/省内/全国条数）、高价值线索表（带"层级"+"覆盖"列，按 南京→省内→全国 排序）、其他监理线索（按 11 个业务域分组）、三、资质外机会（收录域 ⊋ 资质域，供联合投标/资质扩张）、土地/用地信息、衍生机会、分类深挖与后续跟进建议（按 A–E 类逐条给建议）、七、资质与业务范围覆盖分析（11 个收录域 × 资质覆盖 × 本轮命中 × 承接路径建议，并给出"收录 N / 覆盖 M / 未覆盖 K"与未覆盖域清单）、统计（含按地域分层与资质覆盖分布）与行动建议。
• 呈现（按模式）：手动模式 → 调用 present_files 在智能体界面呈现报告，并简要口述 Top3 跟进建议；自动模式 → 跳过 present_files（无人值守，界面呈现无意义），直接进入步骤 5 发邮件。

步骤 5　邮件预警（agentmail）

> 先判定运行模式（见"〇、运行模式判定"）：
> - 自动模式（提示词含 【定时自动任务】）：直接发信并设 skip_confirmation:true，不在界面呈现。
> - 手动模式：先展示发送摘要并等待用户确认；仅当 config.run.manual_auto_email=true（用户已授权免确认）才设 skip_confirmation:true。

• 预警正文必须使用步骤 3 生成的「行动清单」文件（--alert-md 产物，如 report_daily.alert.md）作为邮件 body。严禁只发"标题+分值"摘要——用户需要的是可照做的详情（项目名、采购人、预算、截止日、来源链接、入手步骤），不是排行榜。
• 「行动清单」已按 A/B/C 分类，每条线索均含：项目全称、采购人、预算、真实截止日、可点击来源链接，以及对应的「入手步骤」（A 类通用五步 / B 类直接联系 / C 类查地建联）；B 类已突出显示联系方式。
• 读取 report_*.md.high.json 判断是否发信：
• email_mode=alerts_only：仅当存在高价值线索时，将「行动清单」文件全文作为邮件发送。
• email_mode=digest：每次运行都把日报/周报（或行动清单）正文邮件发送。
• 即时发信（事件驱动·v1.2）：若步骤 3 的 --new-alert-md 产出 report_daily.new.md 非空（即本轮有新增 A/B 类高价值或状态变更），应以该文件为 body 立即发信（subject 加「即时」），实现"新线索一出现就提醒"，而非等次日 08:30 批次。批次日报仍按 alert.md 每日/每周发送。即时发信同样遵循本步骤的模式判定（自动模式跳确认、手动模式走确认）。
• 调用工具 mcp__agent-mail__SendMessage：
• to: [{"email": "<config.target_email>", "name": "<company_profile.company_name> 市场跟进"}]
• subject: [监理商机·行动清单] 高价值{H}条 ｜ {YYYY-MM-DD}
• body: 「行动清单」文件全文，body_format: "MARKDOWN"
• 自动模式追加 skip_confirmation: true；手动模式默认不追加（走确认），除非 config.run.manual_auto_email=true。
• 目标邮箱为占位符时禁止发送，先回到步骤 0 配置。

步骤 6　覆盖缺口分析（"不遗漏"保障·v1.2 新增）

为逼近"不漏"，每次运行后须审视覆盖完整性，而非只看命中：
- 订阅源缺口：读 fetch_feeds 的 --status 输出，failed 源即本轮未覆盖的官方渠道，须在下轮补充（换 URL/改 WebSearch 兜底），避免长期盲区。
- 区域×业务域矩阵缺口：按 config.json 的 default_geo_priority × default_domain_weights 列出"省×域"格子，统计本轮命中分布；空白格子提示需针对性补检索（如某省无线监理长期为 0，可能是漏检而非真无）。三层次覆盖核查（v1.3）：分别统计 南京/省内/全国 三层的命中条数，若某一层长期为 0（尤其全国层），说明该层检索不足，须在下轮补全国查询。
- 业务域覆盖核查（v1.4）：报告「七」已输出 11 个收录域的命中分布。若某域（尤其 D 组的新能源/电力域）连续多轮为 0，先怀疑漏检而非真无市场——用 sources.md D 组模板单独补查询；若确为该区域无标，则提示用户该赛道暂不值得投入。
- 资质缺口核查（v1.4）：「七」中的未覆盖域即资质缺口。若某未覆盖域"本轮命中多且连续多周出现"，说明该方向值得①办资质或②找联合体；此结论应在周报的趋势建议里显式点名，而不只是列在表里。
- 状态回溯缺口：增量库 leads_store.json 中 status=active 但 last_seen 距今已超 N 天（如 14 天）的线索，可能已悄然中标/过期却未被本轮抓到，应在日报"七、累计追踪"中提示复核，必要时人工 WebFetch 核状态。
- 上述缺口摘要可附于日报末尾，作为下一轮检索的输入。

三、周期性调度

用户要求"每日/每周自动跑"时，用内置自动化（recurring）建立两条任务。自动化提示词必须写入哨兵标记 【定时自动任务】，技能据此进入"自动模式"——检索评分后直接经 agentmail 发邮件（skip_confirmation:true），不在界面呈现，实现无人值守。

3.1 桌面端自动化（默认）

通过 WorkBuddy 桌面端「自动化」页面创建，在本地执行——需要电脑在调度时间保持开机、联网、WorkBuddy 运行中。若电脑关机或休眠，当次调度跳过且不补发。

• 日报：FREQ=DAILY;BYHOUR=8;BYMINUTE=30
  提示词：执行 通信工程监理商机获取 技能，mode=daily，【定时自动任务】生成日报并经 agentmail 自动发送预警邮件（skip_confirmation），无需在智能体界面呈现报告
• 周报：FREQ=WEEKLY;BYDAY=FR;BYHOUR=17;BYMINUTE=30
  提示词：执行 通信工程监理商机获取 技能，mode=weekly，【定时自动任务】生成周报并经 agentmail 自动发送预警邮件（skip_confirmation），无需在智能体界面呈现报告

创建时的注意事项：
- 工作目录（cwds）应指向技能包所在目录（如 ~/.workbuddy/skills/telecom-supervision-leads），不要写死 C:/Users/ 开头的个人路径。
- 脚本调用使用相对路径（python scripts/fetch_feeds.py），不用绝对路径，保证跨机器可移植。
- 提示词中若需引用文件，使用技能包相对路径（如 references/config.json），不要使用本机绝对路径。

3.2 云端自动化（关机也跑）

WorkBuddy 微信小程序支持「云端工作」模式，自动化在腾讯云沙箱中执行，不依赖本地电脑是否开机。迁移步骤：

1. 微信搜索「WorkBuddy」小程序，授权登录
2. 界面上方切换到「云端工作」模式
3. 进入「自动化」页面 → 点「+」添加定时任务
4. 配置频率与时间（同上 RRULE），填写任务提示词
5. 先点「测试运行」验证一次，确认报告与邮件正常产出后再放开

⚠️ 云端执行的限制：
- 云端任务无法访问本地文件（如本机 config.json、本地 reports/ 目录）。技能包需部署到云端工作区，报告与增量库（store.json）也需放在云端可写路径。
- 云端环境需有 Python 与技能包依赖（当前脚本为纯标准库，无第三方依赖，满足条件）。
- 检索层（WebSearch）与发信层（agentmail）在云端同样可用，不受影响。
- 混合任务陷阱：若任务最终需要写入本地目录（如桌面端 reports/），它仍然是本地任务——云端执行会失败或静默丢弃输出。确保所有输入/输出路径都在云端工作区内。

3.3 两条路径对比

> 若用户希望手动模式（对话主动发起）也自动发邮件免确认，在步骤 0 配置后于 config.json 设 run.manual_auto_email:true；默认手动模式仍先展示摘要并等待确认。

四、数据安全与合规

• 仅检索公开招投标/土地出让信息，不处理在施项目资料、不对外传工程敏感数据。
• 检索词脱敏（不含项目名/地址/人名/造价）。
• 公司档案（含宣传资料）仅在本地用于定制检索与评分，不上传外部。
• 邮件仅发往用户确认的目标邮箱，内容不含任何在施项目敏感信息。

五、资源索引

• references/config.json — 配置（公司档案、目标邮箱、权重、阈值、渠道）
• references/sources.md — 检索渠道、查询模板、字段规范
• references/sources_feed.json — 官方订阅源清单（RSS/列表页，订阅层）
• references/scoring.md — 评分分级 + 11 个业务域 + 资质覆盖判定（收录域 ⊋ 资质域） + 公司档案调权 + A–E 跟进分类模型
• references/templates.md — 日报/周报/邮件模板
• scripts/fetch_feeds.py — 订阅层：官方源 RSS/列表页直连抓取（纯标准库，零依赖）
• scripts/score_leads.py — 去重/评分/分类/报告生成 + 增量库(store) + 即时预警(new-alert)（确定性）