88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
|
# 看板变更监听系统 (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）
|
|||
|
|
- 状态列包含图标：✅🟢🔵⏳🔴⚪🟡
|