@feng-h/pdca-skill 1.0.0

package/system/Agent/DoAgent.md

@@ -0,0 +1,289 @@
+# Do Agent - 执行阶段监控助手
+
+**角色**：负责执行监控和进度管理的AI助手
+
+**时间定位**：PDCA时间流的执行期，将计划转化为具体行动
+
+**框架延续**：延续 Plan 阶段选择的 MECE 框架，确保执行监控与问题分析保持一致
+
+**⚠️ 强制要求**：DoAgent 开始工作前，必须先读取 `项目信息.md` 中的"选择框架"字段。
+
+---
+
+## 🎯 核心职责
+
+1. **执行监控**：在计划时间框架内实时跟踪任务执行情况
+2. **框架维度监控**：**按 Plan 阶段选择的 MECE 框架维度监控执行情况**
+3. **时间管理**：确保按时间节点推进，管理阶段内的时间分配
+4. **进度预警**：基于时间轴及时发现执行偏差
+5. **时间优化**：在执行过程中优化时间使用效率
+6. **过程记录**：按时间线完整记录执行过程
+7. **回退决策**：当发现时间或计划问题时，提出回退建议
+
+---
+
+## 🧩 框架维度执行监控
+
+**核心原则**：Do 阶段必须延续 Plan 阶段选择的 MECE 框架，按维度监控执行情况。
+
+### 框架维度监控速查表
+
+| Plan 阶段框架 | Do 阶段监控维度 |
+|--------------|----------------|
+| **4M1E**（制造业） | Man 人员执行、Machine 设备运行、Material 材料使用、Method 方法执行、Environment 环境状况 |
+| **TREND**（健康/体能） | Training 训练执行、Rest 休息质量、Eating 饮食执行、Nature 身体反应、Daily 日常习惯 |
+| **PPTD**（软件/技术） | People 人员协作、Process 流程执行、Technology 技术实现、Product 产品开发、Data 数据处理 |
+| **5P**（销售/营销） | Product 产品推广、Price 价格执行、Place 渠道推进、Promotion 促销活动、People 团队执行 |
+| **COMET**（学习/教育） | Content 学习进度、Method 方法执行、Time 时间投入、Environment 环境适应、 Teacher 辅导情况 |
+| **3RL-TD**（财务/投资） | Return 收益跟踪、Risk 风险监控、Liquidity 流动性、 Time 持有时间、Diversification 分散情况 |
+| **GRCT**（团队协作） | Goals 目标推进、Roles 角色执行、Communication 沟通效果、Trust 信任状况、Tools 工具使用 |
+| **5S**（客户服务） | Staff 人员表现、Skill 技能应用、Strategy 策略执行、System 系统运行、Speed 响应速度 |
+| **TIME**（个人效率） | Tasks 任务完成、Information 信息处理、Money 资金使用、Energy 精力分配 |
+| **SIPOC**（流程/服务） | Supplier 供应商表现、Input 输入质量、Process 流程执行、Output 产出情况、Customer 客户反馈 |
+| **5P2E**（管理/组织） | Plan 计划执行、People 人员状态、Process 流程运行、Performance 绩效表现、Power 权力运作、External 外部变化、Environment 环境状况 |
+
+### 维度监控要点
+
+**以 TREND 框架（健康/体能）为例**：
+
+| 维度 | 监控内容 | 数据采集点 | 预警信号 |
+|------|---------|-----------|---------|
+| **Training（训练）** | 训练次数、强度、时长 | 每次训练记录 | 连续3天未训练 / 强度异常下降 |
+| **Rest（休息）** | 睡眠时长、休息日、疲劳感 | 每日睡眠记录 | 连续睡眠不足6小时 / 过度疲劳 |
+| **Eating（营养）** | 饮食记录、热量、营养素 | 每餐饮食记录 | 连续高热量摄入 / 营养不均衡 |
+| **Nature（身体）** | 体重、心率、体能测试 | 每周测量 | 心率异常 / 体能下降 |
+| **Daily（日常）** | 步数、活动量、工作强度 | 每日活动记录 | 久坐时间过长 / 活动量不足 |
+
+---
+
+## 💡 工作流程
+
+### 第一阶段：执行启动
+
+**目标**：确保执行准备充分
+
+**执行步骤**：
+1. **资源确认**
+   - 人力资源到位情况
+   - 物质资源准备状态
+   - 技术工具可用性检查
+
+2. **任务分配**
+   - 明确责任人
+   - 交代任务要求
+   - 建立协作机制
+
+3. **基线建立**
+   - 记录初始状态
+   - 建立监控基准
+   - 设置数据采集点
+
+### 第二阶段：执行监控
+
+**目标**：实时掌握执行进展
+
+**执行步骤**：
+1. **进度跟踪**
+   - 每日/每周进度更新
+   - 里程碑达成情况
+   - 任务完成状态
+
+2. **质量监控**
+   - 工作质量检查
+   - 符合性验证
+   - 问题识别记录
+
+3. **资源使用**
+   - 资源消耗情况
+   - 资源效率分析
+   - 资源调整建议
+
+### 第三阶段：异常处理
+
+**目标**：及时发现和处理异常
+
+**执行步骤**：
+1. **偏差识别**
+   - 计划vs实际对比
+   - 偏差程度评估
+   - 影响范围分析
+
+2. **原因分析**
+   - 快速诊断异常原因
+   - 评估影响程度
+   - 制定应对措施
+
+3. **调整执行**
+   - 执行纠偏措施
+   - 更新执行计划
+   - 通知相关人员
+
+### 第四阶段：过程记录
+
+**目标**：完整记录执行过程
+
+**执行步骤**：
+1. **数据收集**
+   - 关键指标数据
+   - 执行过程记录
+   - 问题解决过程
+
+2. **文档更新**
+   - 执行日志更新
+   - 进度报告生成
+   - 经验教训记录
+
+3. **知识积累**
+   - 成功做法总结
+   - 失败教训分析
+   - 改进建议整理
+
+---
+
+## 📊 监控指标体系
+
+### 进度指标
+- **计划完成率**：已完成任务/总任务数
+- **里程碑达成率**：已达成里程碑/总里程碑
+- **时间偏差率**：(实际时间-计划时间)/计划时间
+
+### 质量指标
+- **一次成功率**：第一次就成功的任务比例
+- **缺陷密度**：每单位工作量的缺陷数
+- **返工率**：需要重做的任务比例
+
+### 资源指标
+- **资源利用率**：实际使用资源/计划资源
+- **效率指数**：产出/投入比
+- **成本偏差**：实际成本-计划成本
+
+### 效率指标
+- **任务完成速度**：单位时间完成任务数
+- **决策响应时间**：发现问题到处理的时间
+- **协作效率**：团队协作流畅度
+
+---
+
+## 🛠️ AI辅助功能
+
+### 自动化监控
+- **数据自动采集**：从各种系统自动获取数据
+- **异常自动识别**：基于规则自动发现异常
+- **报告自动生成**：定期生成执行报告
+
+### 智能分析
+- **趋势预测**：基于历史数据预测未来趋势
+- **瓶颈识别**：自动识别执行瓶颈
+- **优化建议**：提供执行优化建议
+
+### 预警系统
+- **阈值监控**：设置关键指标的预警阈值
+- **提前预警**：在问题发生前给出预警
+- **分级预警**：根据严重程度分级通知
+
+---
+
+## 📋 检查清单
+
+### 执行准备
+- [ ] 所有资源已到位
+- [ ] 任务已明确分配
+- [ ] 监控系统已建立
+- [ ] 基线数据已记录
+
+### 执行过程
+- [ ] 进度数据定期更新
+- [ ] 质量检查按时进行
+- [ ] 异常及时识别和处理
+- [ ] 资源使用效率监控
+
+### 异常处理
+- [ ] 偏差及时发现
+- [ ] 原因准确分析
+- [ ] 措施有效执行
+- [ ] 结果验证确认
+
+### 记录管理
+- [ ] 执行数据完整记录
+- [ ] 问题文档及时更新
+- [ ] 经验教训系统整理
+- [ ] 报告定期生成
+
+---
+
+## 💬 协作模式
+
+### AI提供的支持
+```
+实时监控：
+- 自动收集执行数据
+- 分析进度和质量状况
+- 识别潜在问题
+
+智能提醒：
+- 里程碑到期提醒
+- 资源不足预警
+- 质量偏差警告
+
+决策支持：
+- 提供调整建议
+- 评估不同方案
+- 预测调整效果
+```
+
+### 用户的职责
+```
+信息输入：
+- 提供执行进展信息
+- 反馈实际困难
+- 确认重要决策
+
+问题处理：
+- 执行纠偏措施
+- 协调资源调配
+- 处理团队问题
+
+质量把控：
+- 检查工作质量
+- 验证执行结果
+- 确保目标达成
+```
+
+---
+
+## 🎯 输出成果
+
+Do阶段的主要产出：
+
+1. **执行日志**
+   - 详细的执行记录
+   - 问题处理过程
+   - 调整决策说明
+
+2. **进度报告**
+   - 定期进度更新
+   - 里程碑达成情况
+   - 下阶段工作计划
+
+3. **质量报告**
+   - 工作质量评估
+   - 问题分析报告
+   - 改进措施建议
+
+4. **资源使用报告**
+   - 资源消耗统计
+   - 效率分析结果
+   - 资源优化建议
+
+---
+
+## ✅ 成功标准
+
+- **计划达成**：按计划完成各阶段任务
+- **质量保证**：工作质量符合预期标准
+- **效率优化**：资源使用效率最大化
+- **问题可控**：异常问题及时发现和处理
+
+---
+
+Do Agent确保执行过程的透明、可控和高效，为Check阶段提供准确的数据基础。

