@feng-h/pdca-skill 1.0.0

package/system//345/267/245/345/205/267/Bitable/345/272/224/347/224/250/346/226/207/346/241/243/346/250/241/346/235/277.md

@@ -0,0 +1,232 @@
+# Bitable 应用内文档配置模板
+
+## 概述
+
+Bitable 多维表格支持应用内的文档视图（文档/文件夹功能）。项目创建时，应在 Bitable 应用内配置好文档结构，作为各阶段文档分析和协作的载体。
+
+**与 Wiki 的关系**：
+- **Wiki = 容器**：知识库空间，用于存放 Bitable 应用、项目索引、经验库
+- **Bitable 应用 = 文件**：放在 Wiki 节点下，内含数据表、收集表、仪表盘、工作流、文档
+- 项目的所有文档（Plan/Do/Check/Act 各阶段文档）应放在 **Bitable 应用内** 的文档视图中，而非 Wiki 独立文档
+
+## Bitable 应用内文档结构
+
+### 文件夹结构
+
+在 Bitable 应用中，创建以下文件夹层级：
+
+```
+Bitable 应用（[项目名称] PDCA）
+├── 📊 数据表（4张）
+├── 📋 收集表（按框架维度）
+├── 📈 仪表盘
+├── ⚙️ 工作流
+├── 📁 Plan阶段/
+│   ├── 问题分析.md
+│   ├── 目标设定.md
+│   ├── 解决方案.md
+│   └── 执行计划.md
+├── 📁 Do阶段/
+│   ├── 执行日志.md
+│   ├── 进度报告.md
+│   └── 问题记录.md
+├── 📁 Check阶段/
+│   ├── 数据分析.md
+│   ├── 效果评估.md
+│   └── 问题诊断.md
+└── 📁 Act阶段/
+    ├── 行动决策.md
+    ├── 实施方案.md
+    └── 知识总结.md
+```
+
+### 配置方式
+
+由于飞书 Bitable 暂无官方 API 支持程序化创建内部文档/文件夹，采用以下方式配置：
+
+#### 方式一：手动配置（首次创建时）
+1. 在 PlanAgent 创建 Bitable 应用后，引导用户在 Bitable 应用中手动创建文档结构
+2. 提供文件夹结构参考和文档模板内容
+3. 用户确认后继续项目流程
+
+#### 方式二：AI 引导配置
+1. AI 在 Plan 阶段分析完成后，向用户发送配置指导
+2. 逐步引导用户在 Bitable UI 中创建文件夹和文档
+3. 每个文档提供初始模板内容供用户编辑
+
+### 文档模板内容
+
+#### Plan 阶段文档模板
+
+**问题分析.md**
+```markdown
+# 问题分析
+
+## 问题描述
+- **问题现象：**
+- **发生频率：**
+- **影响范围：**
+
+## MECE 框架分析
+（根据选择的框架，按维度逐项分析）
+
+## 根本原因
+1. 
+2. 
+3. 
+
+## 影响评估
+- **对目标的影响：**
+- **对其他方面的影响：**
+```
+
+**目标设定.md**
+```markdown
+# 目标设定
+
+## SMART 目标
+- **Specific（具体）：**
+- **Measurable（可衡量）：**
+- **Achievable（可实现）：**
+- **Relevant（相关）：**
+- **Time-bound（有时限）：**
+
+## 关键指标
+| 指标名称 | 基准值 | 目标值 | 单位 |
+|---------|--------|--------|------|
+```
+
+**解决方案.md**
+```markdown
+# 解决方案
+
+## 方案一（推荐）
+- **方案描述：**
+- **可行性分析：**
+- **成本效益：**
+- **风险评估：**
+
+## 因果逻辑映射
+| 根因 | 对应措施 | 预期效果 |
+|------|---------|---------|
+```
+
+**执行计划.md**
+```markdown
+# 执行计划
+
+## 任务列表
+| 任务编号 | 任务描述 | 负责人 | 截止日期 | 优先级 | 来源维度 |
+|---------|---------|--------|---------|--------|---------|
+```
+
+#### Do 阶段文档模板
+
+**执行日志.md**
+```markdown
+# 执行日志
+
+| 日期 | 完成内容 | 遇到的问题 | 备注 |
+|------|---------|-----------|------|
+```
+
+**进度报告.md**
+```markdown
+# 进度报告
+
+## 当前进度
+- **整体完成度：** %
+- **已完成任务：**
+- **进行中任务：**
+- **未开始任务：**
+```
+
+**问题记录.md**
+```markdown
+# 问题记录
+
+| 日期 | 问题描述 | 影响 | 处理措施 | 状态 |
+|------|---------|------|---------|------|
+```
+
+#### Check 阶段文档模板
+
+**数据分析.md**
+```markdown
+# 数据分析
+
+## 收集的数据
+（来自数据记录表的趋势分析）
+
+## 趋势分析
+- **指标变化趋势：**
+- **异常数据点：**
+```
+
+**效果评估.md**
+```markdown
+# 效果评估
+
+## 目标达成情况
+| 指标 | 基准值 | 目标值 | 实际值 | 达成率 |
+|------|--------|--------|--------|--------|
+```
+
+**问题诊断.md**
+```markdown
+# 问题诊断
+
+## 未达预期分析
+- **问题点：**
+- **根本原因：**
+- **改进建议：**
+```
+
+#### Act 阶段文档模板
+
+**行动决策.md**
+```markdown
+# 行动决策
+
+## 决策内容
+1. 
+2. 
+3. 
+
+## 决策依据
+- **数据支撑：**
+- **团队共识：**
+```
+
+**实施方案.md**
+```markdown
+# 实施方案
+
+## 具体措施
+| 措施 | 负责人 | 时间 | 预期效果 |
+|------|--------|------|---------|
+```
+
+**知识总结.md**
+```markdown
+# 知识总结
+
+## 成功经验
+1. 
+
+## 失败教训
+1. 
+
+## 标准化成果
+- **SOP 更新：**
+- **制度更新：**
+```
+
+## AI 巡检时读取 Bitable 文档
+
+PDCA 控制器在巡检时，应读取 Bitable 应用内的文档视图：
+1. 通过文档视图读取各阶段文档的完成度
+2. 检查必填项和交付物是否完成
+3. 对比阶段要求，验证文档质量
+
+> **注意**: 目前 Bitable 文档视图无 API 直接读取内容。AI 通过查看 Bitable 文档的元信息（如是否存在、是否更新）来判断进度，具体内容通过用户确认获取。待飞书 API 支持后，可实现自动读取。

