📋 行动项追踪器

> 会议开了，谁来执行？截止日期在哪？下次会议要汇报什么？
>
> 行动项追踪器只做一件事——让会议产出件件有着落、事事有回音。通过 AI 提取、自动分配、进度追踪、逾期预警和汇报总结，彻底解决"议而不决、决而不行"的痛点。

一、Overview 概述

大多数会议纪要工具把行动项当作附带产出。本技能完全聚焦于行动项的全生命周期管理，提供从提取到闭环的完整工具链：

二、Features 功能详解

2.1 智能提取

• 从原始会议记录中识别责任人 + 待办事项 + 截止日期的关联关系
• 支持自然语言解析："张三下周五前完成竞品分析报告" → 结构化行动项
• 自动区分行动项与讨论内容、决策记录、背景信息
• 置信度评分：对模糊表述标记"待确认"，避免误提取

2.2 自动分配

• 根据会议记录的人称指代（"我" = 记录者、"李四" = 相关方）推断负责人
• 支持手动重新分配和批量操作
• 分配后自动通知负责人（通过下游通知通道）

2.3 执行看板

• 按 待执行 | 进行中 | 已完成 | 逾期 四象限展示
• 支持按责任人、优先级、会议来源筛选
• 命令行快速预览，也可导出为 Markdown 嵌入文档

2.4 逾期预警

• 自动识别行动项的 deadline（明确日期 / "尽快" / "下周五前" 等模糊表达）
• 每日检查：距离截止 3 天 → 黄色预警；逾期 → 红色预警
• 生成逾期汇总清单，供下次会议开场使用

2.5 进度汇报

• 自动产出一份完整的行动项执行报告：
• ✅ 总体完成率（已完成 / 总项数）
• ⏳ 各责任人执行概览
• 🔴 逾期清单
• 📅 下次会议待讨论事项
• 报告直接嵌入会议纪要末尾，形成"会议 → 待办 → 追踪 → 汇报"闭环

三、Action Item Lifecycle 行动项生命周期

      ┌──────────────┐
      │   会议召开    │
      └──────┬───────┘
             │
      ┌──────▼───────┐
      │  AI 提取行动项 │  ← extract 命令
      └──────┬───────┘
             │
      ┌──────▼───────┐
      │  分配负责人    │  ← assign 命令
      └──────┬───────┘
             │
      ┌──────▼───────┐
      │  执行跟踪      │  ← list / status 命令
      └──────┬───────┘
             │
    ┌────────┴────────┐
    ▼                 ▼
┌───────┐       ┌────────┐
│ 已完成 │       │ 逾期   │
└───┬───┘       └───┬────┘
    │               │
    ▼               ▼
┌───────┐       ┌────────┐
│ 闭环   │       │ 预警通知 │ ← overdue 命令
└───────┘       └────────┘
    │               │
    └───────┬───────┘
            ▼
     ┌───────────┐
     │ 状态报告   │  ← report 命令
     └───────────┘

四、Usage Examples 使用示例

提取行动项

# 从会议记录中提取
python tracker.py extract --text "张经理负责跟进客户反馈，下周五前输出改进方案。李工在月底前完成API文档更新。"

# 从文件读取
type meeting-notes.md | python tracker.py extract --stdin

输出结构：

[
  {
    "id": 1,
    "content": "跟进客户反馈，输出改进方案",
    "owner": "张经理",
    "deadline": "2026-07-24",
    "priority": "high",
    "status": "pending",
    "source": "周会-2026-07-20",
    "created": "2026-07-20T01:15:00"
  }
]

查看看板

# 查看所有待办
python tracker.py list

# 按状态筛选
python tracker.py list --status pending
python tracker.py list --status overdue
python tracker.py list --status done

# 按负责人筛选
python tracker.py list --owner 张三

分配负责人

python tracker.py assign --id 1 --owner "张三"
python tracker.py assign --id 2 --owner "李四" --deadline "2026-08-01"

检查逾期

python tracker.py overdue
# 输出：
# 🔴 逾期行动项：
#  #1 "跟进客户反馈" - 张经理 - 截止: 2026-07-17 (逾期3天)

生成进度报告

python tracker.py report

报告示例（Markdown）：

# 行动项执行报告
生成时间: 2026-07-20 01:15

## 总览
- 总行动项: 12
- 已完成: 5 (41.7%)
- 进行中: 4 (33.3%)
- 待执行: 2 (16.7%)
- 逾期: 1 (8.3%)

## 各负责人执行情况
| 负责人 | 待执行 | 进行中 | 已完成 | 逾期 |
|--------|--------|--------|--------|------|
| 张三   | 0      | 2      | 3      | 0    |
| 李四   | 1      | 1      | 1      | 1    |
| 王五   | 1      | 1      | 1      | 0    |

## 🔴 逾期清单
暂无逾期行动项。

## 下次会议待跟进
- #2 API文档更新 - 李四 - 截止: 2026-07-31

五、Output Format 输出格式

所有行动项统一存储在 action-items.json，结构如下：

{
  "items": [
    {
      "id": 1,
      "content": "行动项描述",
      "owner": "负责人",
      "deadline": "2026-07-24",
      "priority": "high|medium|low",
      "status": "pending|in_progress|done|overdue",
      "source": "来源会议",
      "created": "ISO时间戳",
      "updated": "ISO时间戳",
      "notes": "备注"
    }
  ],
  "metadata": {
    "last_synced": "ISO时间戳",
    "total_items": 0,
    "overdue_count": 0
  }
}

六、Workflow Integration 工作流集成

与会议纪要技能配合

会议记录 → AI提取行动项 → 负责人确认 → 执行追踪 → 下次会议复盘
    ↑                              ↓                       ↓
  记录技能                   本技能追踪            生成进度报告 → 嵌入纪要

与日历/IM 提醒配合

• 可配合 cron 作业定时执行 overdue 检查
• 逾期结果可通过 webhook / 企业微信 / 钉钉 通知
• 报告可自动保存至团队文档库

七、Best Practices 最佳实践

1. 会议结束后立即提取：趁记忆新鲜，AI 提取准确率最高
2. 明确截止日期：提醒团队成员在记录时写明 deadline
3. 定期回顾：每次会议开场花 5 分钟过一遍逾期清单
4. 闭环原则：已完成项及时标记 done，保持看板干净
5. 责任到人：每个行动项有且只有一个主要负责人

行动项追踪器 v1.0.0 — 让每一次会议都算数。