@feng-h/pdca-skill 1.0.0

package/system//345/267/245/345/205/267//346/231/272/350/203/275/345/267/241/346/243/200/351/242/221/347/216/207.md

@@ -0,0 +1,374 @@
+# 智能巡检频率策略
+
+根据项目类型动态调整巡检频率，避免不必要的资源消耗，同时确保项目进展得到有效跟踪。
+
+---
+
+## 概述
+
+**用途**：在项目创建时，根据项目类型和框架自动确定巡检频率，并在项目进行中根据阶段、优先级、进度等动态调整。
+
+**核心价值**：
+- 避免一刀切的固定频率，优化系统资源使用
+- 高优先级项目获得更多关注
+- 关键阶段（Do）和临近截止时加强跟踪
+- 用户可自定义覆盖默认策略
+
+---
+
+## 基线频率（按项目类型）
+
+| 项目类型 | 对应框架 | 默认巡检频率 | Cron表达式 | 时区 | 说明 |
+|---------|---------|-------------|-----------|------|------|
+| 健康/体能 | TREND | 每日 1 次 | `0 8 * * *` | Asia/Shanghai | 运动数据每天更新即可 |
+| 制造业 | 4M1E | 每 8 小时 | `0 */8 * * *` | Asia/Shanghai | 跟随生产班次节奏 |
+| 软件开发 | PPTD | 每日 1 次 | `0 8 * * *` | Asia/Shanghai | 日报制度 |
+| 学习/教育 | COMET | 每周 1 次 | `0 9 * * 1` | Asia/Shanghai | 周报制度（周一上午） |
+| 财务投资 | 3RL-TD | 每日 1 次 | `0 8 * * *` | Asia/Shanghai | 市场交易日 |
+| 销售营销 | 5P | 每周 1 次 | `0 9 * * 1` | Asia/Shanghai | 周会节奏 |
+| 团队协作 | GRCT | 每周 1 次 | `0 9 * * 1` | Asia/Shanghai | 周会节奏 |
+| 客户服务 | 5S | 每日 1 次 | `0 8 * * *` | Asia/Shanghai | 每日服务监控 |
+| 个人效率 | TIME | 每周 1 次 | `0 9 * * 1` | Asia/Shanghai | 周复盘 |
+| 流程/服务 | SIPOC | 每日 1 次 | `0 8 * * *` | Asia/Shanghai | 流程每日监控 |
+| 管理/组织 | 5P2E | 每周 1 次 | `0 9 * * 1` | Asia/Shanghai | 周会节奏 |
+
+**Cron 表达式说明**：
+- `0 8 * * *`：每天 08:00 执行
+- `0 */8 * * *`：每 8 小时执行一次（00:00, 08:00, 16:00）
+- `0 9 * * 1`：每周一 09:00 执行
+
+---
+
+## 动态调整因子
+
+### 1. 阶段因子
+
+| 阶段 | 调整系数 | 说明 |
+|------|---------|------|
+| Plan | 1.0 | 计划期保持基线频率 |
+| Do | 1.5 | 执行期需更密切跟踪 |
+| Check | 1.0 | 检查期恢复基线 |
+| Act | 1.0 | 行动期保持基线 |
+
+### 2. 紧迫度因子
+
+| 优先级 | 调整系数 | 说明 |
+|--------|---------|------|
+| 高 | 2.0 | 高优先级项目加倍频率 |
+| 中 | 1.0 | 中等优先级保持基线 |
+| 低 | 0.5 | 低优先级减半频率 |
+
+### 3. 时间因子
+
+| 剩余时间比例 | 调整系数 | 说明 |
+|-------------|---------|------|
+| > 50% | 1.0 | 正常节奏 |
+| 20% - 50% | 1.5 | 进入冲刺期 |
+| < 20% | 2.0 | 临近截止，加强跟踪 |
+
+### 4. 进度因子
+
+| 项目状态 | 调整系数 | 说明 |
+|---------|---------|------|
+| 正常 | 1.0 | 按计划进行 |
+| 预警 | 1.5 | 进度落后但可控 |
+| 滞后 | 2.0 | 严重滞后，需加强监控 |
+
+### 5. 用户覆盖
+
+用户可设置自定义巡检频率，覆盖系统默认策略。
+
+**优先级**：用户设置 > 动态调整后频率 > 基线频率
+
+---
+
+## 频率计算函数
+
+```python
+from datetime import datetime, timedelta
+from typing import Literal
+
+ProjectType = Literal[
+    "TREND", "4M1E", "PPTD", "COMET", "3RL-TD",
+    "5P", "GRCT", "5S", "TIME", "SIPOC", "5P2E"
+]
+
+Phase = Literal["Plan", "Do", "Check", "Act"]
+Priority = Literal["高", "中", "低"]
+Status = Literal["正常", "预警", "滞后"]
+
+# 基线间隔（秒）
+BASELINE_INTERVALS = {
+    "TREND": 86400,      # 1天
+    "4M1E": 28800,       # 8小时
+    "PPTD": 86400,       # 1天
+    "COMET": 604800,     # 1周
+    "3RL-TD": 86400,     # 1天
+    "5P": 604800,        # 1周
+    "GRCT": 604800,      # 1周
+    "5S": 86400,         # 1天
+    "TIME": 604800,      # 1周
+    "SIPOC": 86400,      # 1天
+    "5P2E": 604800,      # 1周
+}
+
+def calculate_inspection_interval(
+    project_type: ProjectType,
+    phase: Phase,
+    priority: Priority,
+    deadline: datetime,
+    status: Status,
+    user_override: int | None = None
+) -> int:
+    """
+    计算巡检间隔（秒）
+
+    Args:
+        project_type: 项目类型/框架
+        phase: 当前阶段
+        priority: 优先级
+        deadline: 截止日期
+        status: 项目状态
+        user_override: 用户自定义间隔（秒）
+
+    Returns:
+        巡检间隔（秒）
+    """
+    # 用户覆盖优先
+    if user_override is not None:
+        return user_override
+
+    # 获取基线间隔
+    baseline = BASELINE_INTERVALS[project_type]
+
+    # 计算调整系数
+    multiplier = 1.0
+
+    # 阶段因子
+    phase_multiplier = {
+        "Plan": 1.0,
+        "Do": 1.5,
+        "Check": 1.0,
+        "Act": 1.0,
+    }
+    multiplier *= phase_multiplier[phase]
+
+    # 紧迫度因子
+    priority_multiplier = {
+        "高": 2.0,
+        "中": 1.0,
+        "低": 0.5,
+    }
+    multiplier *= priority_multiplier[priority]
+
+    # 时间因子
+    remaining = (deadline - datetime.now()).total_seconds()
+    total_duration = (deadline - datetime.now().replace(hour=0, minute=0)).total_seconds()  # 简化计算
+    if remaining / total_duration < 0.2:
+        multiplier *= 2.0
+    elif remaining / total_duration < 0.5:
+        multiplier *= 1.5
+
+    # 进度因子
+    status_multiplier = {
+        "正常": 1.0,
+        "预警": 1.5,
+        "滞后": 2.0,
+    }
+    multiplier *= status_multiplier[status]
+
+    # 计算最终间隔
+    final_interval = int(baseline / multiplier)
+
+    # 限制最小间隔为 1 小时
+    return max(final_interval, 3600)
+
+
+def interval_to_cron(interval_seconds: int, base_hour: int = 8) -> str:
+    """
+    将间隔转换为 cron 表达式
+
+    Args:
+        interval_seconds: 间隔秒数
+        base_hour: 基础小时（用于每日任务）
+
+    Returns:
+        Cron 表达式
+    """
+    if interval_seconds <= 3600:
+        # 小于等于1小时：每小时执行
+        return "0 * * * *"
+    elif interval_seconds <= 14400:
+        # 小于等于4小时：每4小时执行
+        hours = int(interval_seconds / 3600)
+        return f"0 */{hours} * * *"
+    elif interval_seconds <= 86400:
+        # 小于等于1天：每天执行
+        return f"0 {base_hour} * * *"
+    elif interval_seconds <= 604800:
+        # 小于等于1周：每周执行
+        return f"0 {base_hour} * * 1"  # 周一
+    else:
+        # 超过1周：仍为每周
+        return f"0 {base_hour} * * 1"
+```
+
+---
+
+## Cron 任务管理
+
+### 创建（项目启动时）
+
+```python
+def create_inspection_cron(project_id: str, project_type: ProjectType):
+    """
+    项目创建时，建立巡检 cron 任务
+
+    流程：
+    1. 根据项目类型确定基线频率
+    2. 调用 CronCreate 创建定时任务
+    3. 将 jobId 写入项目元数据
+    """
+    baseline = BASELINE_INTERVALS[project_type]
+    cron_expr = interval_to_cron(baseline)
+
+    job_id = CronCreate(
+        cron=cron_expr,
+        prompt=f"执行 PDCA 项目巡检：{project_id}",
+        recurring=True,
+        durable=True  # 持久化到配置文件
+    )
+
+    # 写入项目配置
+    project_metadata["inspection_job_id"] = job_id
+    project_metadata["baseline_interval"] = baseline
+```
+
+### 更新（频率变化时）
+
+```python
+def update_inspection_cron(project_id: str, new_interval: int):
+    """
+    当动态调整因子变化时，更新巡检频率
+
+    触发条件：
+    - 阶段转换
+    - 优先级变更
+    - 状态变化（正常→预警→滞后）
+    - 用户手动调整
+
+    流程：
+    1. 删除旧的 cron 任务
+    2. 创建新的 cron 任务
+    3. 更新项目元数据
+    """
+    old_job_id = project_metadata.get("inspection_job_id")
+    if old_job_id:
+        CronDelete(id=old_job_id)
+
+    new_cron_expr = interval_to_cron(new_interval)
+    new_job_id = CronCreate(
+        cron=new_cron_expr,
+        prompt=f"执行 PDCA 项目巡检：{project_id}",
+        recurring=True,
+        durable=True
+    )
+
+    project_metadata["inspection_job_id"] = new_job_id
+    project_metadata["current_interval"] = new_interval
+```
+
+### 删除（项目结束时）
+
+```python
+def delete_inspection_cron(project_id: str):
+    """
+    项目结束时，清理所有关联的 cron 任务
+
+    流程：
+    1. 获取项目的所有 cron 任务 ID
+    2. 逐个调用 CronDelete
+    3. 清除项目元数据中的 cron 记录
+    """
+    job_ids = project_metadata.get("cron_job_ids", [])
+
+    for job_id in job_ids:
+        CronDelete(id=job_id)
+
+    project_metadata["cron_job_ids"] = []
+    project_metadata["inspection_job_id"] = None
+```
+
+---
+
+## 频率调整触发点
+
+### 自动触发
+
+| 触发事件 | 检查时机 | 动作 |
+|---------|---------|------|
+| 阶段转换 | 阶段转换确认后 | 重新计算频率并更新 cron |
+| 状态变化 | 每日巡检发现异常 | 状态变为"预警"或"滞后"时更新 |
+| 时间临近 | 每日巡检 | 剩余时间 < 20% 时更新 |
+
+### 手动触发
+
+用户可通过飞书交互卡片手动调整巡检频率：
+
+```
+当前巡检频率：每日 1 次
+基线频率：每日 1 次
+当前调整系数：1.5（Do阶段）
+
+请选择操作：
+[ ] 保持当前频率
+[ ] 恢复基线频率
+[ ] 加倍巡检频率
+[ ] 减半巡检频率
+[ ] 自定义频率：_____
+```
+
+---
+
+## 频率限制
+
+| 限制类型 | 最小值 | 最大值 | 说明 |
+|---------|-------|-------|------|
+| 最小间隔 | 1 小时 | - | 避免过度频繁调用 |
+| 最大间隔 | - | 1 周 | 即使低优先级也保持周检 |
+| 单日最大巡检次数 | - | 24 次 | 避免系统过载 |
+
+---
+
+## 完整示例
+
+### 场景：制造业高优先级项目进入 Do 阶段
+
+**初始状态**：
+- 项目类型：制造业（4M1E）
+- 基线频率：每 8 小时
+- 初始 cron：`0 */8 * * *`
+
+**变化**：
+- 阶段：Plan → Do（×1.5）
+- 优先级：高（×2）
+- 状态：正常（×1）
+
+**计算**：
+```
+基线间隔 = 8 小时 = 28800 秒
+调整系数 = 1.5 × 2 × 1 = 3.0
+最终间隔 = 28800 / 3 = 9600 秒 ≈ 2.67 小时
+向下取整为 2 小时
+新 cron = "0 */2 * * *"
+```
+
+**最终频率**：每 2 小时巡检一次
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更说明 |
+|------|------|---------|
+| v1.0 | 2026-04-04 | 初始版本，定义基线频率和动态调整策略 |

