@feng-h/pdca-skill 1.0.0

package/assets/references/exception-handling.md

@@ -0,0 +1,35 @@
+# 异常处理指南
+
+## 异常分级
+| 级别 | 定义 | 处理时限 | 权限 |
+|------|------|---------|------|
+| L1轻微 | 影响局部 | 24h | 阶段负责人 |
+| L2中等 | 影响阶段 | 3天 | 项目负责人 |
+| L3严重 | 影响整体 | 1周 | 决策层 |
+| L4危机 | 威胁项目 | 立即 | 最高层 |
+
+## 快速响应
+1. 立即评估（5min内）：级别、影响、初步原因
+2. 立即报告（15min内）：通知上级、填写报告、启动响应
+3. 持续跟踪：更新进展、调整措施、记录结果
+
+## 常见异常处理
+
+### 进度延误
+- <10%：加速任务、优化流程
+- 10-30%：重新排优先级、申请资源
+- >30%：重新评估可行性、考虑回退
+
+### 质量问题
+- 局部：立即整改、加强控制
+- 系统性：暂停工作、全面检查、流程重构
+
+### 需求变更
+- 小范围：评估影响、调整计划
+- 重大：重新评估项目、可能回退Plan
+
+## 回退触发（必须回退）
+- 目标无法达成
+- 方案根本错误
+- 关键资源永久缺失
+- 外部环境剧变

package/assets/references/feishu-integration.md

