@feng-h/pdca-skill 1.0.5 → 1.0.7

package/.claude/settings.local.json

@@ -0,0 +1,22 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(gh api:*)",
+      "WebSearch",
+      "Bash(git show:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(curl -sL https://api.github.com/repos/larksuite/openclaw-lark/contents/skills/feishu-bitable)",
+      "Bash(python3 -c \"import json,sys; data=json.load\\(sys.stdin\\); [print\\(f'{x[\\\\\"name\\\\\"]} \\({x[\\\\\"type\\\\\"]}\\)'\\) for x in data]\")",
+      "Bash(gh auth:*)",
+      "Bash(npm publish:*)",
+      "Bash(npm run:*)",
+      "Bash(gh run:*)",
+      "Bash(npm config:*)",
+      "Bash(npm view:*)",
+      "Bash(npm version:*)"
+    ]
+  }
+}

package/.claude/skills/pdca.md

@@ -0,0 +1,126 @@
+---
+name: pdca
+description: |
+  Use when initiating or managing PDCA cycle projects, manufacturing quality improvement (OEE, defect rates, efficiency, cost reduction),
+  or Feishu/Lark document inspection with SMART validation is needed. Trigger for project transitions (new/ongoing/achieve) or proactive AI alerts.
+---
+
+# PDCA 项目管理系统
+
+## 概述
+
+基于 PDCA 循环的结构化问题解决系统，由 AI 驱动实现主动巡检、SMART 目标校验和飞书工具链集成。
+
+## 触发条件
+
+**使用此技能当用户：**
+- 提到 "启动 PDCA 项目"、"新建项目"、"立项"
+- 需要进行结构化问题分析（5W1H、鱼骨图、5Why）
+- 需要量化目标和可衡量指标
+- 提到 "OEE 提升"、"不良率降低"、"效率改善"
+- 需要主动进度监控和预警
+- 提到 "飞书"、"Bitable"、"Wiki" 集成
+
+## 核心工作流
+
+### 1. 评估与启动 (new)
+
+**引导问题：**
+1. "你面临的问题是什么？请简要描述。"
+2. "这个问题属于哪个类型？"
+   - 设备问题
+   - 质量问题
+   - 效率问题
+   - 成本问题
+   - 安全问题
+   - Other (请自定义)
+
+**然后：**
+- 使用 4M1E 框架进行初步分析（Man、Machine、Material、Method、Environment）
+- 评估是否适合 PDCA 项目立项
+- 如果适合，引导创建项目结构
+
+### 2. 计划与校验 (Plan)
+
+**执行 SMART 校验：**
+- Specific（具体）：目标是否明确？
+- Measurable（可衡量）：是否有数字指标？
+- Achievable（可实现）：资源是否足够？
+- Relevant（相关）：是否与整体目标一致？
+- Time-bound（有时限）：完成时间是什么？
+
+**因果逻辑审查：**
+- 使用 5Why 分析根本原因
+- 验证因果关系（X → Y 是否成立？）
+
+### 3. 执行与巡检 (Do)
+
+- 引导用户记录执行日志
+- 汇总进展数据
+- 识别偏离计划的差异
+
+### 4. 检查与评估 (Check)
+
+- 分析目标达成率
+- 识别成功因素和失败原因
+- 评估数据偏差
+
+### 5. 决策与沉淀 (Act)
+
+- 决定：标准化、改进或放弃
+- 生成 SOP（标准作业程序）
+- 归档经验教训
+
+## 飞书集成指南
+
+### 创建项目结构
+
+```
+使用 feishu-create-doc 创建：
+- 项目名称/项目信息.md
+- 项目名称/Plan阶段/问题分析.md
+- 项目名称/Plan阶段/目标设定.md
+- 项目名称/Do阶段/执行日志.md
+- 项目名称/Check阶段/数据分析.md
+- 项目名称/Act阶段/总结报告.md
+```
+
+### Bitable 多维表格
+
+创建数据表记录：
+- 任务清单（任务、负责人、状态、截止日期）
+- 问题记录（问题、严重程度、状态、解决方案）
+- 指标追踪（指标名称、目标值、实际值、达成率）
+
+## 用户交互规范
+
+### AskUserQuestion 规则
+
+1. **所有单选问题必须包含 "Other" 选项**
+2. **选项必须互斥且穷尽**
+3. **选项描述要清晰**
+
+### Red Flags - 立即停止
+
+出现以下信号时，停止并重新评估：
+- 目标没有具体数字
+- 说"执行中再调整"
+- 说"快速补救一下"
+- 说"老板在催，先开始吧"
+- 直接接受用户提供的原因而不验证
+
+## 常用命令
+
+| 命令 | 功能 |
+|------|------|
+| `new` | 启动新项目 |
+| `ongoing` | 查看活跃项目 |
+| `achieve` | 检索历史案例 |
+| `plan` | 进入计划阶段 |
+| `check` | 执行 SMART 校验 |
+
+## 参考文档
+
+- 飞书 API 集成：见 `assets/references/feishu-integration.md`
+- 质量校验标准：见 `system/规范/`
+- 各阶段 Agent 提示词：见 `system/Agent/`

