npm - @feng-h/pdca-skill - Versions diffs - 1.0.9 → 1.0.11 - Mend

@feng-h/pdca-skill 1.0.9 → 1.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/CLAUDE.md CHANGED Viewed

@@ -2,107 +2,223 @@
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-## Project Overview
+---
-PDCA-with-AI is an **AI-driven workflow system** based on the PDCA (Plan-Do-Check-Act) cycle, not a traditional software codebase. The system integrates with Feishu (Lark) tools (Wiki, Bitable, Calendar, Task, Sheet) to provide structured problem-solving workflows for manufacturing and quality improvement scenarios.
+## 项目概述 / Project Overview
-**Key distinction:** This project consists primarily of markdown files that define AI agents, workflows, and templates. There is no TypeScript/JavaScript source code to build or test.
+**PDCA-with-AI** 是一个基于 PDCA 循环的 AI 驱动型工作流系统，专为 **OpenClaw + 飞书（Feishu/Lark）** 深度集成设计。
-## Architecture
+**核心特点**：
+- 非 traditional 软件代码库，主要由 markdown 文件定义 AI agents、workflows 和 templates
+- 深度依赖飞书 API（Wiki、Bitable、Calendar、Task、Sheet）
+- 遵循 [superpowers:writing-skills](https://github.com/obra/superpowers) 标准
-### Entry Point
-- **`pdca/SKILL.md`** — The main skill definition. When the `pdca` skill is invoked, this file contains the primary logic for project evaluation and creation.
+---
-### Core System Files (`_系统/`)
-- **`Agent/PDCA控制器.md`** — Central orchestrator managing the PDCA time flow, phase transitions, and rollback mechanisms
-- **`Agent/PlanAgent.md`**, **`DoAgent.md`**, **`CheckAgent.md`**, **`ActAgent.md`** — Phase-specific AI agents
-- **`规范/核心规范.md`** — Core system standards, including the principle that **Bitable is the single source of truth for all data**
-- **`规范/Validators/smart.md`** — SMART goal validation standards
-- **`规范/Validators/logic.md`** — Causal logic chain validation
+## 当前状态 / Current Status
-### Reference Documentation (`pdca/references/`)
-- **`feishu-integration.md`** — Complete Feishu API integration patterns (Wiki, Bitable, Calendar, Task, Sheet)
-- **`cron-driving.md`** — Automated inspection loop logic (The Loop: Scrape → Load → Verify → Message)
-- **`transition-checklist.md`** — Phase transition requirements
-- **`exception-handling.md`** — Exception handling patterns
+| 项目 | 状态 |
+|------|------|
+| **GitHub** | https://github.com/Feng-H/PDCA-with-AI |
+| **npm 包** | @feng-h/pdca-skill |
+| **最新版本** | v1.0.9 |
+| **安装方式** | `npx skills add Feng-H/PDCA-with-AI --agent skills` |
+---
+## 项目结构 / Project Structure
-### Project Structure
 ```
 PDCA-with-AI/
-├── pdca/               # Skill package (frontend interface layer)
-│   ├── SKILL.md        # Main skill entry point
-│   ├── references/     # Detailed guides
-│   └── tests/          # Baseline tests
-├── _系统/              # Core engine (backend specifications)
-│   ├── Agent/          # Agent definitions
-│   ├── 规范/            # Standards and validators
-│   └── 工具/            # Operational guides
-└── 项目/               # Active project instances
+├── SKILL.md            # OpenClaw/Gemini 技能入口（主要文件）
+├── .claude/skills/     # Claude Code 参考文档（非执行）
+├── assets/             # 详细文档与测试
+│   ├── references/     # 飞书 API 集成指南
+│   ├── tests/          # 基线测试与质量验证
+│   └── templates/      # 项目模板
+├── system/             # 核心引擎层
+│   ├── Agent/          # Plan/Do/Check/Act Agent 提示词
+│   ├── 规范/            # SMART 校验与因果逻辑模组
+│   ├── 工具/            # Bitable 配置、工作流等
+│   └── 模板/            # 系统模板
+├── bin/                # npx 可执行文件
+├── package.json        # npm 包配置
+└── README.md           # 项目说明（中/英/日）
 ```
-## Key Workflows
-### Three Primary Commands
-The system is invoked through three main intents (defined in `_系统/项目管理系统.md`):
-| Command | Purpose | Output |
-|---------|---------|--------|
-| `new` | Initialize a new project | Creates Feishu Wiki + Bitable + Calendar resources |
-| `ongoing` | Manage active projects | Progress check + status update + alerts |
-| `achieve` | Search experience library | Best practice recommendations + template matching |
-### Phase Transition Logic
-Phase transitions are **strictly sequential** and require:
-1. Completion of all mandatory tasks in current phase
-2. Verification against `_系统/工具/阶段转换检查表.md`
-3. Explicit user confirmation (via Feishu interactive cards)
-### The Loop (Automated Inspection)
-The PDCA Controller runs a 4-step inspection cycle:
-1. **Scrape (Wiki)**: Fetch all project documents from Feishu Wiki
-2. **Load (Logic)**: Load phase-specific "required conditions" and "deliverables checklist"
-3. **Verify**: Compare Wiki content against requirements, identify gaps or logic conflicts
-4. **Message (Card)**: Send Feishu interactive card (green/yellow/red based on severity)
-## Quality Standards
-This project follows [superpowers:writing-skills](https://github.com/obra/superpowers) standards:
-- **RED-GREEN-REFACTOR**: All skills validated via baseline tests
-- **Rationalization Defense**: Explicit prohibitions against common agent shortcuts
-- **Red Flags**: Stop-and-restart signals when quality is at risk
-### Critical Red Flags
-When you encounter these signals, **STOP immediately** and return to Plan phase:
-- Goals without specific numbers
-- "We'll adjust during execution"
-- "Quick fix is enough"
-- "Boss is rushing, let's start"
-- "Already spent X weeks" (sunk cost fallacy)
-- Accepting user-provided causes without Why/verification
-### Rationalization Defenses
-Common excuses that must be rejected:
-- "Time is tight, need to launch quickly" → Fast launch without clear goals = accelerating in wrong direction
-- "No project manager, use simple approach" → Simple approach still needs SMART foundation
-- "User already identified the cause" → User provides symptoms, not root causes
-- "Plan took 3 weeks, too long" → Time is not a reason to skip quality checks
-## Important Constraints
-1. **Single Source of Truth**: Feishu Bitable is the only authoritative source for project status data
-2. **User Decision Required**: All phase transitions and project closures require explicit user confirmation
-3. **Immediate Alerting**: When inspection finds logic deviations or progress stagnation, immediately send Feishu interactive card
-4. **No Shortcuts**: SMART validation and causal logic verification are mandatory, not optional
-## Testing
-Baseline test scenarios are in `pdca/tests/baseline-test-scenarios.md`. These verify behavior WITHOUT the skill loaded to identify problems that the skill should solve.
-## Feishu Integration Notes
-Key Feishu API patterns from `feishu-integration.md`:
-- **Bitable person fields**: Must be `[{id: "ou_xxx"}]`, not strings
-- **Bitable date fields**: Millisecond timestamps, not seconds
-- **Bitable hyperlink fields (type=15)**: Do NOT pass `property` parameter on create
-- **Calendar events**: Always pass `user_open_id` from SenderId so user can see the event
-- **No concurrent writes**: Bitable does not support concurrent writes, call serially with 0.5-1s delay
+**路径变更说明**：
+- 原 `pdca/` → 现 `assets/`
+- 原 `_系统/` → 现 `system/`
+---
+## 核心依赖 / Core Dependencies
+### 必需平台 / Required Platform
+| 组件 | 说明 | 获取方式 |
+|------|------|---------|
+| **OpenClaw** | AI CLI 框架 | https://github.com/open-claw/open-claw |
+| **飞书插件** | 提供 feishu-* API | OpenClaw 官方插件 |
+### 关键 API 列表
+本技能包依赖以下飞书 API（**仅 OpenClaw 飞书插件提供**）：
+| API | 功能 |
+|-----|------|
+| `feishu-create-doc` | 创建 Wiki 文档 |
+| `feishu-update-doc` | 更新文档内容 |
+| `feishu-fetch-doc` | 读取文档内容 |
+| `feishu-bitable` | 多维表格 CRUD（27种字段类型） |
+| `feishu-calendar` | 日程管理 |
+| `feishu-task` | 任务管理 |
+| `feishu-sheet` | 电子表格 |
+| `feishu-im-read` | 消息读取 |
+---
+## 核心工作流 / Core Workflows
+### 三大命令
+| 命令 | 功能 | 输出 |
+|------|------|------|
+| `new` | 启动新项目 | 创建 Wiki + Bitable 应用 + Calendar |
+| `ongoing` | 管理活跃项目 | 进度检查 + 状态更新 + 预警 |
+| `achieve` | 检索经验库 | 最佳实践推荐 + 模板匹配 |
+### 阶段转换逻辑
+阶段转换**严格按顺序**，需要：
+1. 当前阶段所有必选任务完成
+2. 对照 `system/工具/阶段转换检查表.md` 验证
+3. 用户通过飞书交互式卡片确认
+### The Loop（自治巡检）
+PDCA 控制器运行的 4 步巡检循环：
+1. **Scrape (Wiki)**：获取所有项目文档
+2. **Load (Logic)**：加载阶段特定的"必需条件"和"交付物清单"
+3. **Verify**：对比 Wiki 内容与要求，识别差距或逻辑冲突
+4. **Message (Card)**：发送飞书交互式卡片（绿/黄/红基于严重程度）
+---
+## 质量标准 / Quality Standards
+### Red Flags - 立即停止
+遇到以下信号时，**立即停止**并返回 Plan 阶段：
+- 目标没有具体数字
+- "执行中再调整"
+- "快速补救一下"
+- "老板在催，先开始吧"
+- "已经花了 X 周了"（沉没成本谬误）
+- 直接接受用户提供的原因而不验证
+### Rationalization 防御
+| 借口 | 现实 |
+|------|------|
+| "时间紧，需要快速上线" | 没有清晰目标的快速上线 = 朝错误方向加速 |
+| "没有项目经理，用简单方式" | 简单方式仍需 SMART 基础 |
+| "用户已经说了原因" | 用户说的是症状，不是根因 |
+---
+## 重要约束 / Important Constraints
+1. **Single Source of Truth**：飞书 Bitable 是项目状态的唯一权威数据源
+2. **User Decision Required**：所有阶段转换和项目结项需用户确认
+3. **Immediate Alerting**：巡检发现逻辑偏差或进度停滞，立即发送飞书交互式卡片
+4. **No Shortcuts**：SMART 校验和因果逻辑验证是强制的，不可跳过
+---
+## 飞书 API 注意事项 / Feishu API Notes
+### 关键坑位
+| 字段类型 | 注意事项 |
+|---------|---------|
+| **人员字段** | 必须是 `[{id: "ou_xxx"}]`，不能是字符串 |
+| **日期字段** | 毫秒时间戳，不是秒 |
+| **超链接字段 (type=15)** | 创建时不要传 `property` 参数 |
+| **日历事件** | 必须传 `user_open_id` 让用户能看到日程 |
+| **并发写入** | Bitable 不支持并发写，串行调用 + 0.5-1s 延迟 |
+---
+## 测试 / Testing
+基线测试场景：`assets/tests/baseline-test-scenarios.md`
+这些验证**不加载技能时的行为**，以识别技能应该解决的问题。
+---
+## 使用后优化指南 / Optimization Guide
+### 当你发现问题时
+1. **问题分类**：
+   - **内容问题**（SKILL.md 描述不清、流程有误）
+   - **API 问题**（飞书 API 调用错误、参数不对）
+   - **逻辑问题**（阶段转换条件、验证规则）
+   - **格式问题**（文档结构、路径引用）
+2. **对应文件**：
+   | 问题类型 | 修改文件 |
+   |---------|---------|
+   | 内容问题 | `SKILL.md`, `system/Agent/*.md` |
+   | API 问题 | `assets/references/feishu-integration.md` |
+   | 逻辑问题 | `system/规范/Validators/*.md` |
+   | 格式问题 | `README.md`, `CLAUDE.md` |
+3. **修改后操作**：
+   ```bash
+   # 1. 提交到 GitHub
+   git add -A && git commit -m "fix: 描述修改内容"
+   git push origin main
+   # 2. 发布新版本
+   npm version patch  # 或 minor/major
+   ```
+   这会自动推送 + 发布到 npm（配置了 postversion hook）
+### 快速进入状态
+当你下次来优化时，需要检查：
+1. **npm 版本**：`npm view @feng-h/pdca-skill version`
+2. **文档结构**：`ls -la assets/ system/`
+3. **用户反馈**：具体问题描述
+---
+## 最近变更 / Recent Changes
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| v1.0.9 | 2026-04-06 | 添加 OpenClaw 对比表格，说明 Lark-CLI 可能性 |
+| v1.0.8 | 2026-04-06 | 说明为什么需要 OpenClaw + 飞书 |
+| v1.0.7 | 2026-04-06 | 添加中/英/日多语言 README |
+| v1.0.6 | 2026-04-06 | 添加 Claude Code 技能支持 |
+| v1.0.5 | 2026-04-06 | 添加 npx bin 可执行文件 |
+| v1.0.0-v1.0.4 | 2026-04-06 | 初始版本，项目结构重构 |
+---
+## 发布流程 / Release Process
+```bash
+# 一键发布（自动推送到 GitHub + npm）
+npm run release:patch   # 补丁版本 (1.0.9 → 1.0.10)
+npm run release:minor   # 次要版本 (1.0.9 → 1.1.0)
+npm run release:major   # 主要版本 (1.0.9 → 2.0.0)
+```
+---
+**Designed for OpenClaw + Feishu** / **专为 OpenClaw + 飞书设计**

package/README.md CHANGED Viewed

@@ -1,9 +1,5 @@
 # PDCA with AI — OpenClaw + 飞书集成技能包
-[English](#english) | [中文](#中文) | [日本語](#日本語)
----
 <a href="https://www.npmjs.com/package/@feng-h/pdca-skill"><img src="https://img.shields.io/npm/v/@feng-h/pdca-skill" alt="npm version"></a>
 <a href="https://www.npmjs.com/package/@feng-h/pdca-skill"><img src="https://img.shields.io/npm/dm/@feng-h/pdca-skill" alt="npm downloads"></a>
 <a href="https://github.com/Feng-H/PDCA-with-AI/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@feng-h/pdca-skill" alt="License"></a>
@@ -11,19 +7,19 @@
 ---
-## ⚠️ 重要说明 / Important Notice
+## [中文](#中文) | [English](#english) | [日本語](#日本語)
-**这是一个深度集成飞书 API 的专业技能包，必须配合 OpenClaw 飞书插件使用。**
+---
-This is a specialized skill package with **deep Feishu/Lark API integration**, designed exclusively for **OpenClaw with Feishu Plugin**.
+<a name="中文"></a>
-**これは、Feishu/Lark API と深く統合された専門スキルパッケージであり、OpenClaw Feishu プラグインでの使用が必須です。**
+## 中文
----
+### ⚠️ 重要说明
-## 为什么是 OpenClaw + 飞书？/ Why OpenClaw + Feishu?
+**这是一个深度集成飞书 API 的专业技能包，必须配合 OpenClaw 飞书插件使用。**
-### 中文
+### 为什么是 OpenClaw + 飞书？
 本技能包的核心功能依赖于以下**飞书专属 API**，这些 API 只有 OpenClaw 飞书插件提供：
@@ -39,17 +35,49 @@ This is a specialized skill package with **deep Feishu/Lark API integration**, d
 > *⚠️ 理论上可通过 Lark-CLI 等第三方工具实现，但未经测试。本技能包仅针对 OpenClaw 飞书插件进行验证。*
-**关键特性**：
-- **一个项目 = 一个文件夹 = 一个 Bitable 应用** — 飞书原生架构
-- **自治巡检 (The Loop)** — AI 定期读取飞书文档、汇总 Bitable 数据
-- **交互式卡片预警** — 飞书消息卡片推送
-- **知识沉淀** — 自动归档到 Wiki 经验库
+### 🎯 系统简介
+基于 PDCA 循环的 AI 增强型问题解决工作流，专为 **OpenClaw + 飞书** 环境设计。
+### 核心亮点
-这些功能都建立在飞书工具链的深度集成之上，无法在通用 AI 工具中实现。
+- **自治巡检 (The Loop)**：AI 自动读取一线人员填写的云文档，汇总进展并同步至 Bitable 看板
+- **质量校验 (Validator)**：在 Plan 阶段执行 **SMART 校验**与**因果逻辑链审查**
+- **即时预警 (Real-time Cards)**：巡检发现逻辑偏差或进度停滞，AI 立即发送飞书交互式卡片
+- **知识库 (Archiving)**：项目结项后，AI 自动提炼成功措施并归档
+- **制造场景优化**：内置设备 OEE 提升、不良率降低等专业模板
+### 🚀 快速开始
+**前提条件**：已安装 OpenClaw 并配置飞书插件
+```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` | 检索历史成功案例 |
 ---
-### English
+<a name="english"></a>
+## English
+### ⚠️ Important Notice
+**This is a specialized skill package with deep Feishu/Lark API integration, designed exclusively for OpenClaw with Feishu Plugin.**
+### Why OpenClaw + Feishu?
 This skill package relies on the following **Feishu-exclusive APIs**, only available via OpenClaw Feishu Plugin:
@@ -65,85 +93,79 @@ This skill package relies on the following **Feishu-exclusive APIs**, only avail
 > *⚠️ Theoretically achievable via third-party tools like Lark-CLI, but untested. This skill package is only validated for OpenClaw Feishu Plugin.*
-**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
+### 🎯 Overview
-These features are built on deep integration with Feishu toolchain and cannot be achieved in generic AI tools.
+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.
-このスキルパッケージは、以下の **Feishu 専用 API** に依存しており、OpenClaw Feishu プラグイン経由でのみ利用可能です：
+### 🚀 Quick Start
-| API 呼び出し | 機能 | OpenClaw | 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` | グループ/プライベートチャット履歴 | ✅ | ⚠️* | ⚠️* | ⚠️* |
+**Prerequisite**: OpenClaw installed with Feishu plugin configured
-> *⚠️ 理論的には Lark-CLI などのサードパーティツールで実現可能ですが、未テストです。このスキルパッケージは OpenClaw Feishu プラグインでのみ検証されています。*
+```bash
+# Install via skills.sh
+npx skills add Feng-H/PDCA-with-AI --agent skills
+# Or using Gemini CLI
+gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
+```
-**主な機能**：
-- **1プロジェクト = 1フォルダ = 1 Bitable アプリ** — Feishu ネイティブアーキテクチャ
-- **自律検査（The Loop）** — AI が定期的に Feishu ドキュメントを読み取り、Bitable データを集約
-- **インタラクティブカードアラート** — Feishu メッセージカードプッシュ通知
-- **知識アーカイブ** — Wiki 経験ライブラリへ自動アーカイブ
+### Common Commands
-これらの機能は Feishu ツールチェーンとの深い統合に基づいており、汎用 AI ツールでは実現できません。
+| Command | Description |
+|---------|-------------|
+| `new` | Start a new project |
+| `ongoing` | View active project dashboard |
+| `achieve` | Search historical success cases |
 ---
-## 🚀 快速开始 / Quick Start
+<a name="日本語"></a>
-### 中文
+## 日本語
-**前提条件**：已安装 OpenClaw 并配置飞书插件
+### ⚠️ 重要なお知らせ
-```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
-```
+**これは、Feishu/Lark API と深く統合された専門スキルパッケージであり、OpenClaw Feishu プラグインでの使用が必須です。**
-**核心命令**：
-- `new` — 启动新 PDCA 项目（自动创建 Wiki + Bitable + Calendar）
-- `ongoing` — 查看活跃项目看板
-- `achieve` — 检索历史成功案例
+### なぜ OpenClaw + Feishu なのか？
----
+このスキルパッケージは、以下の **Feishu 専用 API** に依存しており、OpenClaw Feishu プラグイン経由でのみ利用可能です：
-### English
+| API 呼び出し | 機能 | OpenClaw | 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` | グループ/プライベートチャット履歴 | ✅ | ⚠️* | ⚠️* | ⚠️* |
-**Prerequisite**: OpenClaw installed with Feishu plugin configured
+> *⚠️ 理論的には Lark-CLI などのサードパーティツールで実現可能ですが、未テストです。このスキルパッケージは OpenClaw Feishu プラグインでのみ検証されています。*
-```bash
-# Install via skills.sh
-npx skills add Feng-H/PDCA-with-AI --agent skills
+### 🎯 概要
-# Or using Gemini CLI
-gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
-```
+PDCAサイクルに基づく AI 強化型問題解決ワークフロー、**OpenClaw + Feishu/Lark** 環境のために特別に設計されました。
-**Core Commands**:
-- `new` — Start a new PDCA project (auto-creates Wiki + Bitable + Calendar)
-- `ongoing` — View active project dashboard
-- `achieve` — Search historical success cases
+### 主な機能
----
+- **自律検査（The Loop）**：AI が自動的にクラウドドキュメントを読み取り、進捗を要約して Bitable ダッシュボードに同期
+- **品質検証**：Plan フェーズでの SMART 検証と因果ロジックチェーンレビュー
+- **リアルタイムアラート**：論理の偏差や進捗の停滞を検出すると、AI が即座に Feishu インタラクティブカードを送信
+- **知識アーカイブ**：AI が成功した施策を抽出して将来のために保存
+- **製造業向け最適化**：OEE 向上、不良率低減などの専門テンプレートを内蔵
-### 日本語
+### 🚀 クイックスタート
-**前提条件**: OpenClaw がインストールされ、Feishu プラグインが設定されていること
+**前提条件**：OpenClaw がインストールされ、Feishu プラグインが設定されていること
 ```bash
 # skills.sh 経由でインストール
@@ -153,32 +175,38 @@ npx skills add Feng-H/PDCA-with-AI --agent skills
 gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
 ```
-**主要コマンド**:
-- `new` — 新規 PDCA プロジェクトを開始（Wiki + Bitable + Calendar を自動作成）
-- `ongoing` — アクティブなプロジェクトダッシュボードを表示
-- `achieve` — 過去の成功事例を検索
+### 一般コマンド
+| コマンド | 説明 |
+|---------|------|
+| `new` | 新規プロジェクトを開始 |
+| `ongoing` | アクティブなプロジェクトダッシュボードを表示 |
+| `achieve` | 過去の成功事例を検索 |
 ---
-## 📁 项目结构 / Project Structure
+## 📁 Project Structure
 ```
 PDCA-with-AI/
 ├── SKILL.md            # OpenClaw/Gemini skill entry point
-├── .claude/skills/     # Reference documentation (not for execution)
+├── .claude/skills/     # Reference documentation
 ├── assets/             # Documentation and tests
 │   ├── references/     # Feishu API integration guides
 │   ├── tests/          # Quality validation
 │   └── templates/      # Project templates
 ├── system/             # Core engine layer
 │   ├── Agent/          # Plan/Do/Check/Act Agent prompts
-│   └── 规范/            # SMART validation modules
+│   ├── 规范/            # SMART validation modules
+│   ├── 工具/            # Bitable config, workflows
+│   └── 模板/            # System templates
+├── bin/                # npx executable
 └── README.md
 ```
-## 📚 文档 / Documentation
+## 📚 Documentation
-- [飞书 API 集成指南](assets/references/feishu-integration.md) - Complete Feishu API Integration Guide
+- [飞书 API 集成指南](assets/references/feishu-integration.md) - Complete Feishu/Lark API Integration Guide
 - [OpenClaw 项目](https://github.com/open-claw/open-claw) - OpenClaw Plugin
 - [质量标准](assets/tests/) - Quality Standards & Testing

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@feng-h/pdca-skill",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "PDCA project management system for Feishu/Lark integration with AI-driven workflow",
   "keywords": [
     "skills",