腾讯会议甲方沟通跟进

把一次甲方腾讯会议从"会前要求采集"到"交付前审核"的全流程串起来。六个阶段按需触发，状态持久化在 ./meetings/<project-id>/，支持跨天、跨阶段衔接。智能提取/总结/翻译/审核由 agent 本身完成，skill 负责编排工具调用（邮件、企业微信、腾讯云 ASR/翻译/内容安全、python-docx/pptx、icalendar）。

Step 1: 检测运行环境与凭证

执行任何阶段前，按 references/detection.md 第一节执行四类探测（Python 依赖、企业微信、腾讯云、邮件），得到四个状态码，构建能力矩阵。

• 任一缺失 -> 按 references/detection.md 的安装命令与凭证配置引导用户补齐
• 能力矩阵写入 ./meetings/<project-id>/project-state.json 的 capabilities 字段，后续阶段读取，避免重复探测
• 关键：每个阶段都有降级路径，凭证不全不阻塞；按 references/detection.md 的"能力矩阵表"决定每阶段走主路径还是降级

Step 2: 识别当前阶段并加载项目上下文

根据用户请求路由到六个阶段之一：

歧义默认：无法判断时询问用户当前阶段；若已存在项目目录，默认读 project-state.json 的 current_phase 推进到下一阶段。

项目上下文：每个会议/项目用 ./meetings/<project-id>/ 持久化（project-id 由用户指定或从项目名/甲方名 slugify 生成）。目录含 project-state.json（状态机）与各阶段产出文件。首次进入某项目时创建目录并初始化 project-state.json。

全局默认参数表

用户可在请求中用自然语言覆盖以下默认值：

Step 3: 执行目标阶段工作流

路由到对应阶段后，按其 reference 文件执行。每个阶段的输入/产出/工作流/退出条件/降级路径详见对应文件：

• Phase 1 会前需求采集 -> references/phase-1-premeeting.md
  读邮件(IMAP 搜索) + 企微消息(会话存档/回调/手动粘贴三档) -> agent 提取会议日期/沟通内容/参会人员 -> 写 requirements.json + attendees.json

• Phase 2 会议通知发送 -> references/phase-2-notification.md
  腾讯会议入口三路径(API建会/手动会议号/手动链接) -> 生成通知(时间/议题/参会人/腾讯会议入口) -> 预览确认 -> 邮件HTML + 企微文本卡片发送 -> 写 meeting.json + notification.json

• Phase 3 会议实时转录 -> references/phase-3-transcription.md
  前置合规确认（已征得参会人同意）-> 实时模式(RealTimeASR WebSocket，含方言+TMT翻译) 或 事后模式(FlashRecognition) -> 产出标准格式 transcript.txt

• Phase 4 会后纪要生成 -> references/phase-4-minutes.md
  agent 从 transcript 提取议题/讨论要点/决议/待办(责任人+截止日+考核标准) -> 按要求生成 minutes.txt/.docx/.pptx -> 预览确认 -> 邮件+企微发送 -> 沉淀 action-items.json 供 Phase 5

• Phase 5 跟进日历与提醒 -> references/phase-5-followup.md
  从 action-items 提取交付内容/日期/责任人/考核标准 -> 生成 followup.ics(VEVENT+VALARM) -> 发相关人 -> 生成 reminders.json 轮询计划 -> 用户配置定时任务运行 scripts/check_reminders.py

• Phase 6 项目审核 -> references/phase-6-review.md
  三子路由：6a 公告文稿审核(错别字/敏感词/合规/事实核对) | 6b 设计图文/视频/音频审核(腾讯云内容安全IMS/VM/AMS+品牌规格) | 6c 开发代码审核(ruff/bandit/semgrep+agent审查) -> 生成 reviews/<ts>-<type>-review.md + 追加 review-log.md

执行原则：
1. 每阶段开始前读 project-state.json 的 capabilities，按能力矩阵走主路径或降级路径
2. 对外发送动作（Phase 2/4/5）必须先预览确认
3. 涉及录音转录（Phase 3）必须先做合规确认
4. 审核结论（Phase 6）仅作内部参考，提示人工最终确认

Step 4: 阶段间交接与持久化

