腾讯会议甲方沟通跟进

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

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

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

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

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

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

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

项目上下文：每个会议/项目用 ./meetings// 持久化（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/--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// 对应位置
2. 更新 project-state.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，对到期项通过邮件/企微提醒责任人，超期项提醒我方负责人。配置方法见 references/phase-5-followup.md 第 5.5 节。

Step 5: 结构化输出

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

1. 当前阶段与项目ID：Phase X - ，能力矩阵状态（主路径/降级）
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/企微/腾讯云/邮件状态）
  → 缺失项安装命令 → 阶段可用性矩阵

Bundled Files

• README.md — 用户快速上手指南（5 分钟入门 + 常见场景 + FAQ）
• scripts/setup_check.py — 一键环境检测（Python 依赖/企微/腾讯云/邮件四项 + 阶段可用性矩阵）
• scripts/check_reminders.py - 提醒轮询脚本（Phase 5 配套，可直接调度运行；支持 --board 全局跟进看板）
• scripts/wecom_callback.py - 企微回调接收服务（Phase 1 档位 B 可选部署，已实现 URL 验证 + AES 验签解密 + 消息落库 wecom-inbox.jsonl）
• scripts/transcribe_helper.py — 转录辅助脚本（环境检测 + 第三方转录文本标准化 + 格式验证）
• scripts/code_review_helper.py — 代码审核辅助脚本（工具检测/运行 + agent 审查能力说明）
• meetings/example-project/ — 完整六阶段示例项目（requirements→attendees→transcript→action-items→reminders）
• 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 生成