@feng-h/pdca-skill 1.0.0

package/assets/tests/improvement-analysis-tdd.md

@@ -0,0 +1,405 @@
+# PDCA Skill 改进分析 - TDD 方法
+
+## 概述
+
+本文档记录对 PDCA Skill 的三个问题的分析和改进方案，遵循 RED-GREEN-REFACTOR 循环。
+
+---
+
+## 问题 1：Plan 阶段原因分析缺乏 MECE 框架
+
+### 问题描述
+- **症状**：Plan 阶段对原因分析不足，信马由缰，想到哪就问哪，没有体系
+- **用户需求**：采用 MECE 框架进行问题分析
+- **影响**：问题分析不全面，可能遗漏关键因素
+
+### RED 阶段：基线行为分析
+
+**测试场景**：
+用户：我们的设备 OEE 只有 65%，停机时间主要来自换型时间长、设备故障频繁、原材料供应不及时。
+
+**当前 Agent 行为（无 MECE）**：
+- 可能直接接受用户提供的原因
+- 可能随机追问某个方面
+- 可能没有系统性地覆盖所有维度
+
+**问题识别**：
+1. 缺乏结构化的分析框架
+2. 没有确保"相互独立、完全穷尽"
+3. 容易遗漏关键维度
+
+### GREEN 阶段：改进方案
+
+**解决方案**：在 PlanAgent.md 中集成 MECE 框架
+
+#### MECE 分析框架定义
+
+**MECE 原则**：
+- **Mutually Exclusive（相互独立）**：各分类之间不重叠
+- **Collectively Exhaustive（完全穷尽）**：所有可能情况都被覆盖
+
+#### 制造业问题的 MECE 分类框架
+
+```
+问题分类（第一层 MECE）
+├── 4M1E 框架
+│   ├── Man（人员）
+│   ├── Machine（设备）
+│   ├── Material（材料）
+│   ├── Method（方法）
+│   └── Environment（环境）
+└── 时间维度
+    ├── 突发问题
+    └── 系统性问题
+```
+
+#### 问题分析工作流（MECE 驱动）
+
+```
+digraph mece_workflow {
+    rankdir=TB;
+    "用户描述问题" [shape=doublecircle];
+    "MECE 框架选择" [shape=diamond];
+    "4M1E 分析" [shape=box];
+    "时间维度分析" [shape=box];
+    "穷尽性检查" [shape=diamond];
+    "根因识别" [shape=box];
+
+    "用户描述问题" -> "MECE 框架选择";
+    "MECE 框架选择" -> "4M1E 分析" [label="制造业问题"];
+    "MECE 框架选择" -> "时间维度分析" [label="其他问题"];
+    "4M1E 分析" -> "穷尽性检查";
+    "时间维度分析" -> "穷尽性检查";
+    "穷尽性检查" -> "根因识别" [label="通过"];
+    "穷尽性检查" -> "MECE 框架选择" [label="遗漏，重新分析"];
+}
+```
+
+#### 修改内容
+
+**文件**：`_系统/Agent/PlanAgent.md`
+
+**修改位置**：第一阶段：问题理解 → 根本原因分析
+
+**修改前**：
+```markdown
+3. **根本原因分析**
+   - 使用5W1H方法
+   - 识别直接原因和根本原因
+   - 分析问题的关键约束
+```
+
+**修改后**：
+```markdown
+3. **根本原因分析（MECE 框架）**
+   - **MECE 框架选择**：根据问题类型选择合适的 MECE 分类
+     - 制造业问题：使用 4M1E 框架（Man/Machine/Material/Method/Environment）
+     - 管理问题：使用 PDCA 框架（Plan/Do/Check/Act）
+     - 流程问题：使用 SIPOC 框架（Supplier/Input/Process/Output/Customer）
+   - **穷尽性扫描**：逐维度检查，确保不遗漏
+   - **独立性验证**：确保各分类之间不重叠
+   - **根因定位**：使用 5Why 深入各维度的根本原因
+   - **MECE 检查清单**：
+     - [ ] 所有主要维度都已覆盖
+     - [ ] 各维度之间没有重叠
+     - [ ] 每个维度都有深入分析
+```
+
+---
+
+## 问题 2：Plan 阶段选项设计不足
+
+### 问题描述
+- **症状**：有时候的选项都是用户要选的，但是没有让用户输入的选择
+- **用户需求**：需要提供"自定义输入"选项
+- **影响**：用户被迫选择不合适的选项
+
+### RED 阶段：基线行为分析
+
+**测试场景**：
+Agent 需要用户选择问题类型，但用户的实际问题不在预定义选项中。
+
+**当前 Agent 行为**：
+- 提供固定的选项列表
+- 没有"其他"或"自定义"选项
+- 用户被迫选择最接近但不准确的选项
+
+### GREEN 阶段：改进方案
+
+**解决方案**：在 SKILL.md 中添加选项设计规范
+
+#### AskUserQuestion 使用规范
+
+**规则**：当使用 AskUserQuestion 时，**必须**包含"Other"选项允许用户自定义输入。
+
+#### 修改内容
+
+**文件**：`pdca/SKILL.md`
+
+**新增章节**：
+```markdown
+## 🎯 用户交互规范
+
+### 选项设计原则
+
+使用 AskUserQuestion 时，**必须**遵循以下规则：
+
+1. **必须有"Other"选项**：所有单选问题必须包含"Other"选项
+2. **多选允许自定义**：多选问题应允许用户输入自定义值
+3. **选项要互斥**：确保选项之间相互独立
+4. **选项要穷尽**：覆盖常见情况 + Other
+
+### 正确示例
+
+```yaml
+questions:
+  - question: "这个问题属于哪个类型？"
+    options:
+      - label: "设备问题"
+        description: "与设备故障、维护相关的问题"
+      - label: "质量问题"
+        description: "与产品缺陷、工艺相关的问题"
+      - label: "效率问题"
+        description: "与生产效率、OEE相关的问题"
+      - label: "Other"
+        description: "其他类型问题（请自定义输入）"
+```
+
+### 错误示例
+
+❌ **错误**：没有"Other"选项
+```yaml
+options:
+  - label: "设备问题"
+  - label: "质量问题"
+  - label: "效率问题"
+# 用户的问题可能是"人员问题"，但无法选择！
+```
+```
+
+---
+
+## 问题 3：Wiki 云文档创建位置不明确
+
+### 问题描述
+- **症状**：云文档创建没有明确位置
+- **用户需求**：
+  - 所有 PDCA 项目应该在 wiki 里的"PDCA项目管理"下
+  - 具体项目要创建子文件夹，如"XXX提升项目"
+  - 项目下生成相关文件（Plan/Do/Check/Act 阶段）
+  - PDCA项目管理需要有一个跟踪展示，显示所有项目进展
+- **影响**：项目文档分散，难以管理和查看
+
+### RED 阶段：基线行为分析
+
+**当前行为**：
+- 没有明确定义 Wiki 节点层级
+- 项目可能创建在任意位置
+- 没有统一的项目索引
+
+### GREEN 阶段：改进方案
+
+#### Wiki 层级结构定义
+
+```
+飞书 Wiki 知识空间
+└── PDCA项目管理（根节点）
+    ├── 📊 项目索引.md（跟踪展示所有项目进展）
+    │   └── 内容：项目名称、当前阶段、状态、负责人、开始日期、完成度
+    │
+    └── 📁 [项目名称]/（子节点，每个项目一个）
+        ├── 📋 项目信息.md
+        ├── 📁 Plan阶段/
+        │   ├── 问题分析.md
+        │   ├── 目标设定.md
+        │   ├── 解决方案.md
+        │   └── 执行计划.md
+        ├── 📁 Do阶段/
+        │   ├── 执行日志.md
+        │   ├── 进度报告.md
+        │   └── 问题记录.md
+        ├── 📁 Check阶段/
+        │   ├── 数据分析.md
+        │   ├── 效果评估.md
+        │   └── 问题诊断.md
+        └── 📁 Act阶段/
+            ├── 行动决策.md
+            ├── 实施方案.md
+            └── 知识总结.md
+```
+
+#### 修改内容
+
+**文件**：`pdca/references/feishu-integration.md`
+
+**新增章节**：Wiki 层级结构规范
+
+```markdown
+## Wiki 层级结构规范
+
+### 根节点：PDCA项目管理
+
+所有 PDCA 项目必须创建在"PDCA项目管理"根节点下。
+
+### 项目索引
+
+**文件名**：`📊 项目索引.md`
+**位置**：PDCA项目管理/项目索引.md
+**内容格式**：
+
+```markdown
+# PDCA 项目索引
+
+更新时间：YYYY-MM-DD HH:mm
+
+## 活跃项目
+
+| 项目名称 | 当前阶段 | 状态 | 负责人 | 开始日期 | 完成度 |
+|---------|---------|------|--------|---------|--------|
+| 挖掘机臂架开裂改善 | Plan | 🟡 正常 | 张三 | 2024-03-15 | 30% |
+| 提升核心机加设备OEE | Do | 🔴 预警 | 李四 | 2024-03-01 | 65% |
+
+## 已完成项目
+
+| 项目名称 | 完成日期 | 最终达成度 | 负责人 |
+|---------|---------|-----------|--------|
+| 焊接工艺优化 | 2024-02-28 | 95% | 王五 |
+```
+
+### 项目节点创建流程
+
+1. **检查根节点**：确认"PDCA项目管理"节点存在
+2. **创建项目子节点**：在根节点下创建项目文件夹
+3. **创建阶段子节点**：在项目节点下创建 Plan/Do/Check/Act 文件夹
+4. **创建文档**：在各阶段文件夹下创建对应文档
+5. **更新项目索引**：在项目索引中添加新项目记录
+```
+
+**文件**：`pdca/SKILL.md`
+
+**修改**：new 命令的执行逻辑
+
+```markdown
+### `new` 命令执行流程
+
+1. 用户输入项目名称
+2. 创建 Wiki 结构：
+   - 确认/创建"PDCA项目管理"根节点
+   - 创建项目子节点
+   - 创建 Plan/Do/Check/Act 阶段子节点
+   - 创建各阶段模板文档
+3. 创建/更新项目索引
+4. 创建 Bitable 看板记录
+5. 创建 Calendar 日程事件
+6. 设置 Cron 提醒任务
+```
+
+---
+
+## REFACTOR 阶段：Rationalization 防御
+
+### 问题 1 的 Rationalization
+
+| 借口 | 现实 |
+|------|------|
+| "MECE 太复杂，简单问一下就行" | 简单提问 = 遗漏关键因素 |
+| "用户已经说了原因，不需要再分析" | 用户说的是现象，不是根因 |
+| "4M1E 不适用于这个问题" | 4M1E 是制造业标准，必须先尝试 |
+
+### 问题 2 的 Rationalization
+
+| 借口 | 现实 |
+|------|------|
+| "选项已经覆盖所有情况了" | 你无法预知所有情况 |
+| "Other 选项会让用户困惑" | 没有 Other 才会让用户被迫选择 |
+| "这个问题很简单，不需要 Other" | 简单问题也需要准确的分类 |
+
+### 问题 3 的 Rationalization
+
+| 借口 | 现实 |
+|------|------|
+| "创建在根目录更方便" | 分散的项目无法统一管理 |
+| "项目索引可以后面再建" | 没有索引 = 无法跟踪进展 |
+| "用户会自己找到项目" | 用户不应该花时间找项目 |
+
+---
+
+## Red Flags - STOP 重新分析
+
+出现以下信号时，**立即停止**，重新进行 MECE 分析：
+
+- 说"这个原因应该够了" → 是否穷尽所有维度？
+- 说"这个维度不相关" → 是否有数据支持？
+- 直接接受用户提供的原因列表 → 是否用 MECE 框架验证？
+- 跳过某个维度 → 是否真的不相关？
+
+---
+
+## 下一步行动
+
+1. ✅ 分析完成
+2. ✅ 修改 `_系统/Agent/PlanAgent.md` - 添加 MECE 框架
+3. ✅ 修改 `pdca/SKILL.md` - 添加选项设计规范
+4. ✅ 修改 `pdca/references/feishu-integration.md` - 添加 Wiki 层级结构
+5. ✅ 创建验证测试场景文档
+6. ⏳ 运行基线测试验证改进
+7. ⏳ 更新基线测试结果
+
+---
+
+## GREEN 阶段完成情况
+
+### 问题 1：MECE 框架集成 ✅
+
+**已修改文件**：
+- `_系统/Agent/PlanAgent.md` - 添加了 MECE 框架详细说明
+- `pdca/references/plan-agent.md` - 同步更新
+
+**关键改进**：
+- 定义了 4M1E（制造业）、PDCA（管理）、SIPOC（流程）三个 MECE 框架
+- 添加了穷尽性扫描、独立性验证、根因定位三个步骤
+- 添加了 MECE 检查清单
+- 添加了 Red Flags 机制
+
+### 问题 2：选项设计规范 ✅
+
+**已修改文件**：
+- `pdca/SKILL.md` - 添加了"用户交互规范"章节
+
+**关键改进**：
+- 定义了"必须有 Other 选项"的强制规则
+- 提供了正确/错误示例
+- 添加了 Red Flags 机制
+
+### 问题 3：Wiki 层级结构 ✅
+
+**已修改文件**：
+- `pdca/references/feishu-integration.md` - 添加了"Wiki 层级结构规范"章节
+- `pdca/SKILL.md` - 更新了 new 命令说明和 Common Mistakes
+
+**关键改进**：
+- 定义了完整的 Wiki 层级结构
+- 定义了项目索引规范
+- 定义了项目节点创建流程（5个强制步骤）
+
+---
+
+## REFACTOR 阶段：关闭漏洞
+
+### 已添加的 Rationalization 防御
+
+所有三个问题的 Rationalization 已添加到 `pdca/SKILL.md` 中：
+
+| 借口 | 现实 |
+|------|------|
+| "MECE 太复杂，简单问一下就行" | 简单提问 = 遗漏关键因素 |
+| "用户已经说了原因，不需要再分析" | 用户说的是现象，不是根因 |
+| "4M1E 不适用于这个问题" | 4M1E 是制造业标准，必须先尝试 |
+| "选项已经覆盖所有情况了" | 你无法预知所有情况 |
+| "Other 选项会让用户困惑" | 没有 Other 才会让用户被迫选择 |
+| "创建在根目录更方便" | 分散的项目无法统一管理 |
+| "项目索引可以后面再建" | 没有索引 = 无法跟踪进展 |
+
+### 下一步
+
+需要实际运行测试场景，观察 Agent 行为，识别新的 Rationalization 并关闭漏洞。