每阶段完成后：
1. 产出文件写入 ./meetings/<project-id>/ 对应位置
2. 更新 project-state.json：
json { "project_id": "...", "capabilities": {"py_deps": true, "wecom": true, "tencent_cloud": true, "email": true}, "current_phase": "phase-4", "phases": { "phase-1": {"status": "done", "completed_at": "...", "outputs": ["requirements.json","attendees.json"]}, "phase-2": {"status": "done"}, "phase-3": {"status": "done"}, "phase-4": {"status": "in_progress"}, "phase-5": {"status": "pending"}, "phase-6": {"status": "pending"} }, "updated_at": "..." }
3. 提示用户下一阶段入口（如 Phase 4 完成后提示"可进入 Phase 5 排跟进日历，或直接说'排跟进日历'"）

提醒轮询脚本：独立于六阶段。用户配置操作系统定时任务（cron / Task Scheduler）定期运行 scripts/check_reminders.py，脚本扫描所有项目的 reminders.json，对到期项通过邮件/企微提醒责任人，超期项提醒我方负责人（超期通知发送成功才记 escalated_at，只发一次；发送失败自动重试）。程序化接入可加 --json 输出结构化结果（events/errors）；--project <名称> 可只扫指定项目。配置方法见 references/phase-5-followup.md 第 5.5 节。

项目健康看板（v1.6 新增）：用户想总览全部项目状态时，运行 scripts/project_dashboard.py（只读，不发送不回写）：聚合各项目的六阶段进度、逾期/即将到期（7 天内）待办、行动项完成率、审核记录，输出终端看板 / --json / --markdown（可 --output 落盘）。与 check_reminders.py --board 的分工：--board 看提醒轮询进度（fired/remind_at），看板看项目健康度（阶段+逾期+完成率）。

行情异动监控（v1.5.0 新增）：独立于六阶段的辅助工具。用户请求监控 A 股个股/量比/换手率/主力资金时，运行 scripts/market_monitor.py（用法、阈值、降级链、与六阶段联动方式见 references/market-monitor.md）：

• 快速监控：python scripts/market_monitor.py --watch 600000,000001
• 告警落盘：追加 --alerts ./market-monitor/alerts.jsonl（退出码 1 表示触发告警，可供定时任务判定；v1.7 起单只行情失败不再短路告警退出码）
• 大盘蓝筹等低换手标的记得下调冷清线：--thresholds '{"to_cold": 0.3}'
• 报告文本可用 Phase 2/5 的邮件/企微通道下发（发送前仍需预览确认）

AI 纪要洞察引擎（v1.7 新增）：scripts/ai_insight_engine.py 把六阶段中的"智能提取/总结/审核"沉淀为 5 类可复用提示词模板（minutes-extract / action-items / requirements-extract / review-announcement / followup-weekly，--list-templates 查看）。两种模式：默认输出渲染好的 system+user 提示词（当前对话的 agent 直接拿去用）；配 --run 且设置了 DEEPSEEK_API_KEY 时调用 DeepSeek 直出结果，无 key 或调用失败自动降级回提示词模式，不中断流程。示例：

python scripts/ai_insight_engine.py --template minutes-extract --input ./meetings/<id>/transcript.txt
python scripts/ai_insight_engine.py --template action-items --input ./meetings/<id>/transcript.txt --run --output actions.md

MCP 服务（v1.7 新增）：scripts/mcp_server.py 以 stdio 协议暴露 17 个工具（check_environment / normalize_transcript / run_reminder_check / project_health_board / export_report / market_monitor / run_code_review / ai_generate 等），供 MCP 客户端（Qoder/Claude 等）免 CLI 参数直接调用。客户端配置：command: python, args: ["<skill目录>/scripts/mcp_server.py", "--meetings-dir", "./meetings"]。安装自检：python scripts/mcp_server.py --check 输出工具清单 JSON。注意：run_reminder_check 默认 dry-run，真实发送需显式传 dry_run=false。

Step 5: 结构化输出

每次执行后输出（编号固定）：

1. 当前阶段与项目ID：Phase X - <project-id>，能力矩阵状态（主路径/降级）
2. 本次执行摘要：做了什么、关键结果（如"采集到 3 封邮件 + 12 条企微消息，识别 5 位参会人"）
3. 产出文件清单：路径 + 用途
4. 发送/操作回执：成功 N 条、失败 N 条及原因（对外动作必填）
5. 下一阶段建议：可推进到哪个阶段、入口提示词
6. 待用户决策项：需用户确认/补充的内容（如会议日期候选、缺失的考核标准、审核不通过项）

