@feng-h/pdca-skill 1.0.6 → 1.0.8

package/README.md

@@ -1,4 +1,4 @@
-# PDCA with AI — AI-Driven Project Management System
+# PDCA with AI — OpenClaw + 飞书集成技能包
 
 [English](#english) | [中文](#中文) | [日本語](#日本語)
 
@@ -11,134 +11,170 @@
 
 ---
 
-## 中文
+## ⚠️ 重要说明 / Important Notice
 
-**基于 PDCA 循环的 AI 增强型问题解决工作流** — 集成飞书全工具链（Wiki + Bitable + Task + Calendar + Sheet），由 AI 主动巡检与质量校验。
+**这是一个深度集成飞书 API 的专业技能包，必须配合 OpenClaw 飞书插件使用。**
 
-### 🎯 系统简介
+This is a specialized skill package with **deep Feishu/Lark API integration**, designed exclusively for **OpenClaw with Feishu Plugin**.
 
-PDCA with AI 是一个**时间流驱动**的项目管理系统。它将经典 PDCA 循环（Plan-Do-Check-Act）与 AI Agent 的主动驱动能力结合，通过飞书 API 实现从「问题分析」到「知识沉淀」的完整闭环。
+**これは、Feishu/Lark API と深く統合された専門スキルパッケージであり、OpenClaw Feishu プラグインでの使用が必須です。**
 
-### 核心亮点
+---
 
-- **自治巡检 (The Loop)**：AI 自动读取一线人员填写的云文档，汇总进展并同步至 Bitable 看板
-- **质量校验 (Validator)**：在 Plan 阶段执行 **SMART 校验**与**因果逻辑链审查**
-- **即时预警 (Real-time Cards)**：巡检发现逻辑偏差或进度停滞，AI 立即发送飞书交互式卡片
-- **知识库 (Archiving)**：项目结项后，AI 自动提炼成功措施并归档
-- **制造场景优化**：内置设备 OEE 提升、不良率降低等专业模板
+## 为什么是 OpenClaw + 飞书？/ Why OpenClaw + Feishu?
 
-### 🚀 快速开始
+### 中文
 
-```bash
-# npm 安装
-npm install -g @feng-h/pdca-skill
+本技能包的核心功能依赖于以下**飞书专属 API**，这些 API 只有 OpenClaw 飞书插件提供：
 
-# 或 npx 直接运行
-npx @feng-h/pdca-skill
-```
+| API 调用 | 功能 | Claude Code | Gemini | Codex |
+|---------|------|-------------|--------|-------|
+| `feishu-create-doc` | 创建云文档到 Wiki/知识库 | ❌ | ❌ | ❌ |
+| `feishu-update-doc` | 局部更新文档内容 | ❌ | ❌ | ❌ |
+| `feishu-bitable` | 多维表格 CRUD (27种字段类型) | ❌ | ❌ | ❌ |
+| `feishu-calendar` | 日程管理和事件创建 | ❌ | ❌ | ❌ |
+| `feishu-task` | 任务创建、查询、更新 | ❌ | ❌ | ❌ |
+| `feishu-sheet` | 电子表格操作 | ❌ | ❌ | ❌ |
+| `feishu-im-read` | 群聊/私聊历史读取 | ❌ | ❌ | ❌ |
 
-### 常用指令
+**关键特性**：
+- **一个项目 = 一个文件夹 = 一个 Bitable 应用** — 飞书原生架构
+- **自治巡检 (The Loop)** — AI 定期读取飞书文档、汇总 Bitable 数据
+- **交互式卡片预警** — 飞书消息卡片推送
+- **知识沉淀** — 自动归档到 Wiki 经验库
 
-| 指令 | 说明 |
-|------|------|
-| `new` | 启动新项目 |
-| `ongoing` | 查看活跃项目看板 |
-| `achieve` | 检索历史成功案例 |
+这些功能都建立在飞书工具链的深度集成之上，无法在通用 AI 工具中实现。
 
 ---
 
-## English
+### 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.
+This skill package relies on the following **Feishu-exclusive APIs**, only available via OpenClaw Feishu Plugin:
 
-### 🎯 Overview
+| API Call | Function | Claude Code | Gemini | Codex |
+|---------|----------|-------------|--------|-------|
+| `feishu-create-doc` | Create docs in Wiki/Knowledge Base | ❌ | ❌ | ❌ |
+| `feishu-update-doc` | Partial document updates | ❌ | ❌ | ❌ |
+| `feishu-bitable` | Bitable CRUD (27 field types) | ❌ | ❌ | ❌ |
+| `feishu-calendar` | Calendar & event management | ❌ | ❌ | ❌ |
+| `feishu-task` | Task creation, query, update | ❌ | ❌ | ❌ |
+| `feishu-sheet` | Spreadsheet operations | ❌ | ❌ | ❌ |
+| `feishu-im-read` | Group/private chat history | ❌ | ❌ | ❌ |
 
-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.
+**Key Features**:
+- **One Project = One Folder = One Bitable App** — Native Feishu architecture
+- **Autonomous Inspection (The Loop)** — AI periodically reads Feishu docs, aggregates Bitable data
+- **Interactive Card Alerts** — Feishu message card push notifications
+- **Knowledge Archiving** — Auto-archive to Wiki experience library
 
-### Key Features
+These features are built on deep integration with Feishu toolchain and cannot be achieved in generic AI tools.
 
-- **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
+### 日本語
 
-```bash
-# Install via npm
-npm install -g @feng-h/pdca-skill
+このスキルパッケージは、以下の **Feishu 専用 API** に依存しており、OpenClaw Feishu プラグイン経由でのみ利用可能です：
 
-# Or run directly with npx
-npx @feng-h/pdca-skill
-```
+| API 呼び出し | 機能 | Claude Code | Gemini | Codex |
+|-------------|------|-------------|--------|-------|
+| `feishu-create-doc` | Wiki/ナレッジベースにドキュメント作成 | ❌ | ❌ | ❌ |
+| `feishu-update-doc` | ドキュメントの部分更新 | ❌ | ❌ | ❌ |
+| `feishu-bitable` | Bitable CRUD（27種のフィールドタイプ） | ❌ | ❌ | ❌ |
+| `feishu-calendar` | カレンダーとイベント管理 | ❌ | ❌ | ❌ |
+| `feishu-task` | タスク作成、照会、更新 | ❌ | ❌ | ❌ |
+| `feishu-sheet` | スプレッドシート操作 | ❌ | ❌ | ❌ |
+| `feishu-im-read` | グループ/プライベートチャット履歴 | ❌ | ❌ | ❌ |
 
-### Common Commands
+**主な機能**：
+- **1プロジェクト = 1フォルダ = 1 Bitable アプリ** — Feishu ネイティブアーキテクチャ
+- **自律検査（The Loop）** — AI が定期的に Feishu ドキュメントを読み取り、Bitable データを集約
+- **インタラクティブカードアラート** — Feishu メッセージカードプッシュ通知
+- **知識アーカイブ** — Wiki 経験ライブラリへ自動アーカイブ
 
-| Command | Description |
-|---------|-------------|
-| `new` | Start a new project |
-| `ongoing` | View active project dashboard |
-| `achieve` | Search historical success cases |
+これらの機能は Feishu ツールチェーンとの深い統合に基づいており、汎用 AI ツールでは実現できません。
 
 ---
 
-## 日本語
+## 🚀 快速开始 / Quick Start
 
-**PDCAサイクルに基づくAI強化型問題解決ワークフロー** — Feishu/Larkフルツールチェーン（Wiki + Bitable + Task + Calendar + Sheet）と統合され、AI主導の検査と品質検証を備えています。
+### 中文
 
-### 🎯 概要
+**前提条件**：已安装 OpenClaw 并配置飞书插件
 
-PDCA with AIは**タイムフロー駆動型**のプロジェクト管理システムです。古典的なPDCAサイクル（Plan-Do-Check-Act）とAIエージェントの能動的な能力を組み合わせ、Feishu APIを通じて「問題分析」から「知識蓄積」までの完全なクローズドループを実現します。
+```bash
+# 通过 skills.sh 安装
+npx skills add Feng-H/PDCA-with-AI --agent skills
 
-### 主な機能
+# 或使用 Gemini CLI
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
+```
 
-- **自律検査（The Loop）**：AIが自動的にクラウドドキュメントを読み取り、進捗を要約してBitableダッシュボードに同期
-- **品質検証**：PlanフェーズでのSMART検証と因果ロジックチェーンレビュー
-- **リアルタイムアラート**：論理の偏差や進捗の停滞を検出すると、AIが即座にFeishuインタラクティブカードを送信
-- **知識アーカイブ**：プロジェクト完了後、AIが成功した施策を抽出して保存
-- **製造業向け最適化**：OEE向上、不良率低減などの専門テンプレートを内蔵
+**核心命令**：
+- `new` — 启动新 PDCA 项目（自动创建 Wiki + Bitable + Calendar）
+- `ongoing` — 查看活跃项目看板
+- `achieve` — 检索历史成功案例
+
+---
 
-### 🚀 クイックスタート
+### English
+
+**Prerequisite**: OpenClaw installed with Feishu plugin configured
 
 ```bash
-# npmでインストール
-npm install -g @feng-h/pdca-skill
+# Install via skills.sh
+npx skills add Feng-H/PDCA-with-AI --agent skills
 
-# またはnpxで直接実行
-npx @feng-h/pdca-skill
+# Or using Gemini CLI
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
 ```
 
-### 一般コマンド
+**Core Commands**:
+- `new` — Start a new PDCA project (auto-creates Wiki + Bitable + Calendar)
+- `ongoing` — View active project dashboard
+- `achieve` — Search historical success cases
+
+---
+
+### 日本語
+
+**前提条件**: OpenClaw がインストールされ、Feishu プラグインが設定されていること
+
+```bash
+# skills.sh 経由でインストール
+npx skills add Feng-H/PDCA-with-AI --agent skills
+
+# または Gemini CLI を使用
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
+```
 
-| コマンド | 説明 |
-|---------|------|
-| `new` | 新規プロジェクトを開始 |
-| `ongoing` | アクティブなプロジェクトダッシュボードを表示 |
-| `achieve` | 過去の成功事例を検索 |
+**主要コマンド**:
+- `new` — 新規 PDCA プロジェクトを開始（Wiki + Bitable + Calendar を自動作成）
+- `ongoing` — アクティブなプロジェクトダッシュボードを表示
+- `achieve` — 過去の成功事例を検索
 
 ---
 
-## 📁 Project Structure
+## 📁 项目结构 / Project Structure
 
 ```
 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
+## 📚 文档 / Documentation
 
-- [飞书集成指南](assets/references/feishu-integration.md) - Feishu/Lark API Integration
+- [飞书 API 集成指南](assets/references/feishu-integration.md) - Complete Feishu API Integration Guide
+- [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 +182,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.6",
+  "version": "1.0.8",
   "description": "PDCA project management system for Feishu/Lark integration with AI-driven workflow",
   "keywords": [
     "skills",