package/README.md

@@ -1,4 +1,4 @@
-# PDCA with AI — AI-Driven Project Management System
+# PDCA with AI — OpenClaw + Feishu 集成技能包
 
 [English](#english) | [中文](#中文) | [日本語](#日本語)
 
@@ -11,30 +11,54 @@
 
 ---
 
-## 中文
+## ⚠️ 重要说明 / Important Notice
 
-**基于 PDCA 循环的 AI 增强型问题解决工作流** — 集成飞书全工具链（Wiki + Bitable + Task + Calendar + Sheet），由 AI 主动巡检与质量校验。
+**这是一个专门为 OpenClow + 飞书（Feishu/Lark）设计的技能包。**
 
-### 🎯 系统简介
+This is a skill package designed specifically for **OpenClaw + Feishu/Lark** integration.
+
+**これは、OpenClaw + Feishu/Lark の統合のために特別に設計されたスキルパッケージです。**
+
+---
+
+### 适用平台 / Supported Platform
 
-PDCA with AI 是一个**时间流驱动**的项目管理系统。它将经典 PDCA 循环（Plan-Do-Check-Act）与 AI Agent 的主动驱动能力结合，通过飞书 API 实现从「问题分析」到「知识沉淀」的完整闭环。
+| 平台 | 支持状态 |
+|------|---------|
+| **OpenClaw** | ✅ 完全支持 |
+| **Gemini CLI** | ✅ 完全支持 |
+| **Claude Code** | ⚠️ 参考文档（不直接使用） |
+| **Codex / Cursor / Continue** | ⚠️ 参考文档（不直接使用） |
 
-### 核心亮点
+### 核心依赖 / Core Dependencies
 
-- **自治巡检 (The Loop)**：AI 自动读取一线人员填写的云文档，汇总进展并同步至 Bitable 看板
-- **质量校验 (Validator)**：在 Plan 阶段执行 **SMART 校验**与**因果逻辑链审查**
-- **即时预警 (Real-time Cards)**：巡检发现逻辑偏差或进度停滞，AI 立即发送飞书交互式卡片
-- **知识库 (Archiving)**：项目结项后，AI 自动提炼成功措施并归档
-- **制造场景优化**：内置设备 OEE 提升、不良率降低等专业模板
+本技能包依赖以下飞书 API：
 
-### 🚀 快速开始
+- `feishu-create-doc` - 创建云文档
+- `feishu-update-doc` - 更新云文档
+- `feishu-bitable` - 多维表格操作
+- `feishu-calendar` - 日程管理
+- `feishu-task` - 任务管理
+- `feishu-im-read` - 消息读取
+
+**如果没有安装 OpenClaw 飞书插件，此技能包无法正常工作。**
+
+---
+
+## 中文
+
+### 🎯 系统简介
+
+基于 PDCA 循环的 AI 增强型问题解决工作流，专为 **OpenClaw + 飞书** 环境设计。
+
+### 快速开始
 
 ```bash
-# npm 安装
-npm install -g @feng-h/pdca-skill
+# 通过 skills.sh 安装到 OpenClaw
+npx skills add Feng-H/PDCA-with-AI --agent skills
 
-# 或 npx 直接运行
-npx @feng-h/pdca-skill
+# 或使用 Gemini CLI
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
 ```
 
 ### 常用指令
@@ -49,28 +73,18 @@ npx @feng-h/pdca-skill
 
 ## English
 
-**AI-enhanced problem-solving workflow based on the PDCA cycle** — Integrated with Feishu/Lark full toolchain (Wiki + Bitable + Task + Calendar + Sheet), powered by AI-driven inspection and quality validation.
-
 ### 🎯 Overview
 
-PDCA with AI is a **time-flow driven** project management system. It combines the classic PDCA cycle (Plan-Do-Check-Act) with AI Agent's proactive capabilities, achieving a complete closed loop from "problem analysis" to "knowledge retention" through Feishu API.
+AI-enhanced problem-solving workflow based on the PDCA cycle, designed specifically for **OpenClaw + Feishu/Lark** environments.
 
-### Key Features
-
-- **Autonomous Inspection (The Loop)**: AI automatically reads cloud documents, summarizes progress, and syncs to Bitable dashboards
-- **Quality Validation**: SMART verification and causal logic chain review in Plan phase
-- **Real-time Alerts**: AI sends Feishu interactive cards immediately when logic deviations or progress stagnation are detected
-- **Knowledge Archiving**: AI extracts successful measures for future reuse
-- **Manufacturing Optimization**: Built-in templates for OEE improvement, defect rate reduction, etc.
-
-### 🚀 Quick Start
+### Quick Start
 
 ```bash
-# Install via npm
-npm install -g @feng-h/pdca-skill
+# Install via skills.sh for OpenClaw
+npx skills add Feng-H/PDCA-with-AI --agent skills
 
-# Or run directly with npx
-npx @feng-h/pdca-skill
+# Or using Gemini CLI
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
 ```
 
 ### Common Commands
@@ -85,28 +99,18 @@ npx @feng-h/pdca-skill
 
 ## 日本語
 
-**PDCAサイクルに基づくAI強化型問題解決ワークフロー** — Feishu/Larkフルツールチェーン（Wiki + Bitable + Task + Calendar + Sheet）と統合され、AI主導の検査と品質検証を備えています。
-
 ### 🎯 概要
 
-PDCA with AIは**タイムフロー駆動型**のプロジェクト管理システムです。古典的なPDCAサイクル（Plan-Do-Check-Act）とAIエージェントの能動的な能力を組み合わせ、Feishu APIを通じて「問題分析」から「知識蓄積」までの完全なクローズドループを実現します。
-
-### 主な機能
-
-- **自律検査（The Loop）**：AIが自動的にクラウドドキュメントを読み取り、進捗を要約してBitableダッシュボードに同期
-- **品質検証**：PlanフェーズでのSMART検証と因果ロジックチェーンレビュー
-- **リアルタイムアラート**：論理の偏差や進捗の停滞を検出すると、AIが即座にFeishuインタラクティブカードを送信
-- **知識アーカイブ**：プロジェクト完了後、AIが成功した施策を抽出して保存
-- **製造業向け最適化**：OEE向上、不良率低減などの専門テンプレートを内蔵
+PDCAサイクルに基づくAI強化型問題解決ワークフロー、**OpenClaw + Feishu/Lark** 環境のために特別に設計されました。
 
-### 🚀 クイックスタート
+### クイックスタート
 
 ```bash
-# npmでインストール
-npm install -g @feng-h/pdca-skill
+# skills.sh 経由で OpenClaw にインストール
+npx skills add Feng-H/PDCA-with-AI --agent skills
 
-# またはnpxで直接実行
-npx @feng-h/pdca-skill
+# または Gemini CLI を使用
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
 ```
 
 ### 一般コマンド
@@ -123,22 +127,23 @@ npx @feng-h/pdca-skill
 
 ```
 PDCA-with-AI/
-├── SKILL.md            # Main skill entry point
+├── SKILL.md            # OpenClaw/Gemini skill entry point
+├── .claude/skills/     # Reference documentation (not for execution)
 ├── assets/             # Documentation and tests
-│   ├── references/     # Execution guides and API integration specs
-│   ├── tests/          # Baseline tests and quality validation
+│   ├── references/     # Feishu API integration guides
+│   ├── tests/          # Quality validation
 │   └── templates/      # Project templates
 ├── system/             # Core engine layer
 │   ├── Agent/          # Plan/Do/Check/Act Agent prompts
-│   └── 规范/            # SMART validation and causal logic modules
+│   └── 规范/            # SMART validation modules
 └── README.md
 ```
 
 ## 📚 Documentation
 
-- [飞书集成指南](assets/references/feishu-integration.md) - Feishu/Lark API Integration
+- [飞书 API 集成指南](assets/references/feishu-integration.md) - Feishu/Lark API Integration
+- [OpenClaw 文档](https://github.com/open-claw/open-claw) - OpenClaw Plugin
 - [质量标准](assets/tests/) - Quality Standards & Testing
-- [GitHub Repository](https://github.com/Feng-H/PDCA-with-AI)
 
 ## 📄 License
 
@@ -146,4 +151,4 @@ PDCA-with-AI/
 
 ---
 
-**Powered by AI, making PDCA cycles truly spin!** / **由 AI 驱动，让 PDCA 循环真正「转」起来！** / **AI で駆動され、PDCA サイクルを本当に回す！**
+**Designed for OpenClaw + Feishu** / **专为 OpenClaw + 飞书设计** / **OpenClaw + Feishu のために設計**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng-h/pdca-skill",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "PDCA project management system for Feishu/Lark integration with AI-driven workflow",
   "keywords": [
     "skills",
@@ -28,6 +28,7 @@
     "SKILL.md",
     "assets/",
     "system/",
+    ".claude/",
     "README.md",
     "CLAUDE.md"
   ],