合规与风险提示

• 录音转录：Phase 3 启动前必须确认已征得全体参会人同意，建议在 Phase 2 通知中预先告知"本次会议将录音转写"
• 企业微信：须使用企业自建应用，会话存档仅限本企业内部合规使用，不得用于监控个人微信；个人微信无官方 API，本 skill 不支持
• 对外发送：Phase 2/4/5 的邮件/企微发送不可撤销，发送前强制预览确认
• 审核结论：Phase 6 审核结果仅作内部参考，最终是否交付由人工确认；媒体内容安全有误判风险，关键交付物需人工复核
• 数据上传：腾讯云 ASR/内容安全会上传音频/媒体数据，敏感会议评估是否使用私有化部署

One-Shot Recipes（v1.1.0 新增）

R1: 会前准备一条龙

用户：「下周和甲方有个腾讯会议，帮我准备一下」
Agent 输出：
  Phase 1 → 采集邮件+企微中的甲方需求 → requirements.json + attendees.json
  Phase 2 → 生成腾讯会议通知（含入会链接）→ 预览确认 → 邮件+企微发送
  提示：「已发送通知。会议当天对我说'开始转录'即可。」

R2: 会议转录 + 纪要

用户：「开始转录腾讯会议」或「把这段录音转成纪要」
Agent 输出：
  Phase 3 → 合规确认 → 实时/事后转录 → transcript.txt
  Phase 4 → 提取议题/决议/待办 → 生成 Word 纪要 → 预览确认 → 邮件+企微发送
  提示：「纪要已发送。待办事项已沉淀，可以说'排跟进日历'进入 Phase 5。」

R3: 排跟进日历

用户：「排个跟进日历」
Agent 输出：
  Phase 5 → 从 action-items 提取交付内容/日期/责任人 → 生成 followup.ics
  → 生成 reminders.json → 发相关人
  提示：「提醒已设置。请配置定时任务运行 check_reminders.py 进行自动提醒。」

R4: 交付前审核

用户：「审核下这个公告稿」/「检查这批代码」
Agent 输出：
  Phase 6 → 识别审核类型 → 文稿(错别字/敏感词/合规) / 媒体(内容安全) / 代码(lint+agent审查)
  → 生成审核报告 → review-log.md
  提示：「审核完成，X 项通过，Y 项需要修改。详见审核报告。」

R5: 快速检测环境

用户：「检查一下环境能不能用」
Agent 输出：
  Step 1 四类检测 → 能力卡片（Python/企微/腾讯云/邮件状态）
  → 缺失项安装命令 → 阶段可用性矩阵

R6: 行情异动监控（v1.5.0）

用户：「盯一下 600000 和 300750 的异动」
Agent 输出：
  运行 market_monitor.py --watch 600000,300750
  → 三维评分报告（量比/换手率/主力资金 + 综合分与级别）
  → 触发告警时提示可追加 --alerts 落盘或配定时任务周期巡检
  提示：「报告可直接通过邮件/企微下发，需要就说'发给项目组'。」

R7: 项目健康看板（v1.6.0）

用户：「看看所有项目的健康状况」/「哪些项目有逾期」
Agent 输出：
  运行 project_dashboard.py --dir ./meetings
  → 逐项目输出阶段进度条 + 逾期/即将到期待办 + 行动项完成率
  → 红黄绿健康度汇总
  提示：「需要存档就说'导出看板 Markdown'（--markdown --output）；
  逐条提醒进度用 check_reminders.py --board。」

R8: AI 洞察模板（v1.7.0）

用户：「把这段转录提取成行动项清单」/「给这份公告稿出初审意见」
Agent 输出：
  运行 ai_insight_engine.py --template action-items|review-announcement
  --input <文件> --json
  → 有 DEEPSEEK_API_KEY：直接返回生成结果并核对落盘
  → 无 key：返回渲染好的提示词，由当前 agent 按模板自行完成提取
  提示：「提取结果已产出，可进入 Phase 5 排跟进日历。」

进阶：跨 Skill 联动（v1.3.0）

本 Skill 可与 tencent-meeting-OCR Skill 配合，覆盖不同场景：

数据互通：两个 Skill 的 transcript.txt 格式兼容（[HH:MM:SS] 说话人: 内容），OCR Skill 的 infer_customer.py --json 输出可导入本 Skill 的 Phase 4 供纪要加强。