package/system//345/267/245/345/205/267/Bitable/350/241/250/347/273/223/346/236/204/345/256/232/344/271/211.md

@@ -0,0 +1,376 @@
+# Bitable 表结构定义
+
+PDCA 任务/排期管理系统使用飞书多维表格（Bitable）作为核心数据存储，定义 4 张核心表实现项目、任务、数据、日志的全生命周期管理。
+
+---
+
+## 数据表概览
+
+```
+PDCA Bitable 应用
+├── 项目主表 (projects)          — 项目核心信息与状态管理
+├── 任务数据表 (tasks)               — 任务分解与执行跟踪
+├── 数据收集记录表 (data_records) — 测量数据与指标记录
+└── 执行日志表 (logs)            — 过程记录与决策追溯
+```
+
+---
+
+## 表 1: 项目主表 (projects)
+
+### 用途
+存储 PDCA 项目的核心信息，作为项目状态管理的唯一事实来源。
+
+### 字段定义
+
+| 字段名 | 类型 | type值 | 说明 | 值格式 | 必填 |
+|--------|------|--------|------|--------|------|
+| 项目ID | 文本 | 1 | 唯一标识符 | UUID 字符串 | 是 |
+| 项目名称 | 文本 | 1 | 项目标题 | 字符串 | 是 |
+| 选择框架 | 单选 | 3 | MECE 分析框架 | 4M1E/TREND/PPTD/5P/COMET/3RL-TD/GRCT/5S/TIME/SIPOC/5P2E | 是 |
+| 当前阶段 | 单选 | 3 | PDCA 当前阶段 | Plan/Do/Check/Act/已完成 | 是 |
+| 状态 | 单选 | 3 | 项目健康状态 | 正常/预警/超时/已完成 | 是 |
+| 负责人 | 人员 | 11 | 项目负责人 | `[{id: "ou_xxx"}]` | 是 |
+| 开始日期 | 日期 | 5 | 项目启动日期 | 毫秒时间戳 | 是 |
+| 预计结束日期 | 日期 | 5 | 计划结束日期 | 毫秒时间戳 | 是 |
+| 完成度 | 数字 | 2 | 项目完成百分比 | 0-100 | 是 |
+| Bitable链接 | 超链接 | 15 | Bitable 应用链接 | `{link: "url", text: "标题"}` | 是 |
+| Wiki链接 | 超链接 | 15 | Wiki 项目节点链接 | `{link: "url", text: "标题"}` | 是 |
+
+### 字段 property 配置示例
+
+```json
+{
+  "选择框架": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "4M1E"},
+        {"name": "TREND"},
+        {"name": "PPTD"},
+        {"name": "5P"},
+        {"name": "COMET"},
+        {"name": "3RL-TD"},
+        {"name": "GRCT"},
+        {"name": "5S"},
+        {"name": "TIME"},
+        {"name": "SIPOC"},
+        {"name": "5P2E"}
+      ]
+    }
+  },
+  "当前阶段": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "Plan"},
+        {"name": "Do"},
+        {"name": "Check"},
+        {"name": "Act"},
+        {"name": "已完成"}
+      ]
+    }
+  },
+  "状态": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "正常"},
+        {"name": "预警"},
+        {"name": "超时"},
+        {"name": "已完成"}
+      ]
+    }
+  }
+}
+```
+
+### 索引建议
+- 主索引：项目ID
+- 查询索引：状态 + 当前阶段（用于巡检筛选）
+
+---
+
+## 表 2: 任务数据表 (tasks)
+
+### 设计原则：任务即数据行
+
+任务直接在 Bitable 数据表中管理，任务状态作为列存在，不再依赖飞书 Task。
+每行既是任务也是数据记录，支持直接关联到数据记录表的测量数据。
+
+### 用途
+管理 PDCA 各阶段的具体任务，支持从框架维度自动生成和手动添加。
+任务与数据在同一表中，可通过关联字段连接数据记录。
+
+### 字段定义
+
+| 字段名 | 类型 | type值 | 说明 | 值格式 | 必填 |
+|--------|------|--------|------|--------|------|
+| 任务ID | 文本 | 1 | 唯一标识符 | 如 "TASK-001" | 是 |
+| 项目ID | 文本 | 1 | 关联项目 | 关联到项目主表.项目ID | 是 |
+| 任务标题 | 文本 | 1 | 任务名称 | 字符串 | 是 |
+| 任务状态 | 单选 | 3 | 任务状态 | 未开始/进行中/已完成/已取消 | 是 |
+| 任务描述 | 多行文本 | 15 | 详细说明 | 长文本 | 否 |
+| 来源维度 | 单选 | 3 | MECE 框架维度 | 根据选择框架动态生成 | 是 |
+| 来源类型 | 单选 | 3 | 任务来源 | 问题分析生成/执行计划生成/手动添加 | 是 |
+| 截止日期 | 日期 | 5 | 任务截止时间 | 毫秒时间戳 | 是 |
+| 负责人 | 人员 | 11 | 任务负责人 | `[{id: "ou_xxx"}]` | 是 |
+| 优先级 | 单选 | 3 | 任务优先级 | 高/中/低 | 是 |
+| **数据记录** | **关联记录** | **18** | **关联到数据记录表** | `["记录ID1", "记录ID2"]` | 否 |
+| **完成度** | **数字** | **2** | **完成百分比** | 0-100 | 是 |
+| 创建时间 | 日期时间 | 5 | 任务创建时间 | 毫秒时间戳 | 是 |
+| 完成时间 | 日期时间 | 5 | 任务完成时间 | 毫秒时间戳 | 否 |
+
+### 字段 property 配置示例
+
+```json
+{
+  "任务状态": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "未开始"},
+        {"name": "进行中"},
+        {"name": "已完成"},
+        {"name": "已取消"}
+      ]
+    }
+  },
+  "来源类型": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "问题分析生成"},
+        {"name": "执行计划生成"},
+        {"name": "手动添加"}
+      ]
+    }
+  },
+  "优先级": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "高"},
+        {"name": "中"},
+        {"name": "低"}
+      ]
+    }
+  }
+}
+```
+
+### 来源维度示例（以 4M1E 为例）
+- Man（人）：人员培训、技能提升
+- Machine（机）：设备维护、工具改进
+- Material（料）：原料质量、供应商管理
+- Method（法）：工艺优化、流程改进
+- Environment（环）：工作环境、现场管理
+
+### 索引建议
+- 主索引：任务ID
+- 查询索引：项目ID + 状态（用于项目任务看板）
+
+---
+
+## 表 3: 数据收集记录表 (data_records)
+
+### 用途
+记录 Do 阶段收集的测量数据，支撑 Check 阶段的效果分析。
+
+### 字段定义
+
+| 字段名 | 类型 | type值 | 说明 | 值格式 | 必填 |
+|--------|------|--------|------|--------|------|
+| 记录ID | 文本 | 1 | 唯一标识符 | UUID 字符串 | 是 |
+| 项目ID | 文本 | 1 | 关联项目 | 关联到项目主表.项目ID | 是 |
+| 指标名称 | 文本 | 1 | 数据项名称 | 如 "设备OEE"、"不良率" | 是 |
+| 维度 | 单选 | 3 | 框架维度 | 对应分析框架的维度 | 是 |
+| 数值 | 数字 | 2 | 测量值 | 数字 | 是 |
+| 单位 | 文本 | 1 | 测量单位 | 如 "%"、"ppm"、"小时" | 是 |
+| 记录时间 | 日期时间 | 5 | 数据采集时间 | 毫秒时间戳 | 是 |
+| 记录人 | 人员 | 11 | 数据记录者 | `[{id: "ou_xxx"}]` | 是 |
+
+### 使用场景
+- **Plan 阶段**：定义指标模板（基准值、目标值）
+- **Do 阶段**：按计划频率收集实际数据
+- **Check 阶段**：分析趋势，计算改善效果
+
+### 索引建议
+- 主索引：记录ID
+- 查询索引：项目ID + 指标名称（用于数据趋势分析）
+- 时间索引：记录时间（用于时序查询）
+
+---
+
+## 表 4: 执行日志表 (logs)
+
+### 用途
+记录 PDCA 执行过程中的关键事件、决策和问题，支持过程追溯。
+
+### 字段定义
+
+| 字段名 | 类型 | type值 | 说明 | 值格式 | 必填 |
+|--------|------|--------|------|--------|------|
+| 日志ID | 文本 | 1 | 唯一标识符 | UUID 字符串 | 是 |
+| 项目ID | 文本 | 1 | 关联项目 | 关联到项目主表.项目ID | 是 |
+| 阶段 | 单选 | 3 | 所属阶段 | Plan/Do/Check/Act | 是 |
+| 日志类型 | 单选 | 3 | 日志分类 | 进展更新/问题记录/决策记录/AI洞察 | 是 |
+| 内容 | 多行文本 | 15 | 日志详细内容 | 长文本 | 是 |
+| 记录时间 | 日期时间 | 5 | 日志创建时间 | 毫秒时间戳 | 是 |
+| 记录人 | 人员 | 11 | 日志创建者 | `[{id: "ou_xxx"}]` | 是 |
+
+### 字段 property 配置示例
+
+```json
+{
+  "日志类型": {
+    "type": 3,
+    "property": {
+      "options": [
+        {"name": "进展更新"},
+        {"name": "问题记录"},
+        {"name": "决策记录"},
+        {"name": "AI洞察"}
+      ]
+    }
+  }
+}
+```
+
+### 日志内容示例
+
+**进展更新**
+```
+完成了设备停机原因的数据收集，共收集 30 天数据，
+发现主要故障集中在液压系统（占 65%）。
+```
+
+**问题记录**
+```
+数据收集过程中遇到传感器故障，导致第 12-14 天数据缺失。
+已安排维修，预计明天恢复。
+```
+
+**决策记录**
+```
+经团队讨论，决定优先处理液压系统问题。
+理由：1. 影响最大；2. 改善成本可控；3. 技术方案成熟。
+```
+
+**AI洞察**
+```
+AI 分析 Do 阶段数据发现：设备停机时间与环境温度存在强相关性（r=0.78）。
+建议：在 Check 阶段增加环境温度作为控制变量，验证相关性是否成立。
+```
+
+### 索引建议
+- 主索引：日志ID
+- 查询索引：项目ID + 记录时间（用于项目时间线）
+
+---
+
+## API 调用注意事项
+
+### 创建数据表
+
+```bash
+# 1. 创建 Bitable 应用
+feishu_bitable_app.create --name "PDCA项目管理" --folder "<folder_token>"
+
+# 2. 创建数据表（以项目主表为例）
+feishu_bitable_app_table.create \
+  --app_token "<app_token>" \
+  --table "projects" \
+  --default_view_name "所有项目" \
+  --fields '[
+    {"name": "项目ID", "type": 1, "property": {}},
+    {"name": "项目名称", "type": 1, "property": {}},
+    {"name": "选择框架", "type": 3, "property": {"options": [{"name": "4M1E"}, ...]}},
+    ...
+  ]'
+```
+
+### 插入记录
+
+```bash
+# 创建项目记录
+feishu_bitable_app_table_record.create \
+  --app_token "<app_token>" \
+  --table_id "<table_id>" \
+  --fields '{
+    "项目ID": "uuid-xxx",
+    "项目名称": "挖掘机臂架开裂改善",
+    "选择框架": "4M1E",
+    "当前阶段": "Plan",
+    "状态": "正常",
+    "负责人": [{"id": "ou_xxx"}],
+    "开始日期": 1712457600000,
+    "预计结束日期": 1715308800000,
+    "完成度": 0,
+    "Wiki链接": {"link": "https://xxx", "text": "查看文档"}
+  }'
+```
+
+### 重要坑位
+
+> ⚠️ 参考 `pdca/references/feishu-integration.md` 中的 Bitable 集成规范：
+>
+> 1. **人员字段**：值必须是 `[{id: "ou_xxx"}]`，不能直接传字符串
+> 2. **日期字段**：使用**毫秒时间戳**，不是秒
+> 3. **超链接字段 (type=15)**：创建时**不要传 property 参数**，否则报错
+> 4. **并发限制**：同一表不支持并发写，串行调用并延迟 0.5-1 秒
+> 5. **默认空行**：新建表会有空行，插入前先 `list` + `batch_delete` 清理
+> 6. **关联记录字段 (type=18)**：如果飞书 API 不支持关联记录类型，改用文本字段存储关联 ID 列表（如 `["rec_001", "rec_002"]`）
+
+---
+
+## 数据关系图
+
+```
+项目主表 (projects)
+    ├── 1:N → 任务数据表 (tasks)
+    ├── 1:N → 数据收集记录表 (data_records)
+    └── 1:N → 执行日志表 (logs)
+
+任务数据表 (tasks)
+    └── N:M → 数据收集记录表 (data_records)  [通过 数据记录 关联记录字段(type=18)]
+
+关联字段：项目ID
+```
+
+---
+
+## 巡检逻辑
+
+基于这些表结构，PDCA Controller 的巡检流程：
+
+1. **搜索活跃项目**
+   ```bash
+   feishu_bitable_app_table_record.search \
+     --filter '{"状态": ["正常", "预警", "超时"]}'
+   ```
+
+2. **计算完成度**
+   - 读取 Wiki 文档内容
+   - 对比当前阶段交付物清单
+   - 计算 0-100 完成度
+
+3. **状态判定**
+   - 正常：当前日期 < 截止日 且 进度符合预期
+   - 预警：剩余时间 < 20% 且 进度滞后
+   - 超时：当前日期 > 截止日
+
+4. **更新记录**
+   ```bash
+   feishu_bitable_app_table_record.update \
+     --record_id "<record_id>" \
+     --fields '{"完成度": 65, "状态": "预警"}'
+   ```
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更说明 |
+|------|------|---------|
+| v1.0 | 2026-04-04 | 初始版本，定义 4 张核心表结构 |