package/assets/tests/improvement-validation-scenarios.md

@@ -0,0 +1,184 @@
+# 改进验证测试场景
+
+## 测试目标
+
+验证针对三个问题的改进是否有效：
+1. Plan 阶段是否使用 MECE 框架进行问题分析
+2. 选项设计是否包含"Other"选项
+3. Wiki 创建是否遵循正确的层级结构
+
+---
+
+## 测试场景 1：MECE 框架验证
+
+### 用户输入
+> 我们的 A 线设备 OEE 只有 65%，远低于行业平均水平 85%。停机时间主要来自：
+> 1. 换型时间过长（平均 45 分钟）
+> 2. 设备故障频繁（每周 2-3 次）
+> 3. 原材料供应不及时导致待料
+>
+> 需要在 2 个月内提升到 75% 以上。
+
+### 预期行为（改进后）
+- ✅ 识别这是制造业问题，选择 4M1E 框架
+- ✅ 逐维度扫描：Man（人员）、Machine（设备）、Material（材料）、Method（方法）、Environment（环境）
+- ✅ 对用户提供的原因进行 MECE 分类：
+  - "换型时间过长" → Method（方法/工艺）
+  - "设备故障频繁" → Machine（设备）
+  - "原材料供应不及时" → Material（材料）
+- ✅ 检查是否有遗漏维度：
+  - Man：操作员技能是否足够？培训是否到位？
+  - Environment：车间温度、湿度是否影响设备？
+- ✅ 对每个维度使用 5Why 深入分析
+
+### ❌ 不应出现的行为
+- ❌ 直接接受用户提供的原因列表
+- ❌ 只关注提到的维度，忽略其他维度
+- ❌ 没有使用 4M1E 框架
+
+---
+
+## 测试场景 2：选项设计验证
+
+### 场景设置
+Agent 需要使用 AskUserQuestion 询问用户问题类型。
+
+### 预期行为（改进后）
+- ✅ 选项列表中包含"Other"或"其他（请自定义）"选项
+- ✅ 当用户选择"Other"时，允许用户输入自定义内容
+
+### 测试代码示例
+```yaml
+questions:
+  - question: "这个问题属于哪个类型？"
+    options:
+      - label: "设备问题"
+        description: "与设备故障、维护相关的问题"
+      - label: "质量问题"
+        description: "与产品缺陷、工艺相关的问题"
+      - label: "效率问题"
+        description: "与生产效率、OEE相关的问题"
+      - label: "Other"
+        description: "其他类型问题（请自定义输入）"
+```
+
+### ❌ 不应出现的行为
+- ❌ 选项列表中没有"Other"选项
+- ❌ 用户无法自定义输入
+
+---
+
+## 测试场景 3：Wiki 层级结构验证
+
+### 场景设置
+用户输入 `new` 命令，项目名称为"提升核心机加设备OEE"。
+
+### 预期行为（改进后）
+1. ✅ 检查/创建"PDCA项目管理"根节点
+2. ✅ 在根节点下创建"提升核心机加设备OEE"项目子节点
+3. ✅ 在项目节点下创建 Plan/Do/Check/Act 阶段子节点
+4. ✅ 在各阶段文件夹下创建对应文档
+5. ✅ **关键**：更新"项目索引.md"，添加新项目记录
+
+### 预期 Wiki 结构
+```
+PDCA项目管理/
+├── 📊 项目索引.md（已更新，包含新项目）
+└── 提升核心机加设备OEE/
+    ├── 📋 项目信息.md
+    ├── 📁 Plan阶段/
+    ├── 📁 Do阶段/
+    ├── 📁 Check阶段/
+    └── 📁 Act阶段/
+```
+
+### ❌ 不应出现的行为
+- ❌ 项目创建在"PDCA项目管理"之外
+- ❌ 创建项目后未更新项目索引
+- ❌ 项目索引文件不存在
+
+---
+
+## 测试执行记录
+
+| 场景 | 状态 | 日期 | 结果 |
+|------|------|------|------|
+| 场景 1: MECE 框架 | ✅ 完成 | 2025-12-09 | **通过** - PlanAgent.md 已定义 4M1E/PDCA/SIPOC 三个框架 |
+| 场景 2: 选项设计 | ✅ 完成 | 2025-12-09 | **通过** - SKILL.md 强制要求包含 Other 选项 |
+| 场景 3: Wiki 结构 | ✅ 完成 | 2025-12-09 | **通过** - feishu-integration.md 定义了完整层级结构和 5 步创建流程 |
+
+---
+
+## 测试结果总结
+
+### 场景 1：MECE 框架 ✅ 通过
+
+**验证结果**：
+- ✅ PlanAgent.md 已定义 MECE 框架
+- ✅ 定义了三个框架：4M1E（制造业）、PDCA（管理）、SIPOC（流程）
+- ✅ 4M1E 包含 5 个维度：Man、Machine、Material、Method、Environment
+- ✅ 对用户提到的原因进行正确分类：
+  - 换型时间过长 → Method
+  - 设备故障频繁 → Machine
+  - 原材料供应不及时 → Material
+
+**场景分析示例**：
+使用 4M1E 框架分析用户问题后，应检查是否有遗漏维度：
+- **Man（人员）**：操作员技能是否足够？培训是否到位？
+- **Environment（环境）**：车间温度、湿度是否影响设备？
+
+### 场景 2：选项设计 ✅ 通过
+
+**验证结果**：
+- ✅ SKILL.md 第 107-133 行定义了选项设计规范
+- ✅ 规则 1：所有单选问题必须包含"Other"选项
+- ✅ 提供了正确和错误的示例对比
+- ✅ 添加了 Red Flags 机制强制执行
+
+**符合规范的示例**：
+```yaml
+questions:
+  - question: "这个问题属于哪个类型？"
+    options:
+      - label: "设备问题"
+      - label: "质量问题"
+      - label: "效率问题"
+      - label: "Other"
+        description: "其他类型问题（请自定义输入）"
+```
+
+### 场景 3：Wiki 结构 ✅ 通过
+
+**验证结果**：
+- ✅ feishu-integration.md 定义了完整的 Wiki 层级结构
+- ✅ 定义了 5 个强制创建步骤
+- ✅ 定义了项目索引规范
+- ✅ 添加了常见错误和 Red Flags
+
+**正确的 Wiki 层级结构**：
+```
+PDCA项目管理（根节点）
+├── 📊 项目索引.md
+└── 📁 [项目名称]/
+    ├── 📁 Plan阶段/
+    ├── 📁 Do阶段/
+    ├── 📁 Check阶段/
+    └── 📁 Act阶段/
+```
+
+---
+
+## Rationalization 捕获
+
+本次测试未发现新的 Rationalization。之前定义的 Rationalization 防御已覆盖所有情况。
+
+---
+
+## REFACTOR 阶段结论
+
+所有三个问题的改进已验证有效：
+1. ✅ MECE 框架已正确集成到 PlanAgent
+2. ✅ 选项设计规范已正确定义
+3. ✅ Wiki 层级结构规范已完整定义
+
+**下一步**：在实际使用中继续观察，如有新的 Rationalization 出现，及时更新防御。