Bundled Files

• README.md — 用户快速上手指南（5 分钟入门 + 常见场景 + FAQ）
• scripts/setup_check.py — 一键环境检测（Python 依赖/企微/腾讯云/邮件四项 + 阶段可用性矩阵；v1.7 起 Phase 3/4 按阶段所需依赖判级，不再被全量依赖误报降级）
• scripts/check_reminders.py - 提醒轮询脚本（Phase 5 配套，可直接调度运行；支持 --board 全局跟进看板、--json 结构化输出、v1.6.1 起支持 --project 项目过滤；超期通知 escalated_at 去重且发送失败自动重试；v1.7 起缺 status 待办按 open 处理、带时区时间正确换算、--json 全路径输出纯 JSON）
• scripts/wecom_callback.py - 企微回调接收服务（Phase 1 档位 B 可选部署，已实现 URL 验证 + AES 验签解密 + 消息落库 wecom-inbox.jsonl；v1.6 起含 project_id 消毒防穿越 + timestamp 防重放 + MsgId 去重 + XML 消息解析；v1.7 起请求体 128KB 上限 + 回调 URL ?project=<id> 按项目落库）
• scripts/transcribe_helper.py — 转录辅助脚本（环境检测 + 第三方转录文本标准化 + 格式验证；v1.6 起自动探测标准/飞书妙记/讯飞听见/通用四种格式，--list-formats 查看；v1.7 起兼容 GBK/UTF-8 BOM 文本与全角冒号）
• scripts/code_review_helper.py — 代码审核辅助脚本（工具检测/运行 + agent 审查能力说明；v1.7 修正"干净通过"返回契约与 --lang 空格写法）
• scripts/market_monitor.py - v1.5 新增 行情异动监控（量比/换手率/主力资金三维量化评分，东财主源+腾讯备源自动降级，watchlist/告警 JSONL 持久化；v1.7 修停牌股报告崩溃、--json 纯输出、告警退出码不被单只失败短路）
• scripts/project_dashboard.py - v1.6 新增 项目健康看板（只读聚合全部项目的阶段进度/逾期待办/行动项完成率/审核记录，终端/JSON/Markdown 输出；v1.7 坏数据单条隔离、完成率封顶）
• scripts/ai_insight_engine.py - v1.7 新增 AI 纪要洞察引擎（5 类提示词模板：纪要提取/行动项/需求采集/文稿审核/跟进周报；DeepSeek 可选直出，无 key 静默降级为提示词模式）
• scripts/mcp_server.py - v1.7 新增 MCP stdio 服务（17 工具封装全部脚本能力；--check 自检；含子进程端到端协议测试）
• meetings/example-project-*.json|txt — 完整六阶段示例项目数据（requirements→attendees→transcript→action-items→reminders→project-state，文件名以 example-project- 为前缀平铺存放）
• references/detection.md - 四类依赖探测命令、能力矩阵、降级决策树、按平台安装命令
• references/phase-1-premeeting.md - 会前需求采集：邮件搜索策略、企微三档读取、信息提取、requirements/attendees schema
• references/phase-2-notification.md - 会议通知：腾讯会议入口三路径、HTML 模板、企微文本卡片、发送回执
• references/phase-3-transcription.md - 实时转录：合规确认、实时/事后模式、方言外语参数、transcript 格式
• references/phase-4-minutes.md - 会后纪要：提取结构、python-docx/pptx 模板、发送流程、action-items 沉淀
• references/phase-5-followup.md - 跟进日历：.ics 生成、reminders.json、提醒轮询、cron/Task Scheduler 配置
• references/phase-6-review.md - 项目审核：文稿/媒体/代码三子路由、审核维度、腾讯云内容安全、lint 集成、报告模板
• references/wecom-api.md - 企业微信 API：access_token、消息读取三档、userid 解析、应用消息/群消息/文件发送
• references/tencent-asr-api.md - 腾讯云 ASR+TMT：TC3 签名（含各服务版本号表）、RealTimeASR WebSocket、FlashRecognition、TMT 翻译、方言语种表
• references/email-and-calendar.md - 邮件 IMAP/SMTP + icalendar：邮箱配置表、邮件搜索/发送、VEVENT/VALARM 生成
• references/market-monitor.md - v1.5 新增 行情异动监控：数据源降级链、量化算法与阈值表、watchlist 结构、与六阶段联动方式