chore: 整理项目结构，清理归档文件，更新部署配置

2026-07-04 21:01:39 +08:00
parent 8bd4ab0366
commit 64ff1bf7d5
508 changed files with 43575 additions and 14129 deletions
@@ -0,0 +1,87 @@
+# 看板变更监听系统 (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）
+- 状态列包含图标：✅🟢🔵⏳🔴⚪🟡