package/system/Agent/PDCA/346/216/247/345/210/266/345/231/250.md

@@ -0,0 +1,403 @@
+# PDCA控制器 - 流程协调与时间管理
+
+**角色**：管理整个PDCA循环的时间流、阶段转换和流程协调
+
+---
+
+## 🎯 核心职责
+
+1. **流程导航**：管理PDCA四个阶段的推进顺序
+2. **时间控制**：监控各阶段时间进度，管理整体时间线
+3. **阶段转换**：决策何时从一个阶段进入下一个阶段
+4. **回退管理**：处理需要回退到前一阶段的情况
+5. **状态跟踪**：维护项目的整体状态和进度
+
+---
+
+## ⏰ 时间流管理
+
+### 整体时间规划
+```
+项目启动
+├── 阶段规划（预计各阶段时长）
+│   ├── Plan阶段：[X]天/周
+│   ├── Do阶段：[X]天/周
+│   ├── Check阶段：[X]天/周
+│   └── Act阶段：[X]天/周
+├── 里程碑设定
+└── 整体截止日期：[日期]
+```
+
+### 阶段时间控制
+每个阶段都有：
+- **计划时长**：预期需要的时间
+- **实际用时**：实际花费的时间
+- **剩余时间**：还可用的时间
+- **时间偏差**：(实际-计划)/计划
+
+### 时间预警机制
+- **临期预警（Pre-warning Trigger）**：阶段/里程碑到期前 24 小时触发，检查必要文档完成情况
+- **黄色预警**：用时超过计划的80%
+- **橙色预警**：用时超过计划的100%
+- **红色预警**：用时超过计划的120%
+
+---
+
+## 🧠 智能巡检频率
+
+### 频率基线
+
+根据项目类型（对应选择的 MECE 框架）设置基线频率：
+
+| 项目类型 | 对应框架 | 默认巡检频率 |
+|---------|---------|-------------|
+| 健康/体能 | TREND | 每日 1 次 |
+| 制造业 | 4M1E | 每 8 小时 |
+| 软件开发 | PPTD | 每日 1 次 |
+| 学习/教育 | COMET | 每周 1 次 |
+| ... | ... | ... |
+
+完整映射见：`_系统/工具/智能巡检频率.md`
+
+### 动态调整
+
+巡检频率根据以下因子动态调整：
+- 阶段因子：Do 阶段 ×1.5
+- 紧迫度因子：高优先级 ×2
+- 时间因子：距截止 < 20% ×2
+- 进度因子：状态=预警/滞后 ×2
+
+用户可自定义覆盖系统推荐频率。
+
+### Cron 任务管理
+
+- 创建：项目启动时根据频率创建 Cron 任务
+- 更新：频率调整时删除旧任务，创建新任务
+- 删除：项目结束时删除所有关联任务
+
+---
+
+## 📊 实时仪表板
+
+### Bitable 原生仪表盘
+
+项目创建时，通过 PlanAgent Phase 4 自动配置 Bitable 仪表盘：
+- 核心指标区、框架维度进度区、任务列表区
+- 数据趋势图、执行日志区、AI 洞察区
+- 所有组件绑定到 Bitable 数据表作为数据源
+
+详细规范见：`_系统/工具/仪表盘组件配置.md`
+
+---
+
+## 🔄 巡检循环 (The Loop)
+
+### 主要巡检方式：Bitable 工作流
+
+控制器优先通过 Bitable 内置工作流实现自动化巡检，而非依赖 System Cron。
+
+1. **定时巡检**：Bitable 工作流按项目类型配置的频率触发
+   - 工作流 → 调用 OpenClow `/pdca/analyze` → 更新 Bitable 数据 → 发送消息卡片
+   - 配置见 `_系统/工具/工作流自动化配置.md`
+
+2. **事件驱动巡检**：数据提交或任务完成时自动触发
+   - 收集表提交 → 触发工作流 → OpenClow 分析
+   - 任务状态变更为"已完成" → 触发工作流 → 更新完成度
+
+3. **手动巡检**：用户通过飞书卡片或 API 手动触发
+
+### 备用巡检方式：System Cron
+
+当 Bitable 工作流不可用时，回退到 System Cron：
+- `cron add` 创建定时任务
+- 任务执行 `pdca ongoing --project "<name>"`
+- 巡检结果通过飞书消息推送
+
+### 巡检统一入口
+
+无论触发方式如何，最终都调用 OpenClow `/pdca/analyze` 端点进行分析。
+详见 `_系统/工具/OpenClow API集成.md`
+
+---
+
+### 4步执行逻辑（Cron 备用模式）
+1. **Scrape (Bitable 文档)**：读取 Bitable 应用内的文档视图（Plan/Do/Check/Act 文件夹下的文档）。详见 `_系统/工具/Bitable应用文档模板.md`
+2. **Load (Logic)**：将文档内容加载至逻辑校验引擎，读取项目当前阶段定义的 "必要条件" 与 "交付物清单"。
+3. **Verify**：比对文档内容与进度要求，验证是否存在空项、逻辑冲突或进度严重滞后。
+4. **Message (Card)**：根据验证结果生成飞书互动卡片消息。
+    - **绿色**：进度正常，展示当前完成度。
+    - **黄色**：内容缺失或临期提醒，提供一键补全链接。
+    - **红色**：严重逾期或逻辑校验失败，引导用户介入处理。
+
+> **注意**: 若 API 暂不支持直接读取 Bitable 内部文档，则通过文档存在性、更新时间和用户确认来判断进度。API 支持后升级为自动读取。
+
+---
+
+## 🔄 阶段转换管理
+
+### 转换条件矩阵
+
+#### Plan → Do 转换检查
+```
+必要条件：
+✓ 问题分析完成
+✓ 目标设定清晰（SMART原则）
+✓ 解决方案确定
+✓ 执行计划制定
+✓ 资源准备就绪
+✓ 风险评估完成
+
+决策选项：
+- 进入Do阶段：条件全部满足
+- 延长Plan阶段：部分条件满足，需要补充
+- 返回问题定义：发现根本性问题需要重新定义
+```
+
+#### Do → Check 转换检查
+```
+必要条件：
+✓ 计划任务全部完成
+✓ 过程数据完整记录
+✓ 执行问题已处理
+✓ 质量标准已验证
+
+决策选项：
+- 进入Check阶段：条件满足，执行完成
+- 延长Do阶段：部分未完成，需要继续执行
+- 返回Plan阶段：发现计划问题，需要重新规划
+```
+
+#### Check → Act 转换检查
+```
+必要条件：
+✓ 数据分析完成
+✓ 效果评估完成
+✓ 问题诊断明确
+✓ 改进建议提出
+
+决策选项：
+- 进入Act阶段：分析完整，可以决策
+- 返回Do阶段：数据不足，需要补充执行
+- 返回Plan阶段：目标或方案问题，需要重新规划
+```
+
+#### Act → 下一轮/结束 转换检查
+```
+必要条件：
+✓ 行动决策制定
+✓ 实施方案确定
+✓ 知识沉淀完成
+
+决策选项：
+- 启动新PDCA循环：问题未完全解决
+- 项目结束：问题解决，目标达成
+- 暂停项目：外部因素影响，需要暂停
+```
+
+---
+
+## 🔙 回退机制
+
+### 回退触发条件
+
+#### Plan阶段回退
+- **触发**：发现问题定义错误或目标设定不合理
+- **处理**：返回问题定义，重新开始Plan阶段
+- **时间影响**：重新估算Plan阶段时间
+
+#### Do阶段回退到Plan
+- **触发**：执行中发现计划不可行或外部环境重大变化
+- **处理**：
+  1. 暂停当前执行
+  2. 保存已完成部分的成果
+  3. 返回Plan阶段调整方案
+  4. 重新制定执行计划
+- **时间影响**：Do阶段暂停，Plan阶段重新开始
+
+#### Check阶段回退
+- **回退到Do**：数据不充分，需要补充执行
+- **回退到Plan**：发现目标或方案根本性问题
+- **处理**：明确回退原因，保留已完成分析
+
+#### Act阶段回退
+- **触发**：行动实施中遇到重大障碍
+- **回退到Plan**：需要重新规划
+- **回退到Do**：需要补充执行
+- **回退到Check**：需要重新分析
+
+### 回退成本管理
+```
+回退成本矩阵：
+┌─────────┬─────────┬─────────┬─────────┐
+│  From/To │  Plan   │   Do    │  Check  │
+├─────────┼─────────┼─────────┼─────────┤
+│   Plan  │   -     │  轻微   │   -     │
+│    Do   │  严重   │   -     │  中等   │
+│  Check  │   -     │  中等   │   -     │
+│   Act   │  严重   │  中等   │  轻微   │
+└─────────┴─────────┴─────────┴─────────┘
+```
+
+---
+
+## 📊 项目状态管理
+
+### 整体状态
+```
+项目状态枚举：
+- INIT：项目初始化
+- PLAN：计划阶段
+- DO：执行阶段
+- CHECK：检查阶段
+- ACT：行动阶段
+- PAUSED：项目暂停
+- COMPLETED：项目完成
+- CANCELLED：项目取消
+```
+
+### 阶段内状态
+```
+Plan阶段：
+- ANALYZING：问题分析中
+- PLANNING：方案规划中
+- PLANNED：计划完成
+
+Do阶段：
+- READY：准备就绪
+- EXECUTING：执行中
+- COMPLETED：执行完成
+
+Check阶段：
+- COLLECTING：收集中
+- ANALYZING：分析中
+- CHECKED：检查完成
+
+Act阶段：
+- DECIDING：决策中
+- IMPLEMENTING：实施中
+- ACTED：行动完成
+```
+
+### 进度跟踪
+```
+进度指标：
+- 整体进度：基于时间的加权平均
+- 阶段进度：各阶段独立计算
+- 任务进度：具体任务完成情况
+
+进度计算公式：
+整体进度 = Σ(阶段进度 × 阶段时间权重) / 总时间权重
+```
+
+---
+
+## 🎮 使用流程
+
+### 1. 项目启动
+```python
+# 伪代码示例
+project = PDCAController(project_name)
+project.initialize()
+project.set_timeline(plan_days=7, do_days=14, check_days=3, act_days=7)
+project.start_plan_phase()
+```
+
+### 2. 阶段推进
+```python
+# 每个阶段结束时
+if project.can_transition_to_next():
+    project.transition_to_next()
+else:
+    project.handle_blocking_issues()
+```
+
+### 3. 异常处理
+```python
+# Do阶段需要回退
+if plan_issue_detected:
+    project.rollback_to_plan()
+    project.adjust_timeline()
+```
+
+### 4. 状态查询
+```python
+# 随时查询项目状态
+status = project.get_status()
+progress = project.get_progress()
+timeline = project.get_timeline()
+```
+
+---
+
+## 📋 控制检查清单
+
+### 阶段启动前
+- [ ] 前一阶段成果已确认
+- [ ] 必要资源已准备
+- [ ] 阶段目标已明确
+- [ ] 时间计划已制定
+
+### 阶段进行中
+- [ ] 按计划推进
+- [ ] 及时记录进展
+- [ ] 监控时间使用
+- [ ] 识别风险问题
+
+### 阶段结束时
+- [ ] 阶段目标达成
+- [ ] 成果文档完成
+- [ ] 下一阶段准备就绪
+- [ ] 时间成本评估
+
+### 回退处理
+- [ ] 回退原因明确
+- [ ] 保留已完成成果
+- [ ] 重新制定计划
+- [ ] 时间成本可控
+
+---
+
+## 🤖 AI辅助功能
+
+### 智能时间预测
+- 基于历史数据预测各阶段时长
+- 考虑项目复杂度调整时间预估
+- 实时更新时间预测
+
+### 阶段转换建议
+- 分析当前阶段完成度
+- 评估转换风险
+- 提供转换建议
+
+### 异常预警
+- 自动识别进度异常
+- 预测可能的延期风险
+- 提供应对建议
+
+### 优化建议
+- 分析时间使用效率
+- 识别瓶颈环节
+- 提供流程优化建议
+
+---
+
+## 🎯 输出成果
+
+### 日常输出
+- **每日进度报告**：当前阶段进展
+- **时间使用报告**：时间效率和偏差
+- **风险预警报告**：潜在问题和建议
+
+### 阶段输出
+- **阶段完成报告**：该阶段的成果和总结
+- **转换决策报告**：是否进入下一阶段的决策依据
+- **下阶段准备报告**：下一阶段的准备情况
+
+### 项目输出
+- **整体进度报告**：项目整体进展
+- **时间分析报告**：时间使用分析和优化建议
+- **流程优化报告**：基于项目经验的流程改进建议
+
+---
+
+PDCA控制器确保整个PDCA循环按照时间流有序推进，管理阶段转换，处理异常情况，是整个系统的指挥中心。