package/system//345/267/245/345/205/267//350/241/250/345/215/225/351/205/215/347/275/256/347/224/237/346/210/220/345/231/250.md

@@ -0,0 +1,221 @@
+# 表单配置生成器
+
+## 概述
+
+**用途**: 根据项目选择的MECE框架，动态生成数据采集表单的字段配置。
+
+**核心价值**:
+- 标准化数据采集流程
+- 自动匹配框架维度与数据字段
+- 支持多场景数据采集需求
+
+---
+
+## 框架维度表单配置
+
+### TREND框架表单字段
+
+适用于健康管理、个人成长、体能训练等场景。
+
+| 维度 | 数据项 | 数据类型 | 采集频率 | 单位 | Bitable类型 |
+|------|--------|---------|---------|------|------------|
+| **Training** | 训练时长 | 数字 | 每次训练后 | 分钟 | 2 |
+| Training | 训练强度 | 单选 | 每次训练后 | - | 3 |
+| Training | 训练类型 | 多选 | 每次训练后 | - | 4 |
+| **Rest** | 睡眠时长 | 数字 | 每日 | 小时 | 2 |
+| Rest | 睡眠质量 | 单选 | 每日 | 1-5分 | 3 |
+| Rest | 休息日标记 | 是/否 | 每周 | - | 3 |
+| **Eating** | 热量摄入 | 数字 | 每日 | kcal | 2 |
+| Eating | 蛋白质 | 数字 | 每日 | g | 2 |
+| Eating | 碳水化合物 | 数字 | 每日 | g | 2 |
+| **Nature** | 体重 | 数字 | 每周 | kg | 2 |
+| Nature | 静息心率 | 数字 | 每周 | bpm | 2 |
+| Nature | VO2max | 数字 | 每月 | - | 2 |
+| **Daily** | 步数 | 数字 | 每日 | 步 | 2 |
+| Daily | 久坐时长 | 数字 | 每日 | 分钟 | 2 |
+
+**训练强度选项**: 低/中/高
+**训练类型选项**: 有氧/力量/柔韧/平衡/综合
+
+### 4M1E框架表单字段
+
+适用于生产管理、质量控制、流程优化等场景。
+
+| 维度 | 数据项 | 数据类型 | 采集频率 | 单位 | Bitable类型 |
+|------|--------|---------|---------|------|------------|
+| **Man** | 出勤率 | 数字 | 每日 | % | 2 |
+| Man | 培训完成数 | 数字 | 每周 | 人次 | 2 |
+| **Machine** | 设备OEE | 数字 | 每班次 | % | 2 |
+| Machine | 停机时长 | 数字 | 每班次 | 分钟 | 2 |
+| **Material** | 来料不良率 | 数字 | 每批 | % | 2 |
+| Material | 库存周转天数 | 数字 | 每周 | 天 | 2 |
+| **Method** | SOP执行率 | 数字 | 每周 | % | 2 |
+| **Environment** | 温度 | 数字 | 每日 | °C | 2 |
+| Environment | 湿度 | 数字 | 每日 | % | 2 |
+
+---
+
+## 字段类型映射
+
+| 数据类型 | Bitable type | 说明 |
+|---------|-------------|------|
+| 数字 | 2 | 数值类型，支持小数 |
+| 单选 | 3 | 预定义选项，单选 |
+| 多选 | 4 | 预定义选项，多选 |
+| 是/否 | 3 | 特殊单选：是/否 |
+| 文本 | 1 | 字符串类型 |
+| 日期 | 5 | 日期时间类型 |
+
+**Bitable字段创建API参数**:
+```json
+{
+  "field_type": 2,
+  "property": {
+    "formatter": "0.00",
+    "default_value": "0"
+  }
+}
+```
+
+---
+
+## 表单创建流程
+
+### 1. 项目创建阶段
+
+```
+项目创建 → 选择MECE框架 → 获取表单配置 → 创建Bitable字段
+```
+
+**步骤**:
+1. 用户创建项目时选择框架（TREND/4M1E/自定义）
+2. PlanAgent根据框架获取对应的字段配置
+3. 在Bitable的`data_records`表中创建字段
+4. 生成表单分享链接
+
+### 2. 字段创建示例
+
+```javascript
+// 创建训练时长字段
+await bitable.appTableField.create({
+  table_id: "data_records",
+  field_type: 2,
+  property: {
+    formatter: "0",
+    default_value: "0"
+  }
+})
+```
+
+### 3. 表单分享
+
+使用Bitable的表单视图功能生成分享链接：
+```javascript
+// 获取表单视图
+const formView = await bitable.appTableViews.create({
+  table_id: "data_records",
+  view_type: "form"
+})
+
+// 生成分享链接
+const shareUrl = `https://example.feishu.cn/base/${app_token}/form?view=${formView.view_id}`
+```
+
+---
+
+## 数据写入流程
+
+### 用户填写表单
+
+```
+用户填写表单 → 数据写入data_records表 → Cron检测新数据 → 仪表板更新
+```
+
+### 数据流
+
+1. **表单提交**: 用户通过表单填写数据
+2. **数据写入**: 数据自动写入`data_records`表
+3. **自动巡检**: Cron任务检测到新数据
+4. **仪表板更新**: 触发仪表板重新计算和渲染
+
+### Cron检测逻辑
+
+```javascript
+// 检测新数据
+const lastCheck = await getLastCheckTimestamp()
+const newRecords = await bitable.appTableRecord.list({
+  table_id: "data_records",
+  filter: {
+    conditions: [{
+      field_name: "created_time",
+      operator: "isGreater",
+      value: [lastCheck]
+    }]
+  }
+})
+
+if (newRecords.length > 0) {
+  await updateDashboard(project_id)
+}
+```
+
+---
+
+## 扩展自定义框架
+
+### 自定义字段定义
+
+当使用自定义MECE框架时，需要提供：
+
+```json
+{
+  "framework_name": "自定义框架名称",
+  "dimensions": [
+    {
+      "name": "维度名称",
+      "fields": [
+        {
+          "name": "数据项名称",
+          "type": "数字|单选|多选|是/否|文本|日期",
+          "frequency": "采集频率",
+          "unit": "单位"
+        }
+      ]
+    }
+  ]
+}
+```
+
+### 字段验证规则
+
+- 所有字段必须有明确的`name`和`type`
+- 数值类型必须指定`unit`
+- 单选/多选类型必须提供`options`
+- 所有字段必须指定`frequency`
+
+---
+
+## 与其他组件集成
+
+### 与仪表板生成器集成
+
+表单字段与仪表板维度直接对应：
+- 表单字段 → 仪表板数据源
+- 采集频率 → 刷新频率建议
+- 数据类型 → 可视化图表类型
+
+### 与任务自动生成器集成
+
+基于采集频率自动生成数据采集任务：
+- 每日字段 → 创建每日提醒任务
+- 每周字段 → 创建周报任务
+- 每月字段 → 创建月度汇总任务
+
+---
+
+## 注意事项
+
+1. **字段不可变性**: 表单创建后，字段类型不可修改
+2. **数据完整性**: 必填字段需在创建时标记
+3. **并发控制**: Bitable不支持并发写入，需串行调用
+4. **权限管理**: 表单分享链接需设置适当的访问权限