# 看板变更监听系统 (TaskBoard Monitor)

## 功能概述

通用型任务看板变更监听系统，可监控 Markdown 格式任务看板的状态变化，自动触发通知和激活逻辑。

## 适用场景

- 多小组并行开发项目
- 任务看板状态变更需要即时通知
- 依赖触发：当某任务完成时自动激活下游任务
- 阻塞解除：当阻塞问题解决时自动通知相关小组

## 核心能力

1. **状态解析**：从 Markdown 看板中提取任务状态
2. **变更检测**：对比上一次状态，检测新增变化
3. **触发动作**：根据配置执行相应动作（通知、记录日志等）
4. **可配置**：支持自定义看板路径、触发规则、通知方式
5. **跨项目复用**：只需指定看板路径即可复用

## 使用方式

### 基础监控

```
TaskBoard Monitor: 检查 docs/小组任务书/任务执行状态看板.md
```

### 带触发条件的监控

```
TaskBoard Monitor:
  看板路径: docs/任务看板.md
  触发条件: 任何任务状态变为"✅已完成"
  动作: 输出变更报告
```

### 完整配置

```
TaskBoard Monitor:
  看板路径: docs/任务看板.md
  状态字段: 编号|任务|状态|Owner
  触发规则:
    - 当状态变为"✅已完成" → 记录完成时间，输出完成报告
    - 当状态变为"🟢可立即启动" → 检查依赖是否满足，输出激活建议
    - 当状态变为"🔴阻塞" → 记录阻塞原因
  输出: 变更报告 + 动作建议
```

## 输出格式

系统会输出：
1. **变更摘要**：本次检测到的所有变化
2. **触发动作**：每个变化对应的建议动作
3. **统计信息**：各状态任务数量

## 技术实现

- 读取 Markdown 看板文件
- 使用正则表达式解析任务表格
- 维护状态缓存（.taskboard-cache.json）
- 支持自定义触发规则
- 状态图标：✅已完成、🟢可立即启动、🔵进行中、⏳等待中、🔴阻塞、⚪未启动、🟡延期

## 复用方法

### 1. 复制 Skill 到其他项目

```bash
# 复制整个目录
cp -r .workbuddy/skills/taskboard-monitor /目标项目/.workbuddy/skills/
```

### 2. 在新项目中使用

```bash
python .workbuddy/skills/taskboard-monitor/taskboard_monitor.py "docs/你的任务看板.md"
```

### 3. 自定义看板格式

看板需满足以下格式：
- 包含表头：`| 编号 | 任务 | 状态 | Owner | ...`
- 任务编号格式：`X-Tn`（如 A-T1, B-T2, C-T3）
- 状态列包含图标：✅🟢🔵⏳🔴⚪🟡