@feng-h/pdca-skill 1.0.3 → 1.0.5

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
  1. package/README.md +98 -80
  2. package/bin/pdca.js +41 -0
  3. package/package.json +8 -5
package/README.md CHANGED
@@ -1,131 +1,149 @@
1
- # PDCA with AI — 自治驱动的项目管理系统
1
+ # PDCA with AI — AI-Driven Project Management System
2
2
 
3
- **基于 PDCA 循环的 AI 增强型问题解决工作流** — 集成飞书全工具链（Wiki + Bitable + Task + Calendar + Sheet），由 AI 主动巡检与质量校验。
3
+ [English](#english) | [中文](#中文) | [日本語](#日本語)
4
4
 
5
5
  ---
6
6
 
7
- ## 🎯 系统简介
7
+ <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>
8
+ <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>
9
+ <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>
10
+ <a href="https://github.com/Feng-H/PDCA-with-AI"><img src="https://img.shields.io/github/stars/Feng-H/PDCA-with-AI?style=social" alt="GitHub stars"></a>
11
+
12
+ ---
13
+
14
+ ## 中文
15
+
16
+ **基于 PDCA 循环的 AI 增强型问题解决工作流** — 集成飞书全工具链（Wiki + Bitable + Task + Calendar + Sheet），由 AI 主动巡检与质量校验。
17
+
18
+ ### 🎯 系统简介
8
19
 
9
20
  PDCA with AI 是一个**时间流驱动**的项目管理系统。它将经典 PDCA 循环（Plan-Do-Check-Act）与 AI Agent 的主动驱动能力结合，通过飞书 API 实现从「问题分析」到「知识沉淀」的完整闭环。
10
21
 
11
22
  ### 核心亮点
12
23
 
13
- - **自治巡检 (The Loop)**：AI 自动读取一线人员填写的云文档，汇总进展并同步至 Bitable 看板。
14
- - **质量校验 (Validator)**：在 Plan 阶段执行 **SMART 校验**与**因果逻辑链审查**，确保方案足以达成目标。
15
- - **即时预警 (Real-time Cards)**：巡检发现逻辑偏差或进度停滞，AI 立即向项目经理发送飞书交互式卡片。
16
- - **知识库 (Archiving)**：项目结项后，AI 自动提炼成功措施并归档，供未来项目复用。
17
- - **制造场景优化**：内置设备 OEE 提升、不良率降低等专业模板。
24
+ - **自治巡检 (The Loop)**：AI 自动读取一线人员填写的云文档，汇总进展并同步至 Bitable 看板
25
+ - **质量校验 (Validator)**：在 Plan 阶段执行 **SMART 校验**与**因果逻辑链审查**
26
+ - **即时预警 (Real-time Cards)**：巡检发现逻辑偏差或进度停滞，AI 立即发送飞书交互式卡片
27
+ - **知识库 (Archiving)**：项目结项后，AI 自动提炼成功措施并归档
28
+ - **制造场景优化**：内置设备 OEE 提升、不良率降低等专业模板
18
29
 
19
- ---
30
+ ### 🚀 快速开始
20
31
 
21
- ## 📁 项目结构
32
+ ```bash
33
+ # npm 安装
34
+ npm install -g @feng-h/pdca-skill
22
35
 
36
+ # 或 npx 直接运行
37
+ npx @feng-h/pdca-skill
23
38
  ```
24
- PDCA-with-AI/
25
- ├── SKILL.md # 符合 skill-creator 规范的主控文件
26
- ├── assets/ # 详细文档与测试
27
- │ ├── references/ # 执行指南与 API 集成规范
28
- │ ├── tests/ # 基线测试与质量验证
29
- │ └── templates/ # 项目模板
30
- ├── system/ # 核心引擎层（后端规范与逻辑）
31
- │ ├── Agent/ # Plan/Do/Check/Act 专业 Agent 提示词
32
- │ └── 规范/ # SMART 校验与因果逻辑模组
33
- └── README.md
34
- ```
39
+
40
+ ### 常用指令
41
+
42
+ | 指令 | 说明 |
43
+ |------|------|
44
+ | `new` | 启动新项目 |
45
+ | `ongoing` | 查看活跃项目看板 |
46
+ | `achieve` | 检索历史成功案例 |
35
47
 
36
48
  ---
37
49
 
38
- ## ✅ 质量标准
50
+ ## English
39
51
 
40
- 本项目遵循 [superpowers:writing-skills](https://github.com/obra/superpowers) 标准：
52
+ **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.
41
53
 
42
- - **RED-GREEN-REFACTOR**：所有 skill 经过基线测试验证
43
- - **Rationalization 防御**：明确禁止 Agent 的常见违规理由
44
- - **Red Flags 机制**：识别何时需要停止并重新评估
45
- - **Token 效率**：主文件保持精简，详细内容分离到 references/
54
+ ### 🎯 Overview
46
55
 
47
- 测试文档：[assets/tests/](assets/tests/)
56
+ 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.
48
57
 
49
- ---
58
+ ### Key Features
50
59
 
51
- ## 🚀 快速开始
60
+ - **Autonomous Inspection (The Loop)**: AI automatically reads cloud documents, summarizes progress, and syncs to Bitable dashboards
61
+ - **Quality Validation**: SMART verification and causal logic chain review in Plan phase
62
+ - **Real-time Alerts**: AI sends Feishu interactive cards immediately when logic deviations or progress stagnation are detected
63
+ - **Knowledge Archiving**: AI extracts successful measures for future reuse
64
+ - **Manufacturing Optimization**: Built-in templates for OEE improvement, defect rate reduction, etc.
52
65
 
53
- ### 1. 安装 Skill
66
+ ### 🚀 Quick Start
54
67
 
55
- **方式 A：通过 npm 安装（推荐）**
56
68
  ```bash
69
+ # Install via npm
57
70
  npm install -g @feng-h/pdca-skill
58
- # 或使用 npx 直接运行
71
+
72
+ # Or run directly with npx
59
73
  npx @feng-h/pdca-skill
60
74
  ```
61
75
 
62
- **方式 B：通过 Git 安装**
63
- ```bash
64
- # OpenClaw / Gemini CLI 环境
65
- gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
66
-
67
- # 或使用 skills 框架
68
- npx skills add Feng-H/PDCA-with-AI
69
- ```
76
+ ### Common Commands
70
77
 
71
- ### 2. 常用指令
72
- - **启动新项目**：输入 `new` 或提到「启动 PDCA 项目」。
73
- - **跟进进度**：输入 `ongoing` 查看活跃项目看板。
74
- - **借鉴经验**：输入 `achieve` 检索历史成功案例。
78
+ | Command | Description |
79
+ |---------|-------------|
80
+ | `new` | Start a new project |
81
+ | `ongoing` | View active project dashboard |
82
+ | `achieve` | Search historical success cases |
75
83
 
76
84
  ---
77
85
 
78
- ## 🛠️ 飞书集成概览
86
+ ## 日本語
79
87
 
80
- 基于 **OpenClaw Lark 插件**（官方插件，由飞书开放平台团队开发），系统拥有以下原生能力：
88
+ **PDCAサイクルに基づくAI強化型問題解決ワークフロー** — Feishu/Larkフルツールチェーン（Wiki + Bitable + Task + Calendar + Sheet）と統合され、AI主導の検査と品質検証を備えています。
81
89
 
82
- ### Core Workflow
90
+ ### 🎯 概要
83
91
 
84
- ```
85
- 🚀 PDCA项目管理系统
92
+ PDCA with AIは**タイムフロー駆動型**のプロジェクト管理システムです。古典的なPDCAサイクル（Plan-Do-Check-Act）とAIエージェントの能動的な能力を組み合わせ、Feishu APIを通じて「問題分析」から「知識蓄積」までの完全なクローズドループを実現します。
86
93
 
87
- 可用命令：
88
- - new ：启动新项目
89
- - ongoing : 选择进行中的项目
90
- - achieve : 选择已完成的项目
91
- ```
94
+ ### 主な機能
92
95
 
93
- ### 核心原则：一个项目 = 一个文件夹 = 一个 Bitable 应用
96
+ - **自律検査（The Loop）**：AIが自動的にクラウドドキュメントを読み取り、進捗を要約してBitableダッシュボードに同期
97
+ - **品質検証**：PlanフェーズでのSMART検証と因果ロジックチェーンレビュー
98
+ - **リアルタイムアラート**：論理の偏差や進捗の停滞を検出すると、AIが即座にFeishuインタラクティブカードを送信
99
+ - **知識アーカイブ**：プロジェクト完了後、AIが成功した施策を抽出して保存
100
+ - **製造業向け最適化**：OEE向上、不良率低減などの専門テンプレートを内蔵
94
101
 
95
- 每个 PDCA 项目的所有资源归**同一个飞书文件夹**，确保结构清晰、集中管理、便于追溯。
102
+ ### 🚀 クイックスタート
103
+
104
+ ```bash
105
+ # npmでインストール
106
+ npm install -g @feng-h/pdca-skill
96
107
 
97
- 使用 `feishu-create-doc` 的 `wiki_space` 或 `folder_token` 参数创建项目根文件夹，`title` 参数中使用 `/` 自动创建子文件夹层次（如 `项目A/Plan阶段/问题分析`）。
108
+ # またはnpxで直接実行
109
+ npx @feng-h/pdca-skill
110
+ ```
98
111
 
99
- ### 工具链能力矩阵
112
+ ### 一般コマンド
100
113
 
101
- | 工具 | 用途 | 核心 Skill |
102
- |------|------|-----------|
103
- | **Create Doc** | 创建云文档到指定文件夹/知识库 | `feishu-create-doc` (`wiki_space`, `folder_token`, `title` with `/`) |
104
- | **Update Doc** | 局部更新云文档 (append/replace_range/insert_before/after/delete_range/replace_all) | `feishu-update-doc` |
105
- | **Fetch Doc** | 读取云文档 Markdown 内容 | `feishu-fetch-doc` |
106
- | **Bitable** | 多维表格 CRUD + 批量操作 + 高级筛选 | `feishu-bitable` (27种字段类型) |
107
- | **Calendar** | 日程管理 + 忙闲查询 + 参会人管理 | `feishu-calendar` |
108
- | **Task** | 任务创建/查询/更新/完成 + 清单管理 | `feishu-task` |
109
- | **Sheet** | 电子表格创建/编辑 | `feishu-sheets` |
110
- | **IM Read** | 群聊/私聊历史读取 | `feishu-im-read` |
111
- | **Troubleshoot** | API 连通性/权限诊断 | `feishu-troubleshoot` |
114
+ | コマンド | 説明 |
115
+ |---------|------|
116
+ | `new` | 新規プロジェクトを開始 |
117
+ | `ongoing` | アクティブなプロジェクトダッシュボードを表示 |
118
+ | `achieve` | 過去の成功事例を検索 |
112
119
 
113
120
  ---
114
121
 
115
- ## 📚 文档创建指南
122
+ ## 📁 Project Structure
123
+
124
+ ```
125
+ PDCA-with-AI/
126
+ ├── SKILL.md # Main skill entry point
127
+ ├── assets/ # Documentation and tests
128
+ │ ├── references/ # Execution guides and API integration specs
129
+ │ ├── tests/ # Baseline tests and quality validation
130
+ │ └── templates/ # Project templates
131
+ ├── system/ # Core engine layer
132
+ │ ├── Agent/ # Plan/Do/Check/Act Agent prompts
133
+ │ └── 规范/ # SMART validation and causal logic modules
134
+ └── README.md
135
+ ```
116
136
 
117
- ### 文档创建规则
137
+ ## 📚 Documentation
118
138
 
119
- 1. **项目根文件夹**：首次创建项目时，用 `create-doc` 创建"项目信息.md"，指定 `wiki_space` 或 `folder_token`，`title` 设为 `[项目名称]/项目信息`，飞书自动创建 `[项目名称]` 文件夹
120
- 2. **阶段文档**：`title` 设为 `[项目名称]/Plan阶段/问题分析`，自动归入对应文件夹
121
- 3. **项目索引**：在根目录创建或更新，记录所有项目的名称、阶段、状态、Bitable链接
139
+ - [飞书集成指南](assets/references/feishu-integration.md) - Feishu/Lark API Integration
140
+ - [质量标准](assets/tests/) - Quality Standards & Testing
141
+ - [GitHub Repository](https://github.com/Feng-H/PDCA-with-AI)
122
142
 
123
- ### 文档更新规则
143
+ ## 📄 License
124
144
 
125
- 使用 `feishu-update-doc` 更新已有文档：
126
- - 优先使用**局部更新**（`replace_range`/`append`/`insert_before`/`insert_after`）保护图片和评论
127
- - 慎用 `overwrite`（会清空文档重写）
145
+ [MIT](LICENSE)
128
146
 
129
147
  ---
130
148
 
131
- **由 AI 驱动，让 PDCA 循环真正「转」起来！**
149
+ **Powered by AI, making PDCA cycles truly spin!** / **由 AI 驱动，让 PDCA 循环真正「转」起来！** / **AI で駆動され、PDCA サイクルを本当に回す！**
package/bin/pdca.js ADDED
@@ -0,0 +1,41 @@
1
+ #!/usr/bin/env node
2
+
3
+ console.log(`
4
+ ╔══════════════════════════════════════════════════════════════╗
5
+ ║ ║
6
+ ║ 🚀 PDCA with AI - AI-Driven Project Management System ║
7
+ ║ ║
8
+ ╚══════════════════════════════════════════════════════════════╝
9
+
10
+ 📦 Installation
11
+ ────────────────────────────────────────────────────────────────
12
+
13
+ This is a documentation skill package for AI CLI tools.
14
+
15
+ Install via Gemini CLI / OpenClaw:
16
+
17
+ gemini skills install https://github.com/Feng-H/PDCA-with-AI.git
18
+
19
+ Or via skills framework:
20
+
21
+ npx skills add Feng-H/PDCA-with-AI
22
+
23
+ 📚 Documentation
24
+ ────────────────────────────────────────────────────────────────
25
+
26
+ • GitHub: https://github.com/Feng-H/PDCA-with-AI
27
+ • npm: https://www.npmjs.com/package/@feng-h/pdca-skill
28
+
29
+ 📖 Usage
30
+ ────────────────────────────────────────────────────────────────
31
+
32
+ Once installed in your AI CLI, use these commands:
33
+
34
+ new - Start a new PDCA project
35
+ ongoing - View active project dashboard
36
+ achieve - Search historical success cases
37
+
38
+ ────────────────────────────────────────────────────────────────
39
+ Powered by AI | 让 PDCA 循环真正「转」起来！
40
+ ────────────────────────────────────────────────────────────────
41
+ `);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@feng-h/pdca-skill",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
4
4
  "description": "PDCA project management system for Feishu/Lark integration with AI-driven workflow",
5
5
  "keywords": [
6
6
  "skills",
@@ -21,6 +21,9 @@
21
21
  "url": "https://github.com/Feng-H/PDCA-with-AI/issues"
22
22
  },
23
23
  "homepage": "https://github.com/Feng-H/PDCA-with-AI#readme",
24
+ "bin": {
25
+ "pdca-skill": "./bin/pdca.js"
26
+ },
24
27
  "files": [
25
28
  "SKILL.md",
26
29
  "assets/",
@@ -30,9 +33,9 @@
30
33
  ],
31
34
  "scripts": {
32
35
  "version": "git add package.json",
33
- "postversion": "git push --follow-tags",
34
- "release:patch": "npm version patch && git push --follow-tags",
35
- "release:minor": "npm version minor && git push --follow-tags",
36
- "release:major": "npm version major && git push --follow-tags"
36
+ "postversion": "git push --follow-tags && npm publish --access public",
37
+ "release:patch": "npm version patch",
38
+ "release:minor": "npm version minor",
39
+ "release:major": "npm version major"
37
40
  }
38
41
  }