@@ -0,0 +1,494 @@
+# 飞书工具链集成指南
+
+PDCA skill 与飞书全工具链的集成方式，实现文档存储、知识沉淀、进度可视化、任务管理、时间管理的完整闭环。
+
+## 工具链概览
+
+```
+飞书 Wiki（知识库 — 容器）
+  ├── PDCA项目管理（根节点）
+  │   ├── 📊 项目索引.md（所有项目状态一览）
+  │   ├── 📁 [项目 A]/ → 放置 Bitable 应用
+  │   ├── 📁 [项目 B]/ → 放置 Bitable 应用
+  │   └── 📚 经验库（已完成项目沉淀）
+  │
+  └── 每个项目是一个 Bitable 应用，内含：
+        ├── 📊 数据表（4张：项目主表、任务、数据记录、执行日志）
+        ├── 📋 收集表（按框架维度配置）
+        ├── 📈 仪表盘（实时可视化）
+        ├── ⚙️ 工作流（自动化巡检）
+        ├── 📄 文档视图（Plan/Do/Check/Act 各阶段文档）
+        └── 📁 文件夹（按阶段组织文档）
+
+飞书 Task（任务）
+  ├── 各阶段具体待办事项
+  ├── 负责人分配
+  └── 截止日期追踪
+
+飞书 Calendar（日历）
+  ├── 阶段里程碑时间节点
+  ├── 阶段截止日
+  └── 评审/复盘会议
+
+AI Agent（OpenClaw）
+  ├── 读写 Bitable 数据表和文档视图
+  ├── 通过工作流触发 API 调用
+  ├── 主动判断进展
+  └── 自动生成报告
+```
+
+## 1. 飞书 Wiki（知识库）— 容器
+
+### Wiki 层级结构规范
+
+#### 根节点：PDCA项目管理
+
+所有 PDCA 项目必须创建在 **"PDCA项目管理"** 根节点下。Wiki 作为容器，项目以 Bitable 应用的形式放置在此。
+
+#### 完整层级结构
+
+```
+飞书 Wiki 知识空间
+└── PDCA项目管理（根节点，space_node_id: 需在 SKILL.md 中配置）
+    ├── 📊 项目索引.md（跟踪展示所有项目进展）
+    │   └── 内容：项目名称、当前阶段、状态、负责人、开始日期、完成度、Bitable链接
+    ├── 📚 经验库/（已完成项目沉淀）
+    │   ├── 设备类经验.md
+    │   ├── 质量类经验.md
+    │   └── 效率类经验.md
+    │
+    └── 📁 [项目名称]/（子节点，每个项目一个）
+        └── 📊 [项目名称] PDCA（Bitable 应用）
+            ├── 数据表（4张）
+            ├── 收集表（按框架维度）
+            ├── 仪表盘
+            ├── 工作流
+            ├── 📁 Plan阶段/（文档视图）
+            ├── 📁 Do阶段/（文档视图）
+            ├── 📁 Check阶段/（文档视图）
+            └── 📁 Act阶段/（文档视图）
+```
+
+> **关键变更**: 项目的各阶段文档（问题分析、目标设定等）不再创建为 Wiki 独立文档，而是放在 Bitable 应用的**文档视图**中。Wiki 中仅保留项目索引和经验库。
+
+#### 项目索引规范
+
+**文件名**：`📊 项目索引.md`
+**位置**：PDCA项目管理/项目索引.md
+**内容格式**：
+
+```markdown
+# PDCA 项目索引
+
+更新时间：YYYY-MM-DD HH:mm
+
+## 活跃项目
+
+| 项目名称 | 当前阶段 | 状态 | 负责人 | 开始日期 | 完成度 | Wiki链接 |
+|---------|---------|------|--------|---------|--------|----------|
+| 挖掘机臂架开裂改善 | Plan | 🟡 正常 | 张三 | 2024-03-15 | 30% | [查看](wiki_url) |
+| 提升核心机加设备OEE | Do | 🔴 预警 | 李四 | 2024-03-01 | 65% | [查看](wiki_url) |
+
+## 已完成项目
+
+| 项目名称 | 完成日期 | 最终达成度 | 负责人 | Wiki链接 |
+|---------|---------|-----------|--------|----------|
+| 焊接工艺优化 | 2024-02-28 | 95% | 王五 | [查看](wiki_url) |
+```
+
+#### 项目节点创建流程
+
+**⚠️ 核心要点**：使用 `feishu_create_doc` 的 `wiki_node` 或 `wiki_space` 参数创建 Wiki 文档，而不是 `feishu_wiki_space_node.create`。
+
+**步骤 1：在知识空间根目录创建项目索引**
+```bash
+# 使用 wiki_space 参数直接在知识空间根目录创建
+feishu_create_doc --wiki_space "<space_id>" --title "项目索引.md" --content "# PDCA 项目索引\n..."
+```
+
+**步骤 2：创建项目文档（使用 wiki_node 参数）**
+```bash
+# 首先获取知识空间列表，找到 space_id
+feishu_wiki_space_list
+
+# 创建项目下的文档，使用 wiki_node 参数指定父节点
+feishu_create_doc --wiki_node "<parent_node_token>" --title "项目信息.md" --content "..."
+```
+
+**步骤 3：创建各阶段文档**
+```bash
+# Plan 阶段文档
+feishu_create_doc --wiki_node "<parent_node_token>" --title "Plan阶段/问题分析.md" --content "..."
+
+# Do 阶段文档
+feishu_create_doc --wiki_node "<parent_node_token>" --title "Do阶段/执行日志.md" --content "..."
+```
+
+---
+
+### ⚠️ Wiki 创建错误处理规范
+
+**绝对禁止的行为**：
+- ❌ **禁止**因为 Wiki 创建失败就在其他地方（如根目录、桌面等）创建文件
+- ❌ **禁止**跳过 Wiki 创建，直接创建本地文件
+- ❌ **禁止**使用本地文件系统作为 fallback
+
+**正确的错误处理**：
+1. **第一次失败**：检查参数是否正确（space_id、wiki_node）
+2. **第二次失败**：检查权限是否足够
+3. **第三次失败**：**停止流程**，向用户报告具体错误信息
+
+**错误报告模板**：
+```
+⚠️ Wiki 文档创建失败
+
+错误信息：[具体的 API 错误信息]
+尝试的操作：创建文档 [文档名称]
+
+请检查：
+1. space_id 是否正确
+2. wiki_node (parent_node_token) 是否正确
+3. 是否有足够的权限
+
+流程已停止，没有在任何其他位置创建文件。
+```
+
+---
+
+### Wiki 创建详细调用示例
+
+**方式 1：在知识空间根目录创建**
+```json
+{
+  "wiki_space": "your_space_id",
+  "title": "项目索引.md",
+  "content": "# PDCA 项目索引\n..."
+}
+```
+
+**方式 2：在指定节点下创建**
+```json
+{
+  "wiki_node": "parent_node_token",
+  "title": "项目信息.md",
+  "content": "# 项目信息\n..."
+}
+```
+
+**方式 3：创建带文件夹结构的文档**
+```json
+{
+  "wiki_node": "parent_node_token",
+  "title": "Plan阶段/问题分析.md",
+  "content": "# 问题分析\n..."
+}
+```
+
+**注意**：`title` 中使用 `/` 会自动创建文件夹结构。
+
+### 创建项目时
+使用 `feishu_create_doc` 的 `wiki_space` 或 `wiki_node` 参数创建 Wiki 文档：
+- 项目索引：使用 `wiki_space` 参数在知识空间根目录创建
+- 项目文档：使用 `wiki_node` 参数在指定父节点下创建
+- 阶段文档：在 `title` 中使用 `/` 创建文件夹结构（如 `Plan阶段/问题分析.md`）
+
+### AI 主动操作
+- **读取**：用 `feishu_fetch_doc` 读取文档内容，检查必填项完成度
+- **更新**：用 `feishu_update_doc` 更新文档内容
+- **创建**：用 `feishu_create_doc` + `wiki_node`/`wiki_space` 创建文档
+
+### 知识沉淀
+项目结束后：
+1. 将「知识总结.md」的关键内容提取到经验库文档
+2. 经验库按类别组织（设备类、质量类、效率类、成本类）
+3. 经验库中标注适用场景和关键指标
+4. 新项目启动时，AI 主动检索经验库，推荐可复用的经验
+
+### Wiki 节点结构
+```
+PDCA知识空间（space_id 已在 SKILL.md 中记录）
+├── 项目名称（wiki 节点）
+│   ├── 📋 项目信息.md
+│   ├── 📁 Plan阶段/
+│   ├── 📁 Do阶段/
+│   ├── 📁 Check阶段/
+│   └── 📁 Act阶段/
+├── 📊 项目索引.md
+└── 📚 经验库/
+    ├── 设备类经验.md
+    ├── 质量类经验.md
+    └── 效率类经验.md
+```
+
+## 2. 飞书 Bitable（多维表格）— 可视化看板
+
+### Bitable 原生架构（一个项目一个应用）
+
+每个 PDCA 项目创建独立的 Bitable 应用，包含：
+- **数据表**：项目主表、任务数据表、数据记录表、执行日志表
+  - 详细表结构见：`_系统/工具/Bitable表结构定义.md`
+- **收集表**：按 MECE 框架维度配置，数据提交自动写入数据记录表
+  - 配置见：`_系统/工具/收集表配置指南.md`
+- **仪表盘**：核心指标、维度进度、任务列表、数据趋势、执行日志、AI 洞察
+  - 组件配置见：`_系统/工具/仪表盘组件配置.md`
+- **工作流**：定时触发和数据事件触发，调用 OpenClow API 实现智能巡检
+  - 配置见：`_系统/工具/工作流自动化配置.md`
+
+### 完整表结构（旧架构参考）
+
+### 创建项目时
+用 `feishu_bitable_app.create` 创建多维表格，再用 `feishu_bitable_app_table.create` 创建数据表并定义字段。
+
+**字段设计**（创建时通过 `fields` 参数一次性定义）：
+
+| 字段名 | type | 说明 | 值格式 |
+|--------|------|------|--------|
+| 项目名称 | 1（文本） | 项目标题 | 字符串 |
+| 当前阶段 | 3（单选） | Plan/Do/Check/Act/已完成 | 字符串，property 中定义 options |
+| 状态 | 3（单选） | 正常/预警/超时/已完成 | 字符串，property 中定义 options |
+| 负责人 | 11（人员） | 项目负责人 | `[{id: "ou_xxx"}]` |
+| 开始日期 | 5（日期） | 项目启动日期 | 毫秒时间戳 |
+| 阶段截止日 | 5（日期） | 当前阶段计划结束日期 | 毫秒时间戳 |
+| 完成度 | 2（数字） | 0-100 | 数字 |
+| 问题类型 | 3（单选） | 设备/质量/效率/成本/流程/管理 | 字符串 |
+| 优先级 | 3（单选） | 高/中/低 | 字符串 |
+| 知识库链接 | 15（超链接） | 飞书 Wiki 项目节点链接 | `{link: "url", text: "标题"}` |
+
+### 完整表结构
+
+详细的 4 张核心表结构定义，见 `_系统/工具/Bitable表结构定义.md`。
+
+### 表关系
+
+```
+项目主表
+    ├── 1:N → 任务表
+    ├── 1:N → 数据收集记录表
+    └── 1:N → 执行日志表
+```
+
+> ⚠️ **重要坑位**（详见 `feishu-bitable` skill）：
+> - 人员字段值必须是 `[{id: "ou_xxx"}]`，不能传字符串
+> - 日期字段值是**毫秒时间戳**，不是秒
+> - 单选字段值是**字符串**，不是数组
+> - 超链接字段(type=15) 创建时**不要传 property 参数**，否则报错
+> - 创建数据表前先查字段类型：`feishu_bitable_app_table_field.list`
+> - 默认表有空行，插入前先删除：`list` + `batch_delete`
+> - 同一表不支持并发写，串行调用 + 延迟 0.5-1 秒
+
+### AI 主动操作
+- **创建项目**：`feishu_bitable_app_table_record.create`
+- **阶段转换**：`feishu_bitable_app_table_record.update` 更新「当前阶段」「阶段截止日」
+- **自动巡检**：
+    1. **搜索待巡检记录**：使用 `feishu_bitable_app_table_record.search` 查找 `状态` 不等于 "已完成" 且 `项目名称` 匹配的项目。
+    2. **计算完成度**：AI 读取对应的 Wiki 文档和 Sheet 数据，根据阶段交付物清单计算 `完成度`（0-100）。
+    3. **状态判定**：
+        - 正常：当前日期 < 阶段截止日 且 进度符合预期。
+        - 预警：当前日期接近阶段截止日（如剩余 20% 时间）且 进度滞后。
+        - 超时：当前日期 > 阶段截止日。
+    4. **更新记录**：调用 `feishu_bitable_app_table_record.update` 更新「完成度」和「状态」字段。
+- ⚠️ **「剩余天数」不由公式计算**（Bitable 不支持公式字段），由 AI 每次巡检时计算后写入
+
+## 3. 飞书消息卡片（Interactive Cards）
+
+用于推送预警信息和交互确认。
+
+### 卡片 JSON 模板 (feishu-card)
+
+```json
+{
+  "config": {
+    "wide_screen_mode": true
+  },
+  "header": {
+    "title": {
+      "tag": "plain_text",
+      "content": "⚠️ PDCA 项目预警"
+    },
+    "template": "orange"
+  },
+  "elements": [
+    {
+      "tag": "div",
+      "text": {
+        "tag": "lark_md",
+        "content": "**项目名称**：${project_name}\n**当前阶段**：${current_phase}"
+      }
+    },
+    {
+      "tag": "div",
+      "fields": [
+        {
+          "is_short": false,
+          "text": {
+            "tag": "lark_md",
+            "content": "**预警原因**：\n${warning_reason}"
+          }
+        },
+        {
+          "is_short": true,
+          "text": {
+            "tag": "lark_md",
+            "content": "**当前值**：\n${current_value}"
+          }
+        },
+        {
+          "is_short": true,
+          "text": {
+            "tag": "lark_md",
+            "content": "**期望值**：\n${expected_value}"
+          }
+        }
+      ]
+    },
+    {
+      "tag": "hr"
+    },
+    {
+      "tag": "action",
+      "actions": [
+        {
+          "tag": "button",
+          "text": {
+            "tag": "plain_text",
+            "content": "确认/修改进度"
+          },
+          "type": "primary",
+          "multi_url": {
+            "url": "${wiki_url}",
+            "pc_url": "",
+            "android_url": "",
+            "ios_url": ""
+          }
+        },
+        {
+          "tag": "button",
+          "text": {
+            "tag": "plain_text",
+            "content": "查看项目 Wiki"
+          },
+          "type": "default",
+          "multi_url": {
+            "url": "${wiki_url}",
+            "pc_url": "",
+            "android_url": "",
+            "ios_url": ""
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+## 4. 飞书 Task（任务）— 阶段待办管理
+
+### 创建项目时
+根据执行计划，用 `feishu_task_task.create` 创建飞书任务：
+- `summary`：任务编号 + 任务描述（如「T001 收集设备停机数据」）
+- `members`：指定负责人（assignee）和关注人（follower）
+- `due`：按执行计划设定截止时间
+- `description`：包含任务要求、交付物标准
+
+### AI 主动操作
+- **创建**：`feishu_task_task.create`
+- **检查**：`feishu_task_task.list` 查询任务状态
+- **更新**：`feishu_task_task.patch` 标记完成或调整截止日期
+
+### 注意
+- Task 工具需要在 `openclaw.json` 中保持启用：`tools.deny` 中不包含 task 相关工具名
+- 当前所有 task 工具已可用（`feishu_task_task`、`feishu_task_tasklist`、`feishu_task_comment`、`feishu_task_subtask`）
+
+## 4. 飞书 Calendar（日历）— 时间节点管理
+
+### 创建项目时
+用 `feishu_calendar_event.create` 为关键时间节点创建日历事件。
+
+> ⚠️ **必填参数**：
+> - `summary`（标题）、`start_time`、`end_time` 是最小必填
+> - **`user_open_id` 强烈建议传入**（从 SenderId 获取 `ou_xxx`），确保用户作为参会人能看到日程
+> - 时间格式：ISO 8601 带时区，如 `2026-04-10T18:00:00+08:00`
+
+为以下时间节点创建事件：
+- 各阶段截止日（如「PDCA-xxx Plan阶段截止」）
+- 里程碑日期（如「PDCA-xxx 数据收集完成」）
+- 评审会议（如「PDCA-xxx Check阶段评审会」）
+
+### AI 主动操作
+- **创建**：`feishu_calendar_event.create`
+- **检查冲突**：创建新事件前用 `feishu_calendar_freebusy.list` 检查忙闲
+- **查找**：`feishu_calendar_event.search` 按关键词查找 PDCA 相关日程
+- **提醒**：事件开始前 1 天，通过 cron 发送提醒
+
+## 5. 飞书 Sheet（电子表格）— 数据分析
+
+### Plan 阶段
+用 `feishu_sheet.create` 创建数据收集表格，通过 `headers` + `data` 一次性创建：
+```json
+{
+  "action": "create",
+  "title": "PDCA-xxx 数据收集表",
+  "headers": ["指标名称", "单位", "基准值", "目标值", "收集频率", "负责人"],
+  "data": [["设备OEE", "%", 65, 85, "每日", "张三"]]
+}
+```
+
+### Do 阶段
+用户在 Sheet 中记录执行数据，AI 定期用 `feishu_sheet.read` 读取：
+- 检查数据是否按计划填写
+- 用 `feishu_sheet.append` 追加新数据行
+
+### Check 阶段
+AI 用 `feishu_sheet.read` 读取数据，生成效果分析：
+- 改善前 vs 改善后 对比
+- 计算达成率
+- 可用 `feishu_sheet.export` 导出为 xlsx 做进一步分析
+
+## 6. 数据流闭环
+
+```
+用户描述问题
+    ↓
+AI 评估 → 用户确认
+    ↓
+自动创建：
+  Wiki（项目文档+模板）— feishu_create_doc with wiki_node/wiki_space
+  + Bitable（看板记录）— feishu_bitable_app.create + feishu_bitable_app_table.create
+  + Calendar（关键时间节点）— feishu_calendar_event.create
+  + Task（具体待办）— feishu_task_task.create
+  + Sheet（数据收集模板）— feishu_sheet.create
+  + Cron（定时提醒）— cron add
+    ↓
+用户在飞书中工作
+  ├── 填写 Wiki 文档
+  ├── 在 Sheet 中录入数据
+  ├── 完成 Task 中的待办
+  └── 查看 Bitable 看板
+    ↓
+AI 主动巡检（Cron + Heartbeat）
+  ├── feishu_fetch_doc → 判断文档完成度
+  ├── feishu_bitable_app_table_record.update → 更新状态
+  ├── feishu_task_task.list → 检查待办完成
+  └── feishu_sheet.read → 数据趋势分析
+    ↓
+AI 推送提醒到飞书对话
+    ↓
+用户确认决策（阶段转换/项目结束）
+    ↓
+AI 更新所有工具 + 更新 Cron
+    ↓
+项目结束 → 经验沉淀到 Wiki 经验库
+    ↓
+清理 Cron + Bitable 标记完成
+```
+
+## 实施优先级
+
+| 优先级 | 工具 | 价值 | 状态 |
+|--------|------|------|------|
+| P0 | Wiki + Bitable 工作流 | Bitable 原生架构，项目主存储和主动驱动 | ✅ 已实现 |
+| P1 | Bitable 收集表 + 仪表盘 | 数据录入和可视化 | ✅ 已实现 |
+| P2 | OpenClow API 集成 | AI 智能巡检 | ✅ 已实现 |
+| P3 | Calendar | 时间节点管理 | 待实施 |
+| P4 | Task | 待办管理 | 待实施 |
+| P5 | Sheet | 数据分析 | 待实施 |

package/assets/references/manufacturing-templates.md

@@ -0,0 +1,31 @@
+# 制造与质量项目模板库
+
+## 设备OEE提升
+- **改善方向**：六大损失分析（故障/换型/速度/不良/启动/调整）
+- **时间规划**：Plan 7-15天 | Do 30-60天 | Check 7天 | Act 15天
+- **关键指标**：可用率、性能率、合格率
+
+## 产品不良率降低
+- **分析工具**：柏拉图、鱼骨图、5Why、FMEA
+- **改善方向**：人(技能/意识)、机(精度/维护)、料(质量/供应)、法(工艺/标准)、环(环境/5S)
+
+## 生产效率改善
+- **改善重点**：产线平衡、作业标准化、自动化、物流优化
+- **效果指标**：人均效率、产出增加、交付周期、在制品
+
+## 客户投诉率降低
+- **流程**：投诉分类→根因分析→纠正预防→验证→回访
+- **关键工具**：8D报告、快速响应、横向展开
+
+## 过程能力提升（Cpk）
+- **目标**：Cpk<1.33需改善 | ≥1.33基本满足 | ≥1.67良好 | ≥2.0优秀
+- **步骤**：稳定性确认→数据收集→中心值改善→散差减少→效果验证
+
+## 成本控制
+- **分析方向**：直接材料、直接人工、制造费用、质量成本
+- **策略**：VA/VE分析、标准化、批量采购、效率提升
+
+## 通用要素
+- **团队**：部门主管(负责人) + 工程师(核心) + 质量/生产/设备/采购(支持)
+- **数据**：基线(改善前3月) + 目标 + 过程(每日/每周) + 验证(改善后1月)
+- **成功要素**：高层支持、数据驱动、全员参与、持续改进、标准化

package/assets/references/plan-agent.md

@@ -0,0 +1,52 @@
+# Plan Agent — 规划阶段指南
+
+## 工作流程
+
+### 1. 问题理解
+- 收集问题信息（表现、背景、影响、已尝试方案）
+- 问题分类：技术/管理/流程/健康/效率 | 紧急度 高/中/低 | 复杂度 简/中/复
+- **根本原因分析（MECE 框架）**：
+  - **制造业问题**：使用 **4M1E 框架**（Man/Machine/Material/Method/Environment）
+  - **个人健康/体能提升问题**：使用 **TREND 框架**（Training/Rest/Eating/Nature/Daily）
+  - **管理问题**：使用 **5P2E 框架**（Plan/People/Process/Performance/Power/External/Environment）
+  - **流程问题**：使用 **SIPOC 框架**（Supplier/Input/Process/Output/Customer）
+  - **穷尽性扫描**：逐维度检查，确保不遗漏
+  - **独立性验证**：确保各分类之间不重叠
+  - **根因定位**：使用 **5Why** 深入各维度的根本原因
+  - **MECE 检查清单**：所有维度覆盖、无重叠、每维度深入分析、根因可改变
+
+### 2. SMART目标设定
+- **S**pecific：明确要达成的结果
+- **M**easurable：设定量化指标
+- **A**chievable：考虑资源约束
+- **R**elevant：与整体目标一致
+- **T**ime-bound：设定完成时间
+- 分解为里程碑，设定检查节点
+
+### 3. 方案设计
+- 头脑风暴多个方案
+- 评估：可行性、效果预期、成本效益、实施风险
+- 选择最优方案，准备备选方案
+
+### 4. 执行计划
+- 任务分解 + 依赖关系
+- 人力资源、物质资源、财务资源分配
+- 进度检查点、汇报机制、异常处理流程
+
+### 5. 自动化校验 (Validator)
+- **SMART 校验**：参照 `_系统/规范/Validators/smart.md` 检查目标量化程度。
+- **逻辑校验**：参照 `_系统/规范/Validators/logic.md` 检查措施是否覆盖根因（根因-措施映射）。
+- **升级机制**：对于 2 次修改仍不合格或存在严重逻辑缺失的计划，触发 `[⚠️ 升级上报]` 逻辑。
+
+## 完成检查
+- [ ] 问题分析文档完成
+- [ ] SMART目标设定（通过 `smart.md` 校验）
+- [ ] 解决方案（通过 `logic.md` 逻辑闭环校验）
+- [ ] 执行计划文档完成
+- [ ] 资源保障确认
+
+## 输出文件
+- `Plan阶段/问题分析.md`
+- `Plan阶段/目标设定.md` (含校验通过证明)
+- `Plan阶段/解决方案.md` (含根因-措施映射表)
+- `Plan阶段/执行计划.md`

package/assets/references/transition-checklist.md

@@ -0,0 +1,41 @@
+# 阶段转换检查表
+
+## Plan → Do
+- [ ] 问题分析完成（定义清晰、根因已识别、影响已评估）
+- [ ] 目标设定完成（SMART原则、量化指标、里程碑）
+- [ ] 解决方案完成（可行性验证、备选方案准备）
+- [ ] 执行计划完成（任务分解、时间节点、责任人）
+- [ ] 资源保障确认（人力、物质、预算）
+- [ ] 风险已识别并有应对措施
+**决策**：全部满足→转换 | 部分满足→延长Plan | 关键缺失→重新评估
+
+## Do → Check
+- [ ] 计划任务100%完成，交付物已验收
+- [ ] 过程记录完整，执行日志已记录
+- [ ] 数据收集完成，关键指标已收集
+- [ ] 质量标准已达标
+**决策**：执行完成且数据完整→转换 | 未完成→延长Do | 计划问题→回退Plan
+
+## Check → Act
+- [ ] 数据分析完成（达成度、差异、趋势）
+- [ ] 效果评估完成（定量+定性+成本效益）
+- [ ] 问题诊断明确（主要问题+根因）
+- [ ] 改进建议已提出（具体措施+优先级）
+**决策**：分析完整→转换 | 数据不足→回退Do | 目标方案问题→回退Plan
+
+## Act → 结束/新循环
+- [ ] 行动决策已制定（基于分析、风险可控）
+- [ ] 行动方案已实施（效果已确认）
+- [ ] 知识沉淀完成（经验总结、最佳实践）
+- [ ] 原问题已解决
+**决策**：完全解决→结束 | 部分解决→新循环 | 外部因素→暂停
+
+## 回退决策
+| 回退路径 | 严重度 | 触发条件 |
+|---------|-------|---------|
+| Do→Plan | 严重 | 计划不可行、外部剧变 |
+| Check→Do | 中等 | 数据不充分、执行遗漏 |
+| Check→Plan | 严重 | 目标/方案根本问题 |
+| Act→前序 | 视情况 | 实施遇根本障碍 |
+
+每次转换必须记录：转换时间、方向、依据、时间使用情况、遗留问题。