wecom_it_smart_desk/.workbuddy/skills/taskboard-monitor/SKILL.md

看板变更监听系统 (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 到其他项目

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

2. 在新项目中使用

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

3. 自定义看板格式

看板需满足以下格式：

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