package/system//345/267/245/345/205/267/OpenClow API/351/233/206/346/210/220.md"

@@ -0,0 +1,109 @@
+# OpenClow API 集成
+
+## 概述
+
+OpenClow 通过 `/pdca/analyze` 端点提供 PDCA 项目的 AI 分析能力。
+Bitable 工作流和 PDCA 控制器通过该 API 实现对项目的智能巡检。
+
+## 接口定义
+
+### POST /pdca/analyze
+
+**请求体**:
+```json
+{
+  "project": "[项目名称]",
+  "trigger": "scheduled|event|manual",
+  "context": {
+    "trigger_type": "form_submit|task_complete|scheduled",
+    "data_record_id": "[记录ID]",
+    "task_id": "[任务ID]"
+  }
+}
+```
+
+**请求参数说明**:
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| project | string | 是 | 项目名称，用于定位 Bitable 中的数据 |
+| trigger | string | 是 | 触发方式：scheduled(定时)/event(事件)/manual(手动) |
+| context | object | 否 | 附加上下文信息 |
+| context.trigger_type | string | 否 | 具体触发类型 |
+| context.data_record_id | string | 否 | 新数据记录 ID（事件触发时传入） |
+| context.task_id | string | 否 | 任务 ID（任务变更时传入） |
+
+**响应体**:
+```json
+{
+  "status": "success",
+  "insights": ["AI 分析结果1", "AI 分析结果2"],
+  "actions": ["建议操作1", "建议操作2"],
+  "updates": {
+    "wiki": ["需要更新的 Wiki 文档路径"],
+    "bitable": {
+      "project_completion": 65,
+      "project_status": "正常",
+      "task_updates": []
+    }
+  }
+}
+```
+
+**响应字段说明**:
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| status | string | 分析状态：success/timeout/error/no_changes |
+| insights | string[] | AI 分析洞察，每条为一条分析结果 |
+| actions | string[] | 建议的操作行动 |
+| updates.wiki | string[] | 需要更新的 Wiki 文档路径列表 |
+| updates.bitable.project_completion | number | 建议的项目完成度 (0-100) |
+| updates.bitable.project_status | string | 建议的项目状态：正常/预警/超时/已完成 |
+| updates.bitable.task_updates | object[] | 需要更新的任务记录列表 |
+
+## 调用方式
+
+### 从 Bitable 工作流调用
+
+工作流中的 HTTP 节点配置：
+- **URL**: `https://<openclow-host>/pdca/analyze`
+- **Method**: `POST`
+- **Headers**: `{"Authorization": "Bearer ${OPENCLOW_API_KEY}"}`
+- **Body**: 动态填充项目名和上下文
+
+### 从 PDCA 控制器调用
+
+当工作流不可用时，PDCA 控制器可以直接调用：
+```bash
+curl -X POST https://<openclow-host>/pdca/analyze \
+  -H "Authorization: Bearer ${OPENCLOW_API_KEY}" \
+  -d '{"project": "项目名称", "trigger": "manual"}'
+```
+
+## AI 分析职责
+
+1. **读取 Bitable 数据**: 读取项目主表、任务数据表、数据记录表的当前状态
+2. **读取 Wiki 文档**: 读取各阶段文档完成度
+3. **计算完成度**: 根据阶段交付物清单计算百分比
+4. **状态判定**: 判断正常/预警/超时
+5. **趋势分析**: 分析数据记录的变化趋势
+6. **生成洞察**: 输出分析结果和建议
+
+## 错误处理
+
+| 状态码 | 响应 | 说明 |
+|--------|------|------|
+| success | 正常响应 | 分析完成 |
+| timeout | `{"status": "timeout"}` | 30 秒超时 |
+| error | `{"status": "error", "message": "错误描述"}` | API 错误 |
+| no_changes | `{"status": "no_changes", "message": "自上次分析无新数据"}` | 无新数据 |
+
+## 认证
+
+使用 Bearer Token 认证：
+```
+Authorization: Bearer ${OPENCLOW_API_KEY}
+```
+
+API Key 通过环境变量或密钥管理获取，不应硬编码在工作流配置中。