pdd-skills 3.1.3 → 3.1.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.
- package/README.md +477 -1283
- package/config/cdp-test-config.yaml +359 -0
- package/config/test-actions.yaml +712 -0
- package/docs/cdp-testing-framework-design.md +535 -0
- package/docs/pdd-skills-v3-/346/225/264/344/275/223/345/210/206/346/236/220/346/212/245/345/221/212.md +0 -1
- package/docs/superpowers/specs/2026-05-08-pdd-test-skill-design.md +943 -0
- package/package.json +1 -3
- package/scaffolds/python-fullstack/frontend/src/main.ts +1 -1
- package/skills/expert/expert-bug-fixer/SKILL.md +241 -241
- package/skills/expert/expert-bug-fixer/_meta.json +1 -1
- package/skills/expert/expert-bug-fixer/config/code-conflict-rules.yaml +512 -0
- package/skills/expert/expert-bug-fixer/config/debug-decision-tree.yaml +537 -0
- package/skills/expert/expert-bug-fixer/config/fix-risk-matrix.yaml +544 -0
- package/skills/expert/expert-bug-fixer/config/hypothesis-validation.md +262 -0
- package/skills/expert/expert-bug-fixer/templates/case-template.md +440 -0
- package/skills/expert/pilot-validation-guide.md +345 -0
- package/skills/expert/testcase-agent/SKILL.md +358 -0
- package/skills/expert/testcase-agent/_meta.json +1 -0
- package/skills/expert/testcase-agent/evals/default-evals.json +1 -0
- package/skills/expert/testcase-agent/references/cli-reference.md +845 -0
- package/skills/expert/testcase-agent/references/error-handling.md +607 -0
- package/skills/expert/testcase-agent/references/iron-rules-detail.md +622 -0
- package/skills/expert/testcase-agent/references/self-healing-strategy.md +663 -0
- package/skills/expert/testcase-agent/templates/report-template.html +396 -0
- package/skills/expert/testcase-modeler/SKILL.md +653 -0
- package/skills/expert/testcase-modeler/_meta.json +1 -0
- package/skills/expert/testcase-modeler/evals/default-evals.json +1 -0
- package/skills/expert/testcase-modeler/examples/asset-eval-apply.yaml +188 -0
- package/skills/expert/testcase-modeler/examples/asset-eval-approval-flow.yaml +289 -0
- package/skills/expert/testcase-modeler/examples/login-flow.yaml +163 -0
- package/skills/expert/expert-testcases/LICENSE +0 -21
- package/skills/expert/expert-testcases/SKILL.md +0 -298
- package/skills/expert/expert-testcases/_meta.json +0 -1
- package/skills/expert/expert-testcases/evals/coverage_targets.md +0 -158
- package/skills/expert/expert-testcases/evals/quality_rubric.md +0 -128
- package/skills/expert/expert-testcases/examples/zccz-1-equity-transfer/snapshot-input.md +0 -91
- package/skills/expert/expert-testcases/examples/zccz-1-equity-transfer/snapshot-output.md +0 -165
- package/skills/expert/expert-testcases/references/api-testing-patterns.md +0 -80
- package/skills/expert/expert-testcases/references/coverage-best-practices.md +0 -66
- package/skills/expert/expert-testcases/references/methodology.md +0 -111
- package/skills/expert/expert-testcases/references/ruoyi-testing-guide.md +0 -101
- package/skills/expert/expert-testcases/references/workflow-testing-patterns.md +0 -95
- package/skills/expert/expert-testcases/scripts/analyze_source.py +0 -178
- package/skills/expert/expert-testcases/scripts/build_matrix.py +0 -192
- package/skills/expert/expert-testcases/scripts/extract_api.py +0 -197
- package/skills/expert/expert-testcases/scripts/validate_output.py +0 -225
- package/skills/expert/expert-testcases/templates/code/python/api_helper.py.j2 +0 -109
- package/skills/expert/expert-testcases/templates/code/python/config.py.j2 +0 -24
- package/skills/expert/expert-testcases/templates/code/python/conftest.py.j2 +0 -151
- package/skills/expert/expert-testcases/templates/code/python/pytest.ini.j2 +0 -19
- package/skills/expert/expert-testcases/templates/code/python/requirements.txt.j2 +0 -10
- package/skills/expert/expert-testcases/templates/code/python/test_approval.py.j2 +0 -80
- package/skills/expert/expert-testcases/templates/code/python/test_boundary.py.j2 +0 -152
- package/skills/expert/expert-testcases/templates/code/python/test_crud.py.j2 +0 -48
- package/skills/expert/expert-testcases/templates/code/python/test_e2e.py.j2 +0 -110
- package/skills/expert/expert-testcases/templates/code/python/test_integration.py.j2 +0 -90
- package/skills/expert/expert-testcases/templates/code/python/test_performance.py.j2 +0 -107
- package/skills/expert/expert-testcases/templates/data/test-data.yaml.j2 +0 -105
- package/skills/expert/expert-testcases/templates/data/users.yaml.j2 +0 -43
- package/skills/expert/expert-testcases/templates/docs/api-testcase.md.j2 +0 -72
- package/skills/expert/expert-testcases/templates/docs/boundary-testcase.md.j2 +0 -52
- package/skills/expert/expert-testcases/templates/docs/e2e-testcase.md.j2 +0 -56
- package/skills/expert/expert-testcases/templates/docs/integration-testcase.md.j2 +0 -56
- package/skills/expert/expert-testcases/templates/docs/performance-testcase.md.j2 +0 -61
- package/skills/expert/expert-testcases/templates/docs/readme.md.j2 +0 -110
- package/skills/expert/expert-testcases/templates/docs/ui-testcase.md.j2 +0 -59
package/README.md
CHANGED
|
@@ -1,682 +1,371 @@
|
|
|
1
1
|
# PDD-Skills v3.0
|
|
2
2
|
|
|
3
|
-
[](https://github.com/pdd-skills/pdd-skills)
|
|
4
|
-
[](https://nodejs.org/)
|
|
5
|
-
[](LICENSE)
|
|
6
|
-
[](config/bug-patterns.yaml)
|
|
7
|
-
[](config/prd-rules.yaml)
|
|
8
|
-
[](skills/)
|
|
9
|
-
|
|
10
|
-
> **PRD 驱动的 AI 原生软件开发工作流框架**
|
|
11
|
-
>
|
|
12
3
|
> 从需求文档到代码交付的全链路自动化平台 — **7 大 Phase**、**41+ 技能**、**14 个 Bug 模式**、**30 条 PRD 规则**、**4 级质量门控**
|
|
4
|
+
>
|
|
5
|
+
> **English**: End-to-end automation platform from PRD to code delivery — **7 Phases**, **41+ Skills**, **14 Bug Patterns**, **30 PRD Rules**, **4-Level Quality Gates**
|
|
13
6
|
|
|
14
7
|
***
|
|
15
8
|
|
|
16
|
-
## 目录
|
|
17
|
-
|
|
18
|
-
- [什么是 PDD-Skills？](#什么是-pdd-skills)
|
|
19
|
-
- [核心特性](
|
|
20
|
-
- [快速开始](
|
|
21
|
-
- [CLI 命令大全](#cli
|
|
22
|
-
- [七大 Phase 架构](#七大-phase
|
|
23
|
-
- [Phase 1: 基础设施建设](#phase-1
|
|
24
|
-
- [Phase 2: 核心能力增强](#phase-2
|
|
25
|
-
- [Phase 3: 专家系统扩展](#phase-3
|
|
26
|
-
- [Phase 4: 平台化建设](#phase-4
|
|
27
|
-
- [Phase 5: 智能化升级](#phase-5
|
|
28
|
-
- [Phase 6: 生态建设](#phase-6
|
|
29
|
-
- [📊 Phase 7: PDD Visual Manager](#-phase-7-pdd-visual-manager)
|
|
30
|
-
- [技能系统](
|
|
31
|
-
- [配置中心](
|
|
32
|
-
- [API 层](#api
|
|
33
|
-
- [MCP 协议集成](#mcp
|
|
34
|
-
- [SDK 使用指南](#sdk
|
|
35
|
-
- [智能引擎](
|
|
36
|
-
- [插件系统](
|
|
37
|
-
- [OpenClaw 集成](#openclaw
|
|
38
|
-
- [项目结构](
|
|
39
|
-
- [配置说明](
|
|
40
|
-
- [开发指南](
|
|
41
|
-
- [版本历史](
|
|
9
|
+
## 目录 / Table of Contents
|
|
10
|
+
|
|
11
|
+
- [什么是 PDD-Skills？ / What is PDD-Skills?](#什么是-pdd-skills--what-is-pdd-skills)
|
|
12
|
+
- [核心特性 / Core Features](#核心特性--core-features)
|
|
13
|
+
- [快速开始 / Quick Start](#快速开始--quick-start)
|
|
14
|
+
- [CLI 命令大全 / CLI Commands](#cli-命令大全--cli-commands)
|
|
15
|
+
- [七大 Phase 架构 / Seven Phase Architecture](#七大-phase-架构--seven-phase-architecture)
|
|
16
|
+
- [Phase 1: 基础设施建设 / Infrastructure](#phase-1-基础设施建设--infrastructure)
|
|
17
|
+
- [Phase 2: 核心能力增强 / Core Capabilities](#phase-2-核心能力增强--core-capabilities)
|
|
18
|
+
- [Phase 3: 专家系统扩展 / Expert Systems](#phase-3-专家系统扩展--expert-systems)
|
|
19
|
+
- [Phase 4: 平台化建设 / Platformization](#phase-4-平台化建设--platformization)
|
|
20
|
+
- [Phase 5: 智能化升级 / Intelligence Upgrade](#phase-5-智能化升级--intelligence-upgrade)
|
|
21
|
+
- [Phase 6: 生态建设 / Ecosystem](#phase-6-生态建设--ecosystem)
|
|
22
|
+
- [📊 Phase 7: PDD Visual Manager / Visual Manager](#-phase-7-pdd-visual-manager--visual-manager)
|
|
23
|
+
- [技能系统 / Skill System](#技能系统--skill-system)
|
|
24
|
+
- [配置中心 / Configuration Center](#配置中心--configuration-center)
|
|
25
|
+
- [API 层 / API Layer](#api-层--api-layer)
|
|
26
|
+
- [MCP 协议集成 / MCP Protocol Integration](#mcp-协议集成--mcp-protocol-integration)
|
|
27
|
+
- [SDK 使用指南 / SDK Guide](#sdk-使用指南--sdk-guide)
|
|
28
|
+
- [智能引擎 / Intelligence Engine](#智能引擎--intelligence-engine)
|
|
29
|
+
- [插件系统 / Plugin System](#插件系统--plugin-system)
|
|
30
|
+
- [OpenClaw 集成 / OpenClaw Integration](#openclaw-集成--openclaw-integration)
|
|
31
|
+
- [项目结构 / Project Structure](#项目结构--project-structure)
|
|
32
|
+
- [配置说明 / Configuration](#配置说明--configuration)
|
|
33
|
+
- [开发指南 / Development Guide](#开发指南--development-guide)
|
|
34
|
+
- [版本历史 / Version History](#版本历史--version-history)
|
|
42
35
|
|
|
43
36
|
***
|
|
44
37
|
|
|
45
|
-
## 什么是 PDD-Skills？
|
|
38
|
+
## 什么是 PDD-Skills？ / What is PDD-Skills?
|
|
46
39
|
|
|
47
40
|
**PDD (PRD-Driven Development)** 是一种以 **产品需求文档 (PRD)** 为驱动的 AI 原生软件开发方法论。PDD-Skills 是该方法的完整工具链实现，覆盖从需求分析到代码交付的完整生命周期。
|
|
48
41
|
|
|
49
|
-
|
|
42
|
+
> **English**: **PDD (PRD-Driven Development)** is an AI-native software development methodology driven by **Product Requirement Documents (PRD)**. PDD-Skills is the complete toolchain implementation of this method, covering the full lifecycle from requirements analysis to code delivery.
|
|
43
|
+
|
|
44
|
+
### 核心理念 / Core Philosophy
|
|
50
45
|
|
|
51
46
|
```
|
|
52
47
|
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
|
53
48
|
│ PRD 文档 │───▶│ 特征提取 │───▶│ 规格生成 │───▶│ 代码实现 │───▶│ 验证报告 │
|
|
54
|
-
│
|
|
55
|
-
│
|
|
49
|
+
│ PRD Doc │ │ Extract │ │ Generate │ │ Implement │ │ Verify │
|
|
50
|
+
│ pdd-ba │ │ pdd-extract │ │ pdd-generate│ │ pdd-implement│ │ pdd-verify │
|
|
56
51
|
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
|
|
57
52
|
▲ ▲ ▲ ▲ ▲
|
|
58
53
|
│ │ │ │ │
|
|
59
54
|
业务分析师 AI Agent AI Agent 开发者 QA
|
|
55
|
+
Business Analyst AI Agent AI Agent Developer QA
|
|
60
56
|
```
|
|
61
57
|
|
|
62
|
-
### 为什么选择 PDD-Skills？
|
|
58
|
+
### 为什么选择 PDD-Skills？ / Why PDD-Skills?
|
|
63
59
|
|
|
64
|
-
| 特性
|
|
60
|
+
| 特性 / Feature | 传统开发 / Traditional | TDD | **PDD-Skills** |
|
|
65
61
|
| ----- | ---- | ---- | -------------------------- |
|
|
66
|
-
| 驱动文档
|
|
67
|
-
| AI 原生 | ❌
|
|
68
|
-
| 双语支持
|
|
69
|
-
| 行为塑造
|
|
70
|
-
| 质量门禁
|
|
71
|
-
| 可视化监控 | ❌
|
|
72
|
-
| 插件扩展
|
|
73
|
-
| 多协议
|
|
62
|
+
| 驱动文档 / Driver Doc | 无/弱 / None/Weak | 测试用例 / Test Cases | **PRD 需求文档 / PRD Docs** |
|
|
63
|
+
| AI 原生 / AI Native | ❌ | ❌ | ✅ **深度集成 / Deep Integration** |
|
|
64
|
+
| 双语支持 / Bilingual | ❌ | ❌ | ✅ **🇨🇳🇺🇸 中英双语 / CN/EN** |
|
|
65
|
+
| 行为塑造 / Behavior Shaping | ❌ | ❌ | ✅ **Iron Law + Red Flags** |
|
|
66
|
+
| 质量门禁 / Quality Gates | 弱 / Weak | 强 / Strong | ✅ **5维评分 + Linter / 5D Scoring** |
|
|
67
|
+
| 可视化监控 / Visualization | ❌ | ❌ | ✅ **PDD Visual Manager** |
|
|
68
|
+
| 插件扩展 / Plugins | 有限 / Limited | 有限 / Limited | ✅ **沙箱隔离插件系统 / Sandbox Plugins** |
|
|
69
|
+
| 多协议 / Multi-Protocol | 单一 / Single | 无 / None | ✅ **REST + MCP + gRPC** |
|
|
74
70
|
|
|
75
71
|
***
|
|
76
72
|
|
|
77
|
-
## 核心特性
|
|
73
|
+
## 核心特性 / Core Features
|
|
74
|
+
|
|
75
|
+
### 🎯 七大能力矩阵 / Seven Capability Matrix
|
|
78
76
|
|
|
79
|
-
|
|
77
|
+
> **English**: **PDD-Skills v3.0 Capability Panorama**
|
|
80
78
|
|
|
81
79
|
```
|
|
82
80
|
┌─────────────────────────────────────────────────────────────────────────────────┐
|
|
83
|
-
│ PDD-Skills v3.0 能力全景图
|
|
81
|
+
│ PDD-Skills v3.0 能力全景图 / Capability Panorama │
|
|
84
82
|
├─────────────────────────────────────────────────────────────────────────────────┤
|
|
85
83
|
│ │
|
|
86
84
|
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
|
87
85
|
│ │ Phase 1 │ │ Phase 2 │ │ Phase 3 │ │ Phase 4 │ │
|
|
88
86
|
│ │ 基础设施 │ │ 核心能力 │ │ 专家系统 │ │ 平台化 │ │
|
|
89
|
-
│ │
|
|
90
|
-
│ │ • npx安装
|
|
91
|
-
│ │ • Linter
|
|
92
|
-
│ │ • Hook
|
|
93
|
-
│ │ • Evals
|
|
94
|
-
│ │
|
|
95
|
-
│ └──────────┘ │ • Evals
|
|
87
|
+
│ │Infrastructure│Core Capabilities│Expert Systems│Platformization│ │
|
|
88
|
+
│ │ • npx安装 │ │ • 11核心 │ │ • 安全 │ │ • CLI │ │
|
|
89
|
+
│ │ • Linter │ │ 技能 │ │ • 性能 │ │ • API │ │
|
|
90
|
+
│ │ • Hook │ │ • i18n │ │ 专家 │ │ • MCP │ │
|
|
91
|
+
│ │ • Evals │ │ • CSO │ │ │ │ • JS SDK │ │
|
|
92
|
+
│ │ │ │ • Token │ │ │ │ • Python │ │
|
|
93
|
+
│ └──────────┘ │ • Evals │ └──────────┘ │ • gRPC │ │
|
|
96
94
|
│ └──────────┘ └──────────┘ │
|
|
97
95
|
│ │
|
|
98
96
|
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
|
99
97
|
│ │ Phase 5 │ │ Phase 6 │ │ Phase 7 │ │
|
|
100
98
|
│ │ 智能化 │ │ 生态建设 │ │ VM可视化 │ │
|
|
101
|
-
│ │
|
|
102
|
-
│ │ •
|
|
103
|
-
│ │ • Token
|
|
104
|
-
│ │ 预算
|
|
105
|
-
│ │ •
|
|
106
|
-
│ │ •
|
|
99
|
+
│ │Intelligence│Ecosystem │Visualization│ │
|
|
100
|
+
│ │ • 三级缓存 │ │ • 插件 │ │ • Web │ │
|
|
101
|
+
│ │ • Token │ │ 系统 │ │ Dashboard│ │
|
|
102
|
+
│ │ 预算 │ │ • OpenClaw│ │ • TUI │ │
|
|
103
|
+
│ │ • 质量评分 │ │ • 社区文档 │ │ • SSE │ │
|
|
104
|
+
│ │ • 迭代优化 │ │ │ │ • Canvas │ │
|
|
107
105
|
│ └──────────┘ └──────────┘ └──────────┘ │
|
|
108
106
|
│ │
|
|
109
107
|
└─────────────────────────────────────────────────────────────────────────────────┘
|
|
110
108
|
```
|
|
111
109
|
|
|
112
|
-
###
|
|
113
|
-
|
|
114
|
-
> **PDD-Skills v3.0.1+ 新增内置脚手架系统**,提供生产级全栈项目模板,支持从零到一的快速项目初始化。
|
|
115
|
-
|
|
116
|
-
#### 可用模板
|
|
117
|
-
|
|
118
|
-
| 模板名称 | 技术栈 | 适用场景 | 状态 |
|
|
119
|
-
| --------------- | --------------------------------------- | ------------- | ----- |
|
|
120
|
-
| **python-fullstack** | FastAPI + Vue3 + TypeScript + TailwindCSS | 企业级全栈 Web 应用 | ✅ 稳定版 |
|
|
121
|
-
|
|
122
|
-
#### 核心能力矩阵
|
|
123
|
-
|
|
124
|
-
```
|
|
125
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
126
|
-
│ python-fullstack 模板能力矩阵 │
|
|
127
|
-
├─────────────────────────────────────────────────────────────────────────────┤
|
|
128
|
-
│ │
|
|
129
|
-
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
|
|
130
|
-
│ │ data_permission │ │ oauth_sso │ │ workflow_engine │ │
|
|
131
|
-
│ │ 数据权限引擎 │ │ OAuth2 六平台认证 │ │ 工作流状态机引擎 │ │
|
|
132
|
-
│ │ │ │ │ │ │ │
|
|
133
|
-
│ │ • 组织级数据隔离 │ │ • 企业微信 │ │ • 15种状态定义 │ │
|
|
134
|
-
│ │ • 借调合并机制 │ │ • 钉钉 │ │ • 会签/或签 │ │
|
|
135
|
-
│ │ • 行级权限控制 │ │ • 飞书 │ │ • 条件分支路由 │ │
|
|
136
|
-
│ │ │ │ • 微信公众号 │ │ • 回退/撤回 │ │
|
|
137
|
-
│ │ │ │ • OIDC 通用 │ │ • 定时任务触发 │ │
|
|
138
|
-
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
|
|
139
|
-
│ │
|
|
140
|
-
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
141
|
-
│ │ responsive_ui │ │
|
|
142
|
-
│ │ 响应式前端系统 │ │
|
|
143
|
-
│ │ │ │
|
|
144
|
-
│ │ PC端 (≥1280px) → 平板 (768-1279px) → 大屏手机 (≤767px) │ │
|
|
145
|
-
│ │ 6档断点自适应 · 组件级响应式 · 暗色模式支持 │ │
|
|
146
|
-
│ └─────────────────────────────────────────────────────────┘ │
|
|
147
|
-
│ │
|
|
148
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
#### 技术栈详情
|
|
152
|
-
|
|
153
|
-
| 层面 | 技术选型 | 版本要求 |
|
|
154
|
-
| ---------- | ---------------------------------------- | --------- |
|
|
155
|
-
| **后端框架** | Python FastAPI | 3.11+ |
|
|
156
|
-
| **ORM** | SQLAlchemy [asyncio] | 2.x+ |
|
|
157
|
-
| **数据库** | MySQL | 8.0+ |
|
|
158
|
-
| **前端框架** | Vue3 + Vite + TypeScript | 3.x+ |
|
|
159
|
-
| **UI 框架** | TailwindCSS | 3.x+ |
|
|
160
|
-
| **容器化** | Docker + docker-compose | 最新稳定版 |
|
|
161
|
-
| **CI/CD** | GitHub Actions / GitLab CI | - |
|
|
110
|
+
### 📊 关键数据 / Key Metrics
|
|
162
111
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
docker-compose up -d
|
|
177
|
-
|
|
178
|
-
# 5️⃣ 启动后端服务
|
|
179
|
-
cd backend && uvicorn main:app --reload --port 8000
|
|
180
|
-
|
|
181
|
-
# 6️⃣ 启动前端服务
|
|
182
|
-
cd frontend && npm run dev
|
|
183
|
-
```
|
|
184
|
-
|
|
185
|
-
#### 模板目录结构预览
|
|
186
|
-
|
|
187
|
-
```
|
|
188
|
-
scaffolds/python-fullstack/
|
|
189
|
-
├── template_config.yaml # 模板元数据 & Hooks 配置
|
|
190
|
-
├── README.md # 模板使用指南
|
|
191
|
-
├── docs/
|
|
192
|
-
│ ├── architecture-design.md # 架构设计文档
|
|
193
|
-
│ ├── database-design.md # 数据库设计文档
|
|
194
|
-
│ ├── api-design.md # API 设计文档
|
|
195
|
-
│ └── deployment-guide.md # 部署指南
|
|
196
|
-
├── backend/
|
|
197
|
-
│ ├── app/
|
|
198
|
-
│ │ ├── core/ # 核心模块 (data_permission/oauth_sso/workflow_engine)
|
|
199
|
-
│ │ ├── api/ # API 路由层
|
|
200
|
-
│ │ ├── models/ # SQLAlchemy 数据模型
|
|
201
|
-
│ │ ├── schemas/ # Pydantic 请求/响应模型
|
|
202
|
-
│ │ └── services/ # 业务逻辑层
|
|
203
|
-
│ ├── alembic/ # 数据库迁移
|
|
204
|
-
│ ├── tests/ # 单元测试 & 集成测试
|
|
205
|
-
│ └── requirements.txt
|
|
206
|
-
├── frontend/
|
|
207
|
-
│ ├── src/
|
|
208
|
-
│ │ ├── views/ # 页面组件 (响应式布局)
|
|
209
|
-
│ │ ├── components/ # UI 组件库
|
|
210
|
-
│ │ ├── stores/ # Pinia 状态管理
|
|
211
|
-
│ │ ├── api/ # API 请求封装
|
|
212
|
-
│ │ └── utils/ # 工具函数
|
|
213
|
-
│ ├── tailwind.config.js # 6档断点配置
|
|
214
|
-
│ └── vite.config.ts
|
|
215
|
-
├── docker-compose.yml # 一键部署编排
|
|
216
|
-
├── .github/workflows/ # CI 流水线
|
|
217
|
-
└── config/ # 环境配置文件
|
|
218
|
-
```
|
|
219
|
-
|
|
220
|
-
#### 质量保证
|
|
221
|
-
|
|
222
|
-
✅ 已通过 **4 项代码质量修复验证**:
|
|
223
|
-
- 数据库连接池配置优化
|
|
224
|
-
- 安全异常处理完善
|
|
225
|
-
- datetime 弃用 API 替换
|
|
226
|
-
- SQLAlchemy 异步 API 正确性校验
|
|
227
|
-
|
|
228
|
-
---
|
|
229
|
-
|
|
230
|
-
### 📊 关键数据
|
|
231
|
-
|
|
232
|
-
| 指标 | 数值 |
|
|
233
|
-
| ----------- | --------------------------------------------- |
|
|
234
|
-
| **版本** | v3.1.2 |
|
|
235
|
-
| **核心技能** | 12 个（全双语 🇨🇳🇺🇸） |
|
|
236
|
-
| **专家技能** | 12 个（安全/性能/MySQL/若依/若依权限/Activiti/Vue3/微服务/Bug修复/测试/架构） |
|
|
237
|
-
| **熵减技能** | 4 个（审计 + 架构约束 + 代码质量 + 自动重构） |
|
|
238
|
-
| **OpenSpec技能**| 10 个（变更管理全生命周期） |
|
|
239
|
-
| **PR技能** | 7 个（模板引擎 + 多轮审查 + PR创建/审查/合并/批量/任务管理） |
|
|
240
|
-
| **Bug模式库** | 14 个（7通用 + 7若依专用），集中式管理 `config/bug-patterns.yaml` |
|
|
241
|
-
| **PRD规则** | 30 条（6大类），集中式管理 `config/prd-rules.yaml` |
|
|
242
|
-
| **质量门控** | 4级（Blocker/Critical/Warning/Info）+ 0-100评分 |
|
|
243
|
-
| **协议支持** | RESTful + MCP + gRPC + SSE |
|
|
244
|
-
| **SDK 语言** | JavaScript + Python |
|
|
112
|
+
| 指标 / Metric | 数值 / Value |
|
|
113
|
+
| -------------- | ------------------------------------------------------- |
|
|
114
|
+
| **版本 / Version** | v3.1.2 |
|
|
115
|
+
| **核心技能 / Core Skills** | 12 个（全双语 / Full Bilingual 🇨🇳🇺🇸） |
|
|
116
|
+
| **专家技能 / Expert Skills** | 12 个（安全/性能/MySQL/若依/若依权限/Activiti/Vue3/微服务/Bug修复/测试/架构） |
|
|
117
|
+
| **熵减技能 / Entropy Skills** | 4 个（审计 + 架构约束 + 代码质量 + 自动重构） |
|
|
118
|
+
| **OpenSpec技能 / OpenSpec Skills** | 10 个（变更管理全生命周期 / Full Lifecycle） |
|
|
119
|
+
| **PR技能 / PR Skills** | 7 个（模板引擎 + 多轮审查 + PR创建/审查/合并/批量/任务管理） |
|
|
120
|
+
| **Bug模式库 / Bug Patterns** | 14 个（7通用 + 7若依专用），集中式管理 `config/bug-patterns.yaml` |
|
|
121
|
+
| **PRD规则 / PRD Rules** | 30 条（6大类 / 6 Categories），集中式管理 `config/prd-rules.yaml` |
|
|
122
|
+
| **质量门控 / Quality Gates** | 4级（Blocker/Critical/Warning/Info）+ 0-100评分 |
|
|
123
|
+
| **协议支持 / Protocols** | RESTful + MCP + gRPC + SSE |
|
|
124
|
+
| **SDK 语言 / SDK Languages** | JavaScript + Python |
|
|
245
125
|
|
|
246
126
|
***
|
|
247
127
|
|
|
248
|
-
## 快速开始
|
|
128
|
+
## 快速开始 / Quick Start
|
|
249
129
|
|
|
250
|
-
### 安装
|
|
130
|
+
### 安装 / Installation
|
|
251
131
|
|
|
252
132
|
```bash
|
|
253
|
-
#
|
|
133
|
+
# 全局安装（推荐 / Recommended）
|
|
254
134
|
npm install -g pdd-skills
|
|
255
135
|
|
|
256
|
-
# 或本地安装
|
|
136
|
+
# 或本地安装 / Or local install
|
|
257
137
|
npm install pdd-skills
|
|
258
138
|
```
|
|
259
139
|
|
|
260
140
|
<details>
|
|
261
|
-
<summary>⚙️
|
|
141
|
+
<summary>⚙️ 环境要求 / Environment Requirements</summary>
|
|
262
142
|
|
|
263
|
-
- **Node.js**: >= 18.0.0 (ESM 模块支持)
|
|
264
|
-
-
|
|
265
|
-
-
|
|
143
|
+
- **Node.js**: >= 18.0.0 (ESM 模块支持 / ESM Module Support)
|
|
144
|
+
- **操作系统 / OS**: Windows / macOS / Linux
|
|
145
|
+
- **依赖 / Dependencies**: commander ^12.0.0, chalk ^5.3.0, fs-extra ^11.2.0, yaml ^2.3.0
|
|
266
146
|
|
|
267
147
|
</details>
|
|
268
148
|
|
|
269
|
-
### 5 分钟上手
|
|
149
|
+
### 5 分钟上手 / 5-Minute Quickstart
|
|
270
150
|
|
|
271
151
|
```bash
|
|
272
|
-
# 1️⃣ 初始化项目
|
|
152
|
+
# 1️⃣ 初始化项目 / Initialize project
|
|
273
153
|
pdd init my-project
|
|
274
154
|
cd my-project
|
|
275
155
|
|
|
276
|
-
# 2️⃣ 查看可用技能
|
|
156
|
+
# 2️⃣ 查看可用技能 / List available skills
|
|
277
157
|
pdd list --json
|
|
278
158
|
|
|
279
|
-
# 3️⃣ 编写你的 PRD
|
|
159
|
+
# 3️⃣ 编写你的 PRD 文档（或使用模板）/ Write your PRD (or use template)
|
|
280
160
|
cp templates/prd-template.prdx ./my-feature.prdx
|
|
281
161
|
|
|
282
|
-
# 4️⃣ 提取功能特征
|
|
162
|
+
# 4️⃣ 提取功能特征 / Extract features
|
|
283
163
|
npx pdd-skills extract-features ./my-feature.prdx
|
|
284
164
|
|
|
285
|
-
# 5️⃣ 生成开发规格
|
|
165
|
+
# 5️⃣ 生成开发规格 / Generate specifications
|
|
286
166
|
npx pdd-skills generate-spec ./my-feature.prdx -o ./specs
|
|
287
167
|
|
|
288
|
-
# 6️⃣ 基于规格生成代码骨架
|
|
168
|
+
# 6️⃣ 基于规格生成代码骨架 / Generate code skeleton
|
|
289
169
|
pdd generate -s ./specs/spec.md -o ./src --dry-run
|
|
290
170
|
|
|
291
|
-
# 7️⃣ 验证实现
|
|
171
|
+
# 7️⃣ 验证实现 / Verify implementation
|
|
292
172
|
pdd verify -s ./specs/spec.md -c ./src --json
|
|
293
173
|
|
|
294
|
-
# 8️⃣ 生成质量报告
|
|
174
|
+
# 8️⃣ 生成质量报告 / Generate quality report
|
|
295
175
|
pdd report -t html -o ./reports
|
|
296
176
|
```
|
|
297
177
|
|
|
298
|
-
<br />
|
|
299
|
-
|
|
300
|
-
```bash
|
|
301
|
-
```
|
|
302
|
-
|
|
303
178
|
***
|
|
304
179
|
|
|
305
|
-
## CLI 命令大全
|
|
306
|
-
|
|
307
|
-
PDD-Skills 提供丰富的 CLI 命令，覆盖完整的开发生命周期和可视化监控。
|
|
308
|
-
|
|
309
|
-
### 项目管理
|
|
310
|
-
|
|
311
|
-
```bash
|
|
312
|
-
pdd init [path] # 初始化项目目录结构
|
|
313
|
-
pdd update [--version] # 更新技能到最新版本
|
|
314
|
-
pdd list [-c category] # 列出所有技能（core/expert/openspec）
|
|
315
|
-
pdd version # 显示版本信息
|
|
316
|
-
```
|
|
317
|
-
|
|
318
|
-
### 开发流程
|
|
319
|
-
|
|
320
|
-
```bash
|
|
321
|
-
# 规格与代码
|
|
322
|
-
pdd generate -s spec.md -o ./src --dry-run # 代码生成（预览模式）
|
|
323
|
-
pdd verify -s spec.md -c ./src --json # 功能验证
|
|
324
|
-
pdd report -t html|json|md -o ./reports # 报告生成
|
|
325
|
-
|
|
326
|
-
# 质量门禁
|
|
327
|
-
pdd linter -t java|js|python|sql|prd|skill|all -f ./src
|
|
328
|
-
pdd eval -c core|expert # 运行评估测试
|
|
329
|
-
pdd token -f ./src # Token 效率分析
|
|
330
|
-
|
|
331
|
-
# 国际化
|
|
332
|
-
pdd i18n -c core|expert|all # 双语合规检查
|
|
333
|
-
pdd cso # 触发准确率分析
|
|
334
|
-
```
|
|
180
|
+
## CLI 命令大全 / CLI Commands
|
|
335
181
|
|
|
336
|
-
###
|
|
182
|
+
### 项目管理 / Project Management
|
|
337
183
|
|
|
338
184
|
```bash
|
|
339
|
-
#
|
|
340
|
-
pdd
|
|
341
|
-
pdd
|
|
342
|
-
|
|
343
|
-
# Terminal TUI
|
|
344
|
-
pdd tui # 启动 Terminal TUI
|
|
345
|
-
|
|
346
|
-
# VM 数据查询
|
|
347
|
-
pdd vm status # 项目状态摘要
|
|
348
|
-
pdd vm features # 功能点列表
|
|
349
|
-
pdd vm export --format csv # 导出数据
|
|
185
|
+
pdd init [path] # 初始化项目目录结构 / Initialize project
|
|
186
|
+
pdd update [--version] # 更新技能到最新版本 / Update to latest
|
|
187
|
+
pdd list [-c category] # 列出所有技能 / List all skills
|
|
188
|
+
pdd version # 显示版本信息 / Show version
|
|
350
189
|
```
|
|
351
190
|
|
|
352
|
-
###
|
|
191
|
+
### 开发流程 / Development Workflow
|
|
353
192
|
|
|
354
193
|
```bash
|
|
355
|
-
#
|
|
356
|
-
pdd
|
|
194
|
+
# 规格与代码 / Specification & Code
|
|
195
|
+
pdd generate -s spec.md -o ./src --dry-run # 代码生成（预览模式）/ Code generation (dry run)
|
|
196
|
+
pdd verify -s spec.md -c ./src --json # 功能验证 / Feature verification
|
|
197
|
+
pdd report -t html|json|md -o ./reports # 报告生成 / Report generation
|
|
357
198
|
|
|
358
|
-
#
|
|
359
|
-
pdd
|
|
199
|
+
# 质量门禁 / Quality Gates
|
|
200
|
+
pdd linter -t java|js|python|sql|prd|skill|all -f ./src # Linter检查
|
|
201
|
+
pdd eval -c core|expert # 运行评估测试 / Run evals
|
|
202
|
+
pdd token -f ./src # Token 效率分析 / Token analysis
|
|
360
203
|
|
|
361
|
-
#
|
|
362
|
-
pdd
|
|
204
|
+
# 国际化 / Internationalization
|
|
205
|
+
pdd i18n -c core|expert|all # 双语合规检查 / Bilingual compliance
|
|
206
|
+
pdd cso # 触发准确率分析 / Trigger accuracy
|
|
363
207
|
```
|
|
364
208
|
|
|
365
|
-
###
|
|
209
|
+
### 🔥 PDD Visual Manager（新增 / New）
|
|
366
210
|
|
|
367
211
|
```bash
|
|
368
|
-
#
|
|
369
|
-
pdd
|
|
370
|
-
pdd
|
|
212
|
+
# Web Dashboard
|
|
213
|
+
pdd dashboard # 启动 Web Dashboard / Start Dashboard
|
|
214
|
+
pdd dashboard -p 8080 # 自定义端口 / Custom port
|
|
371
215
|
|
|
372
|
-
#
|
|
373
|
-
pdd
|
|
374
|
-
pdd openclaw stop
|
|
375
|
-
pdd openclaw status
|
|
376
|
-
pdd openclaw list-tools
|
|
377
|
-
pdd openclaw test [-n tool-name]
|
|
378
|
-
pdd openclaw logs [--tail]
|
|
216
|
+
# Terminal TUI
|
|
217
|
+
pdd tui # 启动 Terminal TUI / Start TUI
|
|
379
218
|
|
|
380
|
-
#
|
|
381
|
-
pdd
|
|
382
|
-
pdd
|
|
383
|
-
pdd
|
|
219
|
+
# VM 数据查询 / VM Data Query
|
|
220
|
+
pdd vm status # 项目状态摘要 / Project status
|
|
221
|
+
pdd vm features # 功能点列表 / Feature list
|
|
222
|
+
pdd vm export --format csv # 导出数据 / Export data
|
|
384
223
|
```
|
|
385
224
|
|
|
386
225
|
***
|
|
387
226
|
|
|
388
|
-
## 七大 Phase 架构
|
|
227
|
+
## 七大 Phase 架构 / Seven Phase Architecture
|
|
389
228
|
|
|
390
|
-
### Phase 1: 基础设施建设
|
|
229
|
+
### Phase 1: 基础设施建设 / Infrastructure
|
|
391
230
|
|
|
392
231
|
提供项目脚手架、质量门禁和工具链基础能力。
|
|
393
232
|
|
|
394
|
-
|
|
233
|
+
> **English**: Provides project scaffolding, quality gates, and toolchain infrastructure.
|
|
234
|
+
|
|
235
|
+
| 组件 / Component | 说明 / Description |
|
|
395
236
|
| ------------- | ---------------------------------------------------------------------------------------------- |
|
|
396
|
-
| **npx
|
|
397
|
-
| **Linter
|
|
398
|
-
| **Hook
|
|
399
|
-
| **Evals
|
|
400
|
-
| **Token
|
|
237
|
+
| **npx 安装机制 / npx Install** | `npx pdd-skills init` 一键初始化 / One-click initialization |
|
|
238
|
+
| **Linter 体系 / Linter System** | Java(Checkstyle+PMD) / JS(ESLint) / Python(Ruff) / SQL(SQLFluff) / Activiti(BPMN) / Skill(Custom) |
|
|
239
|
+
| **Hook 系统 / Hook System** | 7 种事件钩子 / 7 event hooks for custom logic injection |
|
|
240
|
+
| **Evals 框架 / Evals Framework** | 结构/内容/质量/CSO 四种测试类型 / 4 test types |
|
|
241
|
+
| **Token 分析器 / Token Analyzer** | 中英文混合 Token 计数与效率评级 / Bilingual token counting |
|
|
401
242
|
|
|
402
|
-
### Phase 2: 核心能力增强
|
|
243
|
+
### Phase 2: 核心能力增强 / Core Capabilities
|
|
403
244
|
|
|
404
245
|
12 个核心技能 + 五大行为塑造机制。
|
|
405
246
|
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
|
411
|
-
|
|
|
412
|
-
| `pdd-
|
|
413
|
-
| `pdd-
|
|
414
|
-
| `pdd-
|
|
415
|
-
| `pdd-
|
|
416
|
-
| `pdd-
|
|
417
|
-
| `pdd-
|
|
418
|
-
| `pdd-
|
|
419
|
-
| `pdd-
|
|
420
|
-
| `
|
|
421
|
-
| `pdd-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
|
447
|
-
| ---------------------- | --------------------------------------- | -------------------------------------- |
|
|
448
|
-
| **expert-security** | SQL注入 / XSS / CSRF / 命令注入 / 路径遍历 / SSRF | OWASP Top 10 2021 完整覆盖，8 条安全铁律 |
|
|
449
|
-
| **expert-performance** | CPU / 内存 / I/O / 网络 / 锁竞争诊断 | HikariCP / Redis多级缓存 / G1 GC调优 / P99指标 |
|
|
450
|
-
| **expert-mysql** | SQL优化 / 索引设计 / 表结构分析 / 慢查询诊断 | MySQL官方文档参考，执行计划分析，索引优化建议 |
|
|
451
|
-
| **expert-ruoyi** | 若依框架全流程开发 / 代码生成 / 权限配置 / 菜单管理 | 7个若依Bug模式(PATTERN-R001~R007) + Spec模板参考 |
|
|
452
|
-
| **expert-ruoyi-permission** | 若依框架权限配置 / 权限校验失败诊断 / 菜单按钮权限 | 四端一致原则 + @PreAuthorize + v-hasPermi |
|
|
453
|
-
| **expert-activiti** | Activiti 7工作流引擎 / BPMN 2.0 / 流程部署管理 | 流程设计规范 + BPMN校验规则 |
|
|
454
|
-
| **expert-vue3** | Vue3 组件开发 / 状态管理 / 性能优化 / 组合式 API | Vue3 生态最佳实践，响应式系统深度解析 |
|
|
455
|
-
| **expert-springcloud** | 微服务架构 / 服务治理 / 配置中心 / 网关路由 | Spring Cloud Alibaba 全栈解决方案 |
|
|
456
|
-
| **expert-bug-fixer** | Bug 根因分析 / 修复方案生成 / 回归测试建议 | 智能诊断 + 修复策略推荐 |
|
|
457
|
-
| **expert-testcases** | 测试用例设计 / 边界值分析 / 覆盖率优化 | 多维度测试策略，自动化测试生成 |
|
|
458
|
-
| **software-architect** | 架构模式设计 / 技术选型 / 性能权衡 / 可扩展性规划 | 生产级架构设计，60+ 界面组件模式参考 |
|
|
459
|
-
| **software-engineer** | 代码实现 / 重构优化 / 设计模式应用 / 测试驱动开发 | 生产级代码，清洁架构，错误处理完善 |
|
|
460
|
-
| **system-architect** | 系统架构设计 / 模块化设计 / 安全最佳实践 / 代码规范 | PEP8/ESLint 标准，项目初始化，技术栈选择 |
|
|
461
|
-
|
|
462
|
-
### Phase 3.5: 熵减治理系统
|
|
463
|
-
|
|
464
|
-
> **对抗系统腐化，持续偿还技术债务**
|
|
465
|
-
|
|
466
|
-
PDD 熵减体系通过 4 个协同技能，实现从审计到重构的闭环治理：
|
|
467
|
-
|
|
468
|
-
| 熵减技能 | 职责 | 触发场景 |
|
|
469
|
-
|---------|------|---------|
|
|
470
|
-
| **expert-entropy-auditor** | 技术债务审计 / PRD一致性检查 / AI残渣检测 | 每周定时审计、PR合并后、代码提交后 |
|
|
471
|
-
| **expert-arch-enforcer** | 架构约束检查 / 依赖方向验证 / 模块边界监控 | 代码提交后自动触发、架构检查请求 |
|
|
472
|
-
| **expert-code-quality** | 代码审查 / 重构建议 / 设计模式应用 / SOLID原则 | 代码审查请求、质量改进需求 |
|
|
473
|
-
| **expert-auto-refactor** | 自动化重构 / 消除重复 / 简化复杂度 / 模式归集 | 熵减审计后、重构任务分配 |
|
|
474
|
-
|
|
475
|
-
**治理流程**:
|
|
476
|
-
|
|
477
|
-
```
|
|
478
|
-
entropy-auditor (审计发现) → arch-enforcer (约束检查) → code-quality (质量评估) → auto-refactor (自动修复)
|
|
479
|
-
↑ |
|
|
480
|
-
└──────────────────────── 持续监控循环 ←──────────────────────────────────────┘
|
|
481
|
-
```
|
|
482
|
-
|
|
483
|
-
### Phase 4: 平台化建设
|
|
484
|
-
|
|
485
|
-
将核心能力暴露为标准化接口，支持远程调用和多语言接入。
|
|
486
|
-
|
|
487
|
-
#### 4.1 CLI 工具扩展
|
|
488
|
-
|
|
489
|
-
6 个新增子命令：`generate` / `verify` / `report` / `config` / `linter` / `api`
|
|
490
|
-
|
|
491
|
-
#### 4.2 RESTful API 层
|
|
492
|
-
|
|
493
|
-
基于 Node.js **零依赖 HTTP 服务器**（仅使用内置 `http` 模块）：
|
|
494
|
-
|
|
495
|
-
| 方法 | 端点 | 说明 |
|
|
247
|
+
> **English**: 12 core skills + 5 behavior shaping mechanisms.
|
|
248
|
+
|
|
249
|
+
#### 核心技能列表 / Core Skills List
|
|
250
|
+
|
|
251
|
+
| 技能名称 / Skill Name | 用途 / Purpose | 双语 / Bilingual |
|
|
252
|
+
| ----------------------- | ------------------------ | -- |
|
|
253
|
+
| `pdd-main` | 主入口，协调全部子技能 / Main coordinator | ✅ |
|
|
254
|
+
| `pdd-ba` | 业务分析与需求建模 / Business analysis | ✅ |
|
|
255
|
+
| `pdd-extract-features` | 从 PRD 提取功能点 / Extract features from PRD | ✅ |
|
|
256
|
+
| `pdd-generate-spec` | 生成开发规格文档 / Generate specifications | ✅ |
|
|
257
|
+
| `pdd-implement-feature` | 基于规格实现代码 / Implement code from spec | ✅ |
|
|
258
|
+
| `pdd-verify-feature` | 验证实现符合规格 / Verify implementation | ✅ |
|
|
259
|
+
| `pdd-code-reviewer` | 多维度代码审查 / Multi-dimensional code review | ✅ |
|
|
260
|
+
| `pdd-doc-change` | 变更文档管理 / Document change management | ✅ |
|
|
261
|
+
| `pdd-doc-gardener` | 文档清理与维护 / Document maintenance | ✅ |
|
|
262
|
+
| `pdd-entropy-reduction` | 技术债务治理 / Technical debt governance | ✅ |
|
|
263
|
+
| `official-doc-writer` | 党政机关公文生成 / Official document generation | ✅ |
|
|
264
|
+
| `pdd-vm` | PDD Visual Manager 可视化监控 / Visual monitoring | ✅ |
|
|
265
|
+
|
|
266
|
+
### Phase 3: 专家系统扩展 / Expert Systems
|
|
267
|
+
|
|
268
|
+
| 专家技能 / Expert Skill | 能力范围 / Scope | 特色 / Features |
|
|
269
|
+
| --------------------------- | --------------------------------------- | ---------------------------------------- |
|
|
270
|
+
| **expert-security** | SQL注入/XSS/CSRF/命令注入/路径遍历/SSRF | OWASP Top 10 2021 完整覆盖 |
|
|
271
|
+
| **expert-performance** | CPU/内存/I/O/网络/锁竞争诊断 | HikariCP/Redis多级缓存/G1 GC调优 |
|
|
272
|
+
| **expert-mysql** | SQL优化/索引设计/表结构分析/慢查询诊断 | MySQL官方文档参考，执行计划分析 |
|
|
273
|
+
| **expert-ruoyi** | 若依框架全流程开发/代码生成/权限配置 | 7个若依Bug模式(PATTERN-R001~R007) |
|
|
274
|
+
| **expert-ruoyi-permission** | 若依框架权限配置/权限校验失败诊断 | 四端一致原则 + @PreAuthorize + v-hasPermi |
|
|
275
|
+
| **expert-activiti** | Activiti 7工作流引擎/BPMN 2.0/流程部署 | 流程设计规范 + BPMN校验规则 |
|
|
276
|
+
| **expert-vue3** | Vue3 组件开发/状态管理/性能优化 | Vue3 生态最佳实践 |
|
|
277
|
+
| **expert-springcloud** | 微服务架构/服务治理/配置中心/网关路由 | Spring Cloud Alibaba 全栈解决方案 |
|
|
278
|
+
| **expert-bug-fixer** | Bug 根因分析/修复方案生成/回归测试建议 | 智能诊断 + 修复策略推荐 |
|
|
279
|
+
| **software-architect** | 架构模式设计/技术选型/性能权衡 | 生产级架构设计，60+ 界面组件模式 |
|
|
280
|
+
| **software-engineer** | 代码实现/重构优化/设计模式应用 | 生产级代码，清洁架构 |
|
|
281
|
+
| **system-architect** | 系统架构设计/模块化设计/安全最佳实践 | PEP8/ESLint 标准，项目初始化 |
|
|
282
|
+
|
|
283
|
+
### Phase 4: 平台化建设 / Platformization
|
|
284
|
+
|
|
285
|
+
#### RESTful API 层 / RESTful API Layer
|
|
286
|
+
|
|
287
|
+
| 方法 / Method | 端点 / Endpoint | 说明 / Description |
|
|
496
288
|
| -------- | ------------------ | ------- |
|
|
497
|
-
| GET
|
|
498
|
-
| GET
|
|
499
|
-
| GET
|
|
500
|
-
| GET/POST | `/api/v1/spec/*`
|
|
501
|
-
| POST
|
|
502
|
-
| POST
|
|
503
|
-
| POST
|
|
504
|
-
| GET/POST | `/api/v1/config/*` | 配置管理
|
|
505
|
-
| GET
|
|
506
|
-
|
|
507
|
-
**特性**: Rate Limiting + CORS + Graceful Shutdown
|
|
508
|
-
|
|
509
|
-
#### 4.3 MCP Protocol
|
|
289
|
+
| GET | `/api/v1/status` | 服务状态 / Service status |
|
|
290
|
+
| GET | `/api/v1/docs` | API 文档 / API docs |
|
|
291
|
+
| GET | `/api/v1/health` | 健康检查 / Health check |
|
|
292
|
+
| GET/POST | `/api/v1/spec/*` | 规格 CRUD / Spec CRUD |
|
|
293
|
+
| POST | `/api/v1/generate` | 代码生成 / Code generation |
|
|
294
|
+
| POST | `/api/v1/verify` | 功能验证 / Feature verification |
|
|
295
|
+
| POST | `/api/v1/report` | 报告生成 / Report generation |
|
|
296
|
+
| GET/POST | `/api/v1/config/*` | 配置管理 / Configuration |
|
|
297
|
+
| GET | `/api/v1/skills` | 技能列表 / Skills list |
|
|
510
298
|
|
|
511
|
-
|
|
299
|
+
### Phase 5: 智能化升级 / Intelligence Upgrade
|
|
512
300
|
|
|
513
|
-
|
|
514
|
-
Tools (6个):
|
|
515
|
-
├── pdd_generate_spec # 生成开发规格
|
|
516
|
-
├── pdd_generate_code # 生成代码
|
|
517
|
-
├── pdd_verify_feature # 验证功能
|
|
518
|
-
├── pdd_code_review # 代码审查
|
|
519
|
-
├── pdd_list_skills # 列出技能
|
|
520
|
-
└── pdd_get_status # 获取状态
|
|
521
|
-
|
|
522
|
-
Resources (4个):
|
|
523
|
-
├── pdd://specs # 规格资源
|
|
524
|
-
├── pdd://features # 功能资源
|
|
525
|
-
├── pdd://skills # 技能资源
|
|
526
|
-
└── pdd://config # 配置资源
|
|
527
|
-
```
|
|
528
|
-
|
|
529
|
-
协议: JSON-RPC 2.0，零外部依赖。
|
|
530
|
-
|
|
531
|
-
#### 4.4 SDK
|
|
532
|
-
|
|
533
|
-
| SDK | 文件 | 特性 |
|
|
534
|
-
| -------------- | ----------------------------------- | --------------------------------------------- |
|
|
535
|
-
| **JavaScript** | `lib/sdk-base.js` + `lib/sdk-js.js` | 重试 / 事件 / 缓存 / 批量 / 流式 / 链式 API |
|
|
536
|
-
| **Python** | `lib/sdk-python/pdd_sdk/` (8文件) | async/await / dataclass / EventEmitter / 纯标准库 |
|
|
537
|
-
|
|
538
|
-
#### 4.5 gRPC 兼容层
|
|
539
|
-
|
|
540
|
-
基于 Node.js **http2** 内置模块的 Protocol Buffer 风格服务：
|
|
541
|
-
|
|
542
|
-
| Service | Methods |
|
|
543
|
-
| ------------- | ---------------------------------- |
|
|
544
|
-
| SpecService | GenerateSpec / GetSpec / ListSpecs |
|
|
545
|
-
| CodeService | GenerateCode |
|
|
546
|
-
| VerifyService | VerifyFeature |
|
|
547
|
-
| ReportService | GenerateReport |
|
|
548
|
-
| SkillService | ListSkills / GetSkillInfo |
|
|
549
|
-
| HealthService | Check (标准 gRPC 健康协议) |
|
|
550
|
-
|
|
551
|
-
包含: proto3 JSON 编解码器、拦截器链、反射服务。
|
|
552
|
-
|
|
553
|
-
### Phase 5: 智能化升级
|
|
554
|
-
|
|
555
|
-
#### 三级缓存系统
|
|
301
|
+
#### 三级缓存系统 / Three-Level Cache System
|
|
556
302
|
|
|
557
303
|
```
|
|
558
|
-
请求 → L1 Session Cache (LRU, 内存)
|
|
559
|
-
→ MISS → L2 Project Cache (LRU, 内存,
|
|
560
|
-
→ MISS → L3 Global Cache (LFU, 磁盘JSON
|
|
304
|
+
请求 / Request → L1 Session Cache (LRU, 内存 / Memory)
|
|
305
|
+
→ MISS → L2 Project Cache (LRU, 内存, 跨会话 / Cross-session)
|
|
306
|
+
→ MISS → L3 Global Cache (LFU, 磁盘 / Disk JSON)
|
|
561
307
|
```
|
|
562
308
|
|
|
563
|
-
| 级别
|
|
309
|
+
| 级别 / Level | 策略 / Strategy | 存储 / Storage | TTL | 容量 / Capacity |
|
|
564
310
|
| ---------- | --- | -- | ----- | ----- |
|
|
565
|
-
| L1 Session | LRU | 内存 | 5min
|
|
566
|
-
| L2 Project | LRU | 内存 | 30min | 500条
|
|
567
|
-
| L3 Global
|
|
568
|
-
|
|
569
|
-
O(1) 时间复杂度操作，Write-Through 写入策略。
|
|
311
|
+
| L1 Session | LRU | 内存 / Memory | 5min | 100条 |
|
|
312
|
+
| L2 Project | LRU | 内存 / Memory | 30min | 500条 |
|
|
313
|
+
| L3 Global | LFU | 磁盘 / Disk | 2h | 2000条 |
|
|
570
314
|
|
|
571
|
-
#### Token 预算管理
|
|
315
|
+
#### Token 预算管理 / Token Budget Management
|
|
572
316
|
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
| 阶段 | 占比 | 说明 |
|
|
317
|
+
| 阶段 / Phase | 占比 / Ratio | 说明 / Description |
|
|
576
318
|
| -------------- | --- | ------ |
|
|
577
|
-
| analysis
|
|
578
|
-
| design
|
|
579
|
-
| implementation | 35% | 代码实现阶段 |
|
|
580
|
-
| review
|
|
581
|
-
| verify
|
|
582
|
-
|
|
583
|
-
阈值策略: **80% 警告** / **95% 阻断**
|
|
319
|
+
| analysis | 15% | 需求分析阶段 / Requirements analysis |
|
|
320
|
+
| design | 20% | 规格设计阶段 / Specification design |
|
|
321
|
+
| implementation | 35% | 代码实现阶段 / Implementation |
|
|
322
|
+
| review | 20% | 代码审查阶段 / Code review |
|
|
323
|
+
| verify | 10% | 验证确认阶段 / Verification |
|
|
584
324
|
|
|
585
|
-
|
|
325
|
+
阈值策略 / Threshold: **80% 警告 / Warning** / **95% 阻断 / Block**
|
|
586
326
|
|
|
587
|
-
#### 代码质量评分 — 五维引擎
|
|
327
|
+
#### 代码质量评分 — 五维引擎 / Quality Scoring — Five Dimensions
|
|
588
328
|
|
|
589
|
-
| 维度
|
|
329
|
+
| 维度 / Dimension | 权重 / Weight | 规则数 / Rules | 评级 / Rating |
|
|
590
330
|
| -------- | --- | --- | ----------------------------------------------- |
|
|
591
|
-
|
|
|
592
|
-
|
|
|
593
|
-
|
|
|
594
|
-
|
|
|
595
|
-
|
|
|
596
|
-
|
|
597
|
-
**评级**: S≥90 / A≥80 / B≥70 / C≥60 / D≥50 / F<50
|
|
598
|
-
|
|
599
|
-
#### 多轮迭代优化
|
|
600
|
-
|
|
601
|
-
```
|
|
602
|
-
Round 1: Review → Fix → Verify
|
|
603
|
-
↓ 收敛 < 5%
|
|
604
|
-
Round 2: Review → Fix → Verify
|
|
605
|
-
↓ 收敛 < 5%
|
|
606
|
-
...
|
|
607
|
-
Round N (max=5): 最终结果
|
|
608
|
-
```
|
|
331
|
+
| **可读性 / Readability** | 20% | 7 | 命名规范/函数长度/行长度/圈复杂度/注释覆盖率 |
|
|
332
|
+
| **可维护性 / Maintainability** | 20% | 6 | 重复代码/模块内聚/耦合度/单一职责/死代码 |
|
|
333
|
+
| **健壮性 / Robustness** | 25% | 6 | Null检查/错误处理/边界验证/异步错误/类型检查 |
|
|
334
|
+
| **性能 / Performance** | 15% | 6 | 循环效率/内存分配/I/O操作/字符串拼接/异步模式 |
|
|
335
|
+
| **安全性 / Security** | 20% | 6 | SQL注入/XSS风险/硬编码密钥/输入验证/依赖安全 |
|
|
609
336
|
|
|
610
|
-
|
|
611
|
-
- 自动修复: **建议式修复**（不直接修改源码，安全原则）
|
|
612
|
-
- 收敛检测: 质量提升 < 5% 时自动终止
|
|
337
|
+
**评级 / Grades**: S≥90 / A≥80 / B≥70 / C≥60 / D≥50 / F<50
|
|
613
338
|
|
|
614
|
-
### Phase 6: 生态建设
|
|
339
|
+
### Phase 6: 生态建设 / Ecosystem
|
|
615
340
|
|
|
616
|
-
#### 插件系统
|
|
341
|
+
#### 插件系统 / Plugin System
|
|
617
342
|
|
|
618
343
|
```
|
|
619
|
-
PluginBase (抽象基类)
|
|
620
|
-
├── onInstall() 安装后执行一次
|
|
621
|
-
├── onActivate() 激活时调用
|
|
622
|
-
├── onDeactivate() 停用时调用
|
|
623
|
-
├── onUninstall() 卸载前清理
|
|
624
|
-
└── onConfigChange() 配置变更响应
|
|
625
|
-
│
|
|
626
|
-
├─ registerCommand(name, opts) 注册 CLI 命令
|
|
627
|
-
├─ registerHook(event, handler) 注册流程钩子
|
|
628
|
-
├─ registerTool(name, opts) 注册 MCP Tool
|
|
629
|
-
└─ registerFormatter(type, fn) 注册输出格式化器
|
|
344
|
+
PluginBase (抽象基类 / Abstract Base)
|
|
345
|
+
├── onInstall() 安装后执行一次 / Run once after install
|
|
346
|
+
├── onActivate() 激活时调用 / Called on activation
|
|
347
|
+
├── onDeactivate() 停用时调用 / Called on deactivation
|
|
348
|
+
├── onUninstall() 卸载前清理 / Cleanup before uninstall
|
|
349
|
+
└── onConfigChange() 配置变更响应 / Config change response
|
|
630
350
|
```
|
|
631
351
|
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
**3 个内置示例插件**: hello-world / code-stats / custom-linter
|
|
635
|
-
|
|
636
|
-
#### OpenClaw 集成
|
|
637
|
-
|
|
638
|
-
| 模块 | 能力 |
|
|
639
|
-
| -------------- | -------------------------------------------------- |
|
|
640
|
-
| **Adapter** | 连接管理 + 心跳30s + 指数退避重连 + 6 Tool 映射 |
|
|
641
|
-
| **CLI** | 7个子命令: start/stop/status/list-tools/test/logs/init |
|
|
642
|
-
| **API Bridge** | 5端点 + SSE流式 + 中间件链 + batchExecute |
|
|
643
|
-
| **Data Sync** | push/pull/bidirectional 四类型同步 + 冲突解决 + 定时调度 |
|
|
644
|
-
|
|
645
|
-
#### 社区文档
|
|
646
|
-
|
|
647
|
-
| 文档 | 内容 | 行数 |
|
|
648
|
-
| ---------------------------------------------------------- | ----------------- | ------ |
|
|
649
|
-
| [user-guide](docs/user-guide/user-guide.md) | 快速开始 / 工作流 / FAQ | ~1480 |
|
|
650
|
-
| [developer-guide](docs/developer-guide/developer-guide.md) | 架构 / 规范 / 贡献流程 | ~2960 |
|
|
651
|
-
| [api-reference](docs/api-reference/api-reference.md) | 全模块 API / 错误码大全 | ~3948 |
|
|
652
|
-
| [operations](docs/operations/operations-guide.md) | 部署 / 调优 / 监控 / 安全 | ~2018 |
|
|
653
|
-
| [plugin-market](docs/plugin-market/README.md) | 发布流程 / 评分标准 / 审核 | ~400 |
|
|
352
|
+
**安全沙箱 / Security Sandbox**: Proxy 拦截 fs/net/process/env，四维策略控制
|
|
654
353
|
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
## 📊 Phase 7: PDD Visual Manager
|
|
658
|
-
|
|
659
|
-
> **重要说明**: PDD Visual Manager 用于 **可视化监控使用 PDD 方法开发的业务项目的运行状态**，而非管理 PDD-Skills 自身的开发任务。
|
|
660
|
-
|
|
661
|
-
### 定位与目标
|
|
354
|
+
### 📊 Phase 7: PDD Visual Manager / Visual Manager
|
|
662
355
|
|
|
663
|
-
PDD Visual Manager
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
- **Terminal TUI**: 基于 Node.js ANSI 的终端 UI，适合 SSH 远程场景
|
|
667
|
-
|
|
668
|
-
两者共享同一数据模型和 API 层，可根据使用场景自由切换。
|
|
356
|
+
> **重要说明 / Important**: PDD Visual Manager 用于 **可视化监控使用 PDD 方法开发的业务项目的运行状态**，而非管理 PDD-Skills 自身的开发任务。
|
|
357
|
+
>
|
|
358
|
+
> **English**: PDD Visual Manager is used for **visual monitoring of business projects developed using the PDD method**, not for managing PDD-Skills' own development tasks.
|
|
669
359
|
|
|
670
|
-
|
|
360
|
+
#### 双形态架构图 / Dual-Mode Architecture
|
|
671
361
|
|
|
672
362
|
```
|
|
673
363
|
┌─────────────────────────────────────────────────────────────────────────────────┐
|
|
674
|
-
│ PDD Visual Manager Architecture
|
|
364
|
+
│ PDD Visual Manager Architecture │
|
|
675
365
|
├─────────────────────────────────────────────────────────────────────────────────┤
|
|
676
366
|
│ │
|
|
677
367
|
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
|
|
678
|
-
│ │ Data Layer (数据层)
|
|
679
|
-
│ │ │ │
|
|
368
|
+
│ │ Data Layer (数据层 / Data Layer) │ │
|
|
680
369
|
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │ │
|
|
681
370
|
│ │ │ Feature Store│ │ Config Store │ │ Cache Store │ │ Event Bus │ │ │
|
|
682
371
|
│ │ └──────────────┘ └──────────────┘ └──────────────┘ └────────────┘ │ │
|
|
@@ -684,484 +373,126 @@ PDD Visual Manager (PDD-VM) 是 Phase 7 的核心交付物，提供 **双形态
|
|
|
684
373
|
│ │ │
|
|
685
374
|
│ ▼ │
|
|
686
375
|
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
|
|
687
|
-
│ │ Service Layer (服务层)
|
|
688
|
-
│ │ │ │
|
|
376
|
+
│ │ Service Layer (服务层 / Service Layer) │ │
|
|
689
377
|
│ │ ┌────────────────┐ ┌────────────────┐ ┌──────────────────────────┐ │ │
|
|
690
378
|
│ │ │ HTTP Server │ │ SSE Server │ │ REST API (11端点) │ │ │
|
|
691
|
-
│ │ │ (server.js) │ │ (sse.js) │ │ (api-routes.js) │ │ │
|
|
692
379
|
│ │ └────────────────┘ └────────────────┘ └──────────────────────────┘ │ │
|
|
693
380
|
│ └─────────────────────────────────────────────────────────────────────────┘ │
|
|
694
381
|
│ │ │ │
|
|
695
382
|
│ ▼ ▼ │
|
|
696
383
|
│ ┌─────────────────────────────┐ ┌─────────────────────────────────────┐ │
|
|
697
384
|
│ │ Presentation Layer │ │ Presentation Layer │ │
|
|
698
|
-
│ │ │ │ │ │
|
|
699
385
|
│ │ ┌───────────────────────┐ │ │ ┌─────────────────────────────┐ │ │
|
|
700
386
|
│ │ │ Web Dashboard │ │ │ │ Terminal TUI │ │ │
|
|
701
|
-
│ │ │
|
|
702
|
-
│ │
|
|
703
|
-
│
|
|
704
|
-
│ │ │ ├─────────────────┤ │ │ │ │ ├───────────────────────┤ │ │ │
|
|
705
|
-
│ │ │ │ dashboard.css │ │ │ │ │ │ renderer.js (ANSI渲染) │ │ │ │
|
|
706
|
-
│ │ │ ├─────────────────┤ │ │ │ │ ├───────────────────────┤ │ │ │
|
|
707
|
-
│ │ │ │ app.js (SPA框架)│ │ │ │ │ │ input.js (键盘输入) │ │ │ │
|
|
708
|
-
│ │ │ └─────────────────┘ │ │ │ │ └───────────────────────┘ │ │ │
|
|
709
|
-
│ │ │ │ │ │ │ │ │ │
|
|
710
|
-
│ │ │ 4 视图面板: │ │ │ │ 5 组件: │ │ │
|
|
711
|
-
│ │ │ • Pipeline (流水线) │ │ │ │ progress-bar / table / │ │ │
|
|
712
|
-
│ │ │ • Kanban (看板) │ │ │ │ sparkline / status-light │ │ │
|
|
713
|
-
│ │ │ • Quality (质量) │ │ │ │ / card │ │ │
|
|
714
|
-
│ │ │ • System (系统) │ │ │ │ │ │ │
|
|
715
|
-
│ │ │ │ │ │ │ 4 屏幕 + 详情overlay: │ │ │
|
|
716
|
-
│ │ │ Canvas 图表引擎: │ │ │ │ overview / kanban / │ │ │
|
|
717
|
-
│ │ │ radar/histogram/ │ │ │ │ quality / system │ │ │
|
|
718
|
-
│ │ │ gauge/lineChart/ │ │ │ │ │ │ │
|
|
719
|
-
│ │ │ horizontalBar │ │ │ └─────────────────────────────┘ │ │
|
|
720
|
-
│ │ └───────────────────────┘ │ │ │ │
|
|
721
|
-
│ └─────────────────────────────┘ │
|
|
722
|
-
│ │
|
|
387
|
+
│ │ │ (零依赖 SPA) │ │ │ │ (零依赖 ANSI) │ │ │
|
|
388
|
+
│ │ └───────────────────────┘ │ │ └─────────────────────────────┘ │ │
|
|
389
|
+
│ └─────────────────────────────┘ │ │ │
|
|
723
390
|
└─────────────────────────────────────────────────────────────────────────────────┘
|
|
724
391
|
```
|
|
725
392
|
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
```
|
|
729
|
-
┌─────────────┐ ┌─────────────┐ ┌─────────────────┐
|
|
730
|
-
│ PRD 文档 │ │ 配置文件 │ │ 运行时事件 │
|
|
731
|
-
│ (.prdx) │ │ (.pddrc) │ │ (Hook/Timer) │
|
|
732
|
-
└──────┬──────┘ └──────┬──────┘ └────────┬────────┘
|
|
733
|
-
│ │ │
|
|
734
|
-
▼ ▼ ▼
|
|
735
|
-
┌─────────────────────────────────────────────────────────┐
|
|
736
|
-
│ Data Aggregator │
|
|
737
|
-
│ (lib/vm/data-aggregator.js) │
|
|
738
|
-
└─────────────────────────┬───────────────────────────────┘
|
|
739
|
-
│
|
|
740
|
-
▼
|
|
741
|
-
┌─────────────────────────────────────────────────────────┐
|
|
742
|
-
│ State Manager │
|
|
743
|
-
│ (lib/vm/state-manager.js) │
|
|
744
|
-
│ │
|
|
745
|
-
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
|
|
746
|
-
│ │ Features │ │ Pipeline │ │ Quality │ │
|
|
747
|
-
│ │ State │ │ State │ │ Metrics │ │
|
|
748
|
-
│ └────────────┘ └────────────┘ └────────────┘ │
|
|
749
|
-
└─────────────────────────┬───────────────────────────────┘
|
|
750
|
-
│
|
|
751
|
-
┌─────────────┼─────────────┐
|
|
752
|
-
▼ ▼ ▼
|
|
753
|
-
┌──────────────┐ ┌──────────┐ ┌──────────────┐
|
|
754
|
-
│ REST API │ │ SSE Push │ │ Data Export │
|
|
755
|
-
│ (11 端点) │ │ (实时) │ │ (CSV/JSON) │
|
|
756
|
-
└──────┬───────┘ └────┬─────┘ └──────────────┘
|
|
757
|
-
│ │
|
|
758
|
-
▼ ▼
|
|
759
|
-
┌──────────────┐ ┌──────────────┐
|
|
760
|
-
│ Web Dashboard│ │ Terminal TUI │
|
|
761
|
-
│ (HTTP Poll) │ │ (Direct) │
|
|
762
|
-
└──────────────┘ └──────────────┘
|
|
763
|
-
```
|
|
764
|
-
|
|
765
|
-
### Web Dashboard — 4 大视图面板
|
|
766
|
-
|
|
767
|
-
#### 1. Pipeline View（流水线视图）
|
|
768
|
-
|
|
769
|
-
展示 PDD 开发流水线的各阶段状态和进度：
|
|
770
|
-
|
|
771
|
-
| 阶段 | 显示内容 | 交互 |
|
|
772
|
-
| -------------- | ------ | ------ |
|
|
773
|
-
| Analysis | 需求分析进度 | 点击查看详情 |
|
|
774
|
-
| Design | 规格生成状态 | 点击查看规格 |
|
|
775
|
-
| Implementation | 代码实现进度 | 点击查看代码 |
|
|
776
|
-
| Review | 审查状态 | 点击查看问题 |
|
|
777
|
-
| Verify | 验证结果 | 点击查看报告 |
|
|
778
|
-
|
|
779
|
-
**特色功能**:
|
|
780
|
-
|
|
781
|
-
- 实时进度条动画
|
|
782
|
-
- 阶段间依赖关系可视化
|
|
783
|
-
- 阻塞项高亮提示
|
|
784
|
-
- 历史趋势对比
|
|
785
|
-
|
|
786
|
-
#### 2. Kanban View（看板视图）
|
|
787
|
-
|
|
788
|
-
以看板形式展示功能点的开发状态：
|
|
789
|
-
|
|
790
|
-
```
|
|
791
|
-
┌─────────────┬─────────────┬─────────────┬─────────────┬─────────────┐
|
|
792
|
-
│ BACKLOG │ ANALYSIS │ DESIGN │ IMPLEMENT │ VERIFY │
|
|
793
|
-
│ │ │ │ │ │
|
|
794
|
-
│ ┌───────┐ │ ┌───────┐ │ ┌───────┐ │ ┌───────┐ │ ┌───────┐ │
|
|
795
|
-
│ │Feat A │ │ │Feat B │ │ │Feat C │ │ │Feat D │ │ │Feat E │ │
|
|
796
|
-
│ │ High │ │ │ Med │ │ │ Low │ │ │ Done │ │ │ Pass │ │
|
|
797
|
-
│ └───────┘ │ └───────┘ │ └───────┘ │ └───────┘ │ └───────┘ │
|
|
798
|
-
│ ┌───────┐ │ ┌───────┐ │ │ ┌───────┐ │ │
|
|
799
|
-
│ │Feat F │ │ │Feat G │ │ │ │Feat H │ │ │
|
|
800
|
-
│ │ Med │ │ │ Low │ │ │ │ WIP │ │ │
|
|
801
|
-
│ └───────┘ │ └───────┘ │ │ └───────┘ │ │
|
|
802
|
-
└─────────────┴─────────────┴─────────────┴─────────────┴─────────────┘
|
|
803
|
-
```
|
|
804
|
-
|
|
805
|
-
**特色功能**:
|
|
806
|
-
|
|
807
|
-
- 拖拽排序（规划中）
|
|
808
|
-
- 优先级标签筛选
|
|
809
|
-
- 负责人分配显示
|
|
810
|
-
- WIP 限制警告
|
|
811
|
-
|
|
812
|
-
#### 3. Quality View（质量视图）
|
|
393
|
+
#### Web Dashboard — 4 大视图面板 / 4 View Panels
|
|
813
394
|
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
| 指标类型 | 图表组件 | 数据来源 |
|
|
817
|
-
| --------- | -------------------- | ------------- |
|
|
818
|
-
| 五维评分雷达图 | Canvas Radar Chart | QualityScorer |
|
|
819
|
-
| 规则分布直方图 | Canvas Histogram | Linter 结果 |
|
|
820
|
-
| 总体评分仪表盘 | Canvas Gauge | 综合计算 |
|
|
821
|
-
| 趋势折线图 | Canvas LineChart | 历史快照 |
|
|
822
|
-
| 问题分类横向条形图 | Canvas HorizontalBar | CodeReviewer |
|
|
823
|
-
|
|
824
|
-
**特色功能**:
|
|
825
|
-
|
|
826
|
-
- 实时评分更新
|
|
827
|
-
- 阈值超标红色预警
|
|
828
|
-
- 下钻至具体规则
|
|
829
|
-
- 与基准对比
|
|
830
|
-
|
|
831
|
-
#### 4. System View（系统视图）
|
|
832
|
-
|
|
833
|
-
监控系统运行状态和资源使用：
|
|
834
|
-
|
|
835
|
-
| 监控项 | 显示方式 | 刷新频率 |
|
|
836
|
-
| --------- | -------- | ---- |
|
|
837
|
-
| 服务状态 | 状态灯 | 30s |
|
|
838
|
-
| API 响应时间 | 数值 + 趋势 | 30s |
|
|
839
|
-
| 缓存命中率 | 百分比 + 图表 | 30s |
|
|
840
|
-
| Token 使用量 | 进度条 + 预警 | 30s |
|
|
841
|
-
| 连接数 | 数值 | 30s |
|
|
842
|
-
| 错误日志 | 滚动列表 | 实时 |
|
|
843
|
-
|
|
844
|
-
### Terminal TUI — 4 屏 + 快捷键
|
|
845
|
-
|
|
846
|
-
TUI 提供 4 个主要屏幕，支持丰富的键盘交互：
|
|
847
|
-
|
|
848
|
-
#### 4 个屏幕概览
|
|
849
|
-
|
|
850
|
-
| 屏幕 | 名称 | 主要内容 |
|
|
395
|
+
| 视图 / View | 名称 / Name | 主要内容 / Content |
|
|
851
396
|
| -------- | -------- | ------------------- |
|
|
852
|
-
|
|
|
853
|
-
|
|
|
854
|
-
|
|
|
855
|
-
|
|
|
397
|
+
| Pipeline | 流水线视图 / Pipeline View | 各阶段状态和进度 / Stage status & progress |
|
|
398
|
+
| Kanban | 看板视图 / Kanban View | 功能点开发状态 / Feature development status |
|
|
399
|
+
| Quality | 质量视图 / Quality View | 代码质量指标 / Code quality metrics |
|
|
400
|
+
| System | 系统视图 / System View | 系统运行状态 / System runtime status |
|
|
856
401
|
|
|
857
|
-
#### TUI
|
|
402
|
+
#### Terminal TUI — 快捷键 / Shortcuts
|
|
858
403
|
|
|
859
|
-
| 按键
|
|
404
|
+
| 按键 / Key | 功能 / Function | 适用场景 / Scenario |
|
|
860
405
|
| -------------- | ------------ | ---------- |
|
|
861
|
-
| `Tab`
|
|
862
|
-
| `q` 或 `Ctrl+C` | 退出 TUI
|
|
863
|
-
| `r` 或 `F5`
|
|
864
|
-
| `
|
|
865
|
-
|
|
|
866
|
-
| `k` / `↑` | 向上选择（移动光标） | 列表/表格场景 |
|
|
867
|
-
| `Enter` | 查看选中项详情 | 列表/表格场景 |
|
|
868
|
-
| `Esc` | 返回上一级 / 关闭详情 | 详情 overlay |
|
|
869
|
-
| `?` | 显示帮助信息 | 所有屏幕 |
|
|
870
|
-
| `1` - `4` | 直接跳转到指定屏幕 | 所有屏幕 |
|
|
871
|
-
| `/` | 打开搜索框 | 支持搜索的屏幕 |
|
|
872
|
-
| `n` | 跳转到下一个搜索结果 | 搜索激活时 |
|
|
873
|
-
|
|
874
|
-
#### TUI 组件库
|
|
875
|
-
|
|
876
|
-
```
|
|
877
|
-
lib/vm/tui/components/
|
|
878
|
-
├── progress-bar.js # 彩色进度条 (████████░░░░ 80%)
|
|
879
|
-
├── table.js # 对齐表格 (支持排序/高亮)
|
|
880
|
-
├── sparkline.js # 迷你折线图 (▁▂▃▅▆▇█)
|
|
881
|
-
├── status-light.js # 状态指示灯 (● ● ○)
|
|
882
|
-
└── card.js # 信息卡片 (标题+内容+元数据)
|
|
883
|
-
```
|
|
884
|
-
|
|
885
|
-
### CLI 命令速查
|
|
886
|
-
|
|
887
|
-
```bash
|
|
888
|
-
# ========== Web Dashboard ==========
|
|
889
|
-
pdd dashboard # 启动 Dashboard (默认 http://localhost:3001)
|
|
890
|
-
pdd dashboard -p 8080 # 自定义端口
|
|
891
|
-
pdd dashboard --no-open # 不自动打开浏览器
|
|
892
|
-
|
|
893
|
-
# ========== Terminal TUI ==========
|
|
894
|
-
pdd tui # 启动 TUI
|
|
895
|
-
pdd tui --refresh 3 # 自定义刷新间隔(秒)
|
|
896
|
-
|
|
897
|
-
# ========== VM 数据查询 ==========
|
|
898
|
-
pdd vm status # 项目状态摘要 (JSON 格式)
|
|
899
|
-
pdd vm features # 功能点列表 (含状态)
|
|
900
|
-
pdd vm features --status done # 筛选已完成功能点
|
|
901
|
-
pdd vm export --format csv # 导出为 CSV
|
|
902
|
-
pdd vm export --format json # 导出为 JSON
|
|
903
|
-
pdd vm export -o report.csv # 导出到指定文件
|
|
904
|
-
```
|
|
905
|
-
|
|
906
|
-
### Data Model 说明
|
|
907
|
-
|
|
908
|
-
PDD-VM 的数据模型围绕 **业务项目** 的 PDD 开发流程设计：
|
|
909
|
-
|
|
910
|
-
```
|
|
911
|
-
Project (业务项目)
|
|
912
|
-
├── metadata (元数据)
|
|
913
|
-
│ ├── name: string # 项目名称
|
|
914
|
-
│ ├── version: string # 项目版本
|
|
915
|
-
│ ├── createdAt: timestamp # 创建时间
|
|
916
|
-
│ └── updatedAt: timestamp # 更新时间
|
|
917
|
-
│
|
|
918
|
-
├── features (功能点列表)
|
|
919
|
-
│ ├── id: string # 功能点 ID
|
|
920
|
-
│ ├── name: string # 功能点名称
|
|
921
|
-
│ ├── status: enum # backlog/analysis/design/implement/review/verify/done
|
|
922
|
-
│ ├── priority: enum # critical/high/medium/low
|
|
923
|
-
│ ├── assignee?: string # 负责人
|
|
924
|
-
│ ├── specPath?: string # 规格文件路径
|
|
925
|
-
│ ├── sourceDir?: string # 源码目录
|
|
926
|
-
│ └── metrics (度量指标)
|
|
927
|
-
│ ├── coveragePercent: number # 覆盖率
|
|
928
|
-
│ ├── passRate: number # 通过率
|
|
929
|
-
│ ├── qualityScore: number # 质量评分
|
|
930
|
-
│ └── grade: string # 等级 (S/A/B/C/D/F)
|
|
931
|
-
│
|
|
932
|
-
├── pipeline (流水线状态)
|
|
933
|
-
│ ├── phase: string # 当前阶段
|
|
934
|
-
│ ├── progress: number # 整体进度 (0-100)
|
|
935
|
-
│ ├── stages[] (各阶段详情)
|
|
936
|
-
│ │ ├── name: string
|
|
937
|
-
│ │ ├── status: enum # pending/in-progress/completed/blocked
|
|
938
|
-
│ │ ├── progress: number
|
|
939
|
-
│ │ └── startedAt?: timestamp
|
|
940
|
-
│
|
|
941
|
-
├── quality (质量指标)
|
|
942
|
-
│ ├── overallScore: number # 总分 (0-100)
|
|
943
|
-
│ ├── overallGrade: string # 总等级
|
|
944
|
-
│ ├── dimensions (五维评分)
|
|
945
|
-
│ │ ├── readability: { score, grade }
|
|
946
|
-
│ │ ├── maintainability: { score, grade }
|
|
947
|
-
│ │ ├── robustness: { score, grade }
|
|
948
|
-
│ │ ├── performance: { score, grade }
|
|
949
|
-
│ │ └── security: { score, grade }
|
|
950
|
-
│ └── rulesViolated[] (违规规则列表)
|
|
951
|
-
│ ├── ruleId: string
|
|
952
|
-
│ ├── category: string
|
|
953
|
-
│ ├── severity: enum # error/warning/info
|
|
954
|
-
│ └── count: number
|
|
955
|
-
│
|
|
956
|
-
└── system (系统状态)
|
|
957
|
-
├── apiStatus: enum # online/degraded/offline
|
|
958
|
-
├── uptime: number # 运行时长(秒)
|
|
959
|
-
├── requestsTotal: number # 总请求数
|
|
960
|
-
├── cacheHitRate: number # 缓存命中率
|
|
961
|
-
├── tokenUsage (Token 使用)
|
|
962
|
-
│ ├── totalBudget: number
|
|
963
|
-
│ ├── consumed: number
|
|
964
|
-
│ ├── remaining: number
|
|
965
|
-
│ └── percent: number
|
|
966
|
-
└── errors[] (最近错误列表)
|
|
967
|
-
├── timestamp: timestamp
|
|
968
|
-
├── level: enum # error/warn/info
|
|
969
|
-
├── message: string
|
|
970
|
-
└── source: string
|
|
971
|
-
```
|
|
972
|
-
|
|
973
|
-
### Phase 7 文件清单
|
|
974
|
-
|
|
975
|
-
```
|
|
976
|
-
lib/vm/ # PDD Visual Manager 核心目录 (~38 文件, ~6000 行)
|
|
977
|
-
├── index.js # VM 入口，导出全部模块
|
|
978
|
-
├── data-aggregator.js # 数据聚合器
|
|
979
|
-
├── state-manager.js # 状态管理器
|
|
980
|
-
├── event-bus.js # 事件总线
|
|
981
|
-
│
|
|
982
|
-
├── dashboard/ # Web Dashboard 模块
|
|
983
|
-
│ ├── server.js # HTTP 服务器 (零依赖)
|
|
984
|
-
│ ├── sse.js # SSE (Server-Sent Events) 推送服务
|
|
985
|
-
│ ├── api-routes.js # 11 个 REST API 端点
|
|
986
|
-
│ ├── index.html # SPA 主页面
|
|
987
|
-
│ ├── css/
|
|
988
|
-
│ │ └── dashboard.css # 完整样式表 (响应式布局)
|
|
989
|
-
│ └── js/
|
|
990
|
-
│ ├── app.js # SPA 应用框架 (路由/状态/组件)
|
|
991
|
-
│ ├── pipeline-view.js # 流水线视图组件
|
|
992
|
-
│ ├── kanban-view.js # 看板视图组件
|
|
993
|
-
│ ├── quality-view.js # 质量视图组件
|
|
994
|
-
│ ├── system-view.js # 系统视图组件
|
|
995
|
-
│ └── charts/
|
|
996
|
-
│ ├── canvas-engine.js # Canvas 图表引擎基类
|
|
997
|
-
│ ├── radar.js # 雷达图
|
|
998
|
-
│ ├── histogram.js # 直方图
|
|
999
|
-
│ ├── gauge.js # 仪表盘
|
|
1000
|
-
│ ├── line-chart.js # 折线图
|
|
1001
|
-
│ └── horizontal-bar.js # 横向条形图
|
|
1002
|
-
│
|
|
1003
|
-
├── tui/ # Terminal TUI 模块
|
|
1004
|
-
│ ├── tui.js # TUIApp 主控制器
|
|
1005
|
-
│ ├── renderer.js # ANSI 渲染引擎
|
|
1006
|
-
│ ├── input.js # 键盘输入处理器 (raw mode)
|
|
1007
|
-
│ ├── screens/
|
|
1008
|
-
│ │ ├── overview-screen.js # 总览屏幕
|
|
1009
|
-
│ │ ├── kanban-screen.js # 看板屏幕
|
|
1010
|
-
│ │ ├── quality-screen.js # 质量屏幕
|
|
1011
|
-
│ │ └── system-screen.js # 系统屏幕
|
|
1012
|
-
│ ├── components/
|
|
1013
|
-
│ │ ├── progress-bar.js # 进度条组件
|
|
1014
|
-
│ │ ├── table.js # 表格组件
|
|
1015
|
-
│ │ ├── sparkline.js # 迷你折线图组件
|
|
1016
|
-
│ │ ├── status-light.js # 状态灯组件
|
|
1017
|
-
│ │ └── card.js # 卡片组件
|
|
1018
|
-
│ └── overlays/
|
|
1019
|
-
│ ├── detail-overlay.js # 详情覆盖层
|
|
1020
|
-
│ └── help-overlay.js # 帮助覆盖层
|
|
1021
|
-
│
|
|
1022
|
-
└── hooks/ # VM Hook 系统
|
|
1023
|
-
├── vm-hooks.js # Hook 定义与注册
|
|
1024
|
-
└── handlers/
|
|
1025
|
-
├── on-feature-update.js # 功能点更新处理
|
|
1026
|
-
├── on-phase-change.js # 阶段变更处理
|
|
1027
|
-
└── on-quality-alert.js # 质量预警处理
|
|
1028
|
-
```
|
|
406
|
+
| `Tab` | 切换到下一个屏幕 / Next screen | 所有屏幕 / All screens |
|
|
407
|
+
| `q` 或 `Ctrl+C` | 退出 TUI / Quit | 所有屏幕 / All screens |
|
|
408
|
+
| `r` 或 `F5` | 强制刷新 / Refresh | 所有屏幕 / All screens |
|
|
409
|
+
| `1` - `4` | 直接跳转到指定屏幕 / Jump to screen | 所有屏幕 / All screens |
|
|
410
|
+
| `/` | 打开搜索框 / Search | 支持搜索的屏幕 / Searchable screens |
|
|
1029
411
|
|
|
1030
412
|
***
|
|
1031
413
|
|
|
1032
|
-
## 技能系统
|
|
1033
|
-
|
|
1034
|
-
### 如何使用技能
|
|
1035
|
-
|
|
1036
|
-
PDD-Skills 的技能通过 AI Agent（如 Claude、GPT 等）自动加载和使用。每个技能的 SKILL.md 包含：
|
|
1037
|
-
|
|
1038
|
-
1. **触发词** (`_meta.json` triggers) — AI 何时激活此技能
|
|
1039
|
-
2. **行为塑造** — Iron Law / Rationalization / Red Flags
|
|
1040
|
-
3. **详细指令** — 分层的 🇨🇳 中文 / 🇺🇸 英文指导
|
|
414
|
+
## 技能系统 / Skill System
|
|
1041
415
|
|
|
1042
|
-
### 技能分类
|
|
416
|
+
### 技能分类 / Skill Categories
|
|
1043
417
|
|
|
1044
418
|
```
|
|
1045
419
|
skills/
|
|
1046
|
-
├── core/ # 11 个核心技能 (必装)
|
|
1047
|
-
│ ├── pdd-main/ # 主协调器
|
|
1048
|
-
│ ├── pdd-ba/ # 业务分析
|
|
1049
|
-
│ ├── pdd-extract-features/
|
|
1050
|
-
│ ├── pdd-generate-spec/
|
|
1051
|
-
│ ├── pdd-implement-feature/ #
|
|
1052
|
-
│ ├── pdd-verify-feature/ #
|
|
1053
|
-
│ ├── pdd-code-reviewer/ #
|
|
1054
|
-
│ ├── pdd-doc-change/
|
|
1055
|
-
│ ├── pdd-doc-gardener/
|
|
1056
|
-
│ ├── pdd-entropy-reduction/
|
|
1057
|
-
│
|
|
420
|
+
├── core/ # 11 个核心技能 / 11 Core Skills (必装 / Required)
|
|
421
|
+
│ ├── pdd-main/ # 主协调器 / Main coordinator
|
|
422
|
+
│ ├── pdd-ba/ # 业务分析 / Business analysis
|
|
423
|
+
│ ├── pdd-extract-features/ # 特征提取 / Feature extraction
|
|
424
|
+
│ ├── pdd-generate-spec/ # 规格生成 / Spec generation
|
|
425
|
+
│ ├── pdd-implement-feature/ # 代码实现 / Code implementation
|
|
426
|
+
│ ├── pdd-verify-feature/ # 功能验证 / Feature verification
|
|
427
|
+
│ ├── pdd-code-reviewer/ # 代码审查 / Code review
|
|
428
|
+
│ ├── pdd-doc-change/ # 变更文档 / Document change
|
|
429
|
+
│ ├── pdd-doc-gardener/ # 文档维护 / Document maintenance
|
|
430
|
+
│ ├── pdd-entropy-reduction/ # 技术债务 / Technical debt
|
|
431
|
+
│ ├── official-doc-writer/ # 公文生成 / Official documents
|
|
432
|
+
│ └── pdd-vm/ # 可视化监控 / Visual monitoring
|
|
1058
433
|
│
|
|
1059
|
-
├── expert/ # 专家技能 (12
|
|
1060
|
-
│ ├── expert-security/ #
|
|
1061
|
-
│ ├── expert-performance/ #
|
|
1062
|
-
│ ├── expert-mysql/ # MySQL
|
|
1063
|
-
│ ├── expert-ruoyi/ #
|
|
1064
|
-
│ ├── expert-ruoyi-permission/ #
|
|
1065
|
-
│ ├── expert-activiti/ # Activiti
|
|
1066
|
-
│ ├── expert-vue3/ # Vue3
|
|
1067
|
-
│ ├── expert-springcloud/ # SpringCloud
|
|
1068
|
-
│ ├── expert-bug-fixer/ # Bug
|
|
1069
|
-
│ ├──
|
|
1070
|
-
│ ├── software-
|
|
1071
|
-
│
|
|
1072
|
-
│ └── system-architect/ # 系统架构师
|
|
434
|
+
├── expert/ # 专家技能 / Expert Skills (12个)
|
|
435
|
+
│ ├── expert-security/ # 安全审计 / Security audit
|
|
436
|
+
│ ├── expert-performance/ # 性能优化 / Performance
|
|
437
|
+
│ ├── expert-mysql/ # MySQL数据库 / MySQL
|
|
438
|
+
│ ├── expert-ruoyi/ # 若依框架 / RuoYi framework
|
|
439
|
+
│ ├── expert-ruoyi-permission/ # 若依权限 / RuoYi permission
|
|
440
|
+
│ ├── expert-activiti/ # Activiti工作流 / Workflow
|
|
441
|
+
│ ├── expert-vue3/ # Vue3前端 / Vue3 frontend
|
|
442
|
+
│ ├── expert-springcloud/ # SpringCloud微服务 / Microservices
|
|
443
|
+
│ ├── expert-bug-fixer/ # Bug修复 / Bug fixing
|
|
444
|
+
│ ├── software-architect/ # 软件架构 / Software architecture
|
|
445
|
+
│ ├── software-engineer/ # 软件工程 / Software engineering
|
|
446
|
+
│ └── system-architect/ # 系统架构 / System architecture
|
|
1073
447
|
│
|
|
1074
|
-
├── entropy/ #
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1078
|
-
│ └── expert-auto-refactor/ # 自动重构专家
|
|
1079
|
-
│
|
|
1080
|
-
├── pr/ # PR与交付技能 (7个)
|
|
1081
|
-
│ ├── pdd-template-engine/ # PRD感知动态模板引擎
|
|
1082
|
-
│ ├── pdd-multi-review/ # 多轮代码审查
|
|
1083
|
-
│ ├── pdd-pr-create/ # PR创建
|
|
1084
|
-
│ ├── pdd-pr-review/ # PR审查
|
|
1085
|
-
│ ├── pdd-pr-merge/ # PR合并
|
|
1086
|
-
│ ├── pdd-pr-batch/ # 批量PR处理
|
|
1087
|
-
│ └── pdd-task-manager/ # 任务管理
|
|
1088
|
-
│
|
|
1089
|
-
├── openspec/ # OpenSpec 协作技能
|
|
1090
|
-
│ ├── openspec-explore/
|
|
1091
|
-
│ ├── openspec-new-change/
|
|
1092
|
-
│ ├── openspec-ff-change/
|
|
1093
|
-
│ └── ... (10 个)
|
|
1094
|
-
│
|
|
1095
|
-
└── software/ # 通用软件工程技能
|
|
1096
|
-
├── system-architect/
|
|
1097
|
-
├── software-architect/
|
|
1098
|
-
└── software-engineer/
|
|
448
|
+
├── entropy/ # 熵减治理 / Entropy reduction (4个)
|
|
449
|
+
├── pr/ # PR与交付 / PR & Delivery (7个)
|
|
450
|
+
├── openspec/ # OpenSpec 协作 / Collaboration (10个)
|
|
451
|
+
└── software/ # 通用软件工程 / General software engineering
|
|
1099
452
|
```
|
|
1100
453
|
|
|
1101
454
|
***
|
|
1102
455
|
|
|
1103
|
-
## 配置中心
|
|
456
|
+
## 配置中心 / Configuration Center
|
|
1104
457
|
|
|
1105
|
-
> **Single Source of Truth
|
|
1106
|
-
|
|
1107
|
-
|
|
1108
|
-
|
|
1109
|
-
| 配置文件 | 用途 | 消费方 |
|
|
1110
|
-
|---------|------|--------|
|
|
1111
|
-
| `config/bug-patterns.yaml` | Bug模式库（14个模式） | pdd-code-reviewer, pdd-verify-feature, pdd-implement-feature, pdd-template-engine, expert-ruoyi |
|
|
1112
|
-
| `config/prd-rules.yaml` | PRD检测规则（30条，6大类） | pdd-linter, run-linters.js |
|
|
1113
|
-
| `config/gate-config.yaml` | 质量门控配置（4级阻断+评分权重） | gate-engine.js |
|
|
458
|
+
> **Single Source of Truth 原则 / Principle**: 所有配置集中管理，技能和脚本通过引用获取，避免散落和不一致。
|
|
459
|
+
>
|
|
460
|
+
> **English**: All configurations are centrally managed; skills and scripts access them by reference to avoid scattering and inconsistency.
|
|
1114
461
|
|
|
1115
|
-
###
|
|
462
|
+
### 配置文件一览 / Configuration Files
|
|
1116
463
|
|
|
1117
|
-
|
|
1118
|
-
|
|
1119
|
-
|
|
1120
|
-
|
|
1121
|
-
|
|
1122
|
-
│ ├── PATTERN-003 枚举硬编码/编码不一致
|
|
1123
|
-
│ ├── PATTERN-004 alert()未用safeAlert()包装
|
|
1124
|
-
│ ├── PATTERN-005 my-tasks查询条件不完整
|
|
1125
|
-
│ ├── PATTERN-006 Options接口路由顺序(同002)
|
|
1126
|
-
│ └── PATTERN-007 编号生成未检查已存在记录
|
|
1127
|
-
└── categories.ruoyi # 若依专用 PATTERN-R001~R007
|
|
1128
|
-
├── PATTERN-R001 权限注解缺失
|
|
1129
|
-
├── PATTERN-R002 菜单配置不完整
|
|
1130
|
-
├── PATTERN-R003 数据权限未配置
|
|
1131
|
-
├── PATTERN-R004 Redis缓存未清除
|
|
1132
|
-
├── PATTERN-R005 参数校验缺失
|
|
1133
|
-
├── PATTERN-R006 XSS防护缺失
|
|
1134
|
-
└── PATTERN-R007 操作日志缺失
|
|
1135
|
-
```
|
|
464
|
+
| 配置文件 / Config File | 用途 / Purpose | 消费方 / Consumers |
|
|
465
|
+
| -------------------------- | ----------------- | ------------------------------------------------------------------------------------------------ |
|
|
466
|
+
| `config/bug-patterns.yaml` | Bug模式库（14个模式 / 14 patterns） | pdd-code-reviewer, pdd-verify-feature, pdd-implement-feature, pdd-template-engine, expert-ruoyi |
|
|
467
|
+
| `config/prd-rules.yaml` | PRD检测规则（30条 / 30 rules） | pdd-linter, run-linters.js |
|
|
468
|
+
| `config/gate-config.yaml` | 质量门控配置（4级 / 4 levels） | gate-engine.js |
|
|
1136
469
|
|
|
1137
|
-
###
|
|
470
|
+
### Bug模式库架构 / Bug Pattern Library
|
|
1138
471
|
|
|
1139
472
|
```
|
|
1140
|
-
config/
|
|
1141
|
-
├──
|
|
1142
|
-
├──
|
|
1143
|
-
├──
|
|
1144
|
-
│ ├──
|
|
1145
|
-
│ ├──
|
|
1146
|
-
│ ├──
|
|
1147
|
-
│ ├──
|
|
1148
|
-
│
|
|
1149
|
-
|
|
1150
|
-
├──
|
|
1151
|
-
|
|
1152
|
-
|
|
1153
|
-
|
|
1154
|
-
|
|
1155
|
-
|
|
1156
|
-
|
|
1157
|
-
├── api-param-location # 参数位置
|
|
1158
|
-
└── api-error-format # 错误格式
|
|
473
|
+
config/bug-patterns.yaml ← 唯一真相源 / Single Source of Truth
|
|
474
|
+
├── categories.general # 通用模式 / General Patterns PATTERN-001~007
|
|
475
|
+
│ ├── PATTERN-001 datetime字段类型陷阱 / Datetime field type trap
|
|
476
|
+
│ ├── PATTERN-002 静态路由注册顺序错误 / Static route registration order
|
|
477
|
+
│ ├── PATTERN-003 枚举硬编码/编码不一致 / Enum hardcoding
|
|
478
|
+
│ ├── PATTERN-004 alert()未用safeAlert()包装 / alert() not wrapped
|
|
479
|
+
│ ├── PATTERN-005 my-tasks查询条件不完整 / Query condition incomplete
|
|
480
|
+
│ ├── PATTERN-006 Options接口路由顺序 / Options API route order
|
|
481
|
+
│ └── PATTERN-007 编号生成未检查已存在记录 / ID generation without existence check
|
|
482
|
+
└── categories.ruoyi # 若依专用 / RuoYi Specific PATTERN-R001~R007
|
|
483
|
+
├── PATTERN-R001 权限注解缺失 / Missing permission annotation
|
|
484
|
+
├── PATTERN-R002 菜单配置不完整 / Incomplete menu config
|
|
485
|
+
├── PATTERN-R003 数据权限未配置 / Data permission not configured
|
|
486
|
+
├── PATTERN-R004 Redis缓存未清除 / Redis cache not cleared
|
|
487
|
+
├── PATTERN-R005 参数校验缺失 / Missing parameter validation
|
|
488
|
+
├── PATTERN-R006 XSS防护缺失 / Missing XSS protection
|
|
489
|
+
└── PATTERN-R007 操作日志缺失 / Missing operation log
|
|
1159
490
|
```
|
|
1160
491
|
|
|
1161
|
-
### 质量门控流程
|
|
492
|
+
### 质量门控流程 / Quality Gate Process
|
|
1162
493
|
|
|
1163
494
|
```
|
|
1164
|
-
PRD文档 → prd-linter (30条规则) → gate-engine (4级门控) → 评分卡
|
|
495
|
+
PRD文档 / PRD Doc → prd-linter (30条规则 / 30 rules) → gate-engine (4级门控 / 4 levels) → 评分卡 / Scorecard
|
|
1165
496
|
│
|
|
1166
497
|
┌─────────────┼─────────────┐
|
|
1167
498
|
▼ ▼ ▼
|
|
@@ -1178,66 +509,46 @@ PRD文档 → prd-linter (30条规则) → gate-engine (4级门控) → 评分
|
|
|
1178
509
|
❌ FAIL ✅ PASS
|
|
1179
510
|
```
|
|
1180
511
|
|
|
1181
|
-
### 更新流程
|
|
1182
|
-
|
|
1183
|
-
```bash
|
|
1184
|
-
# 新增Bug模式 → 只需编辑一个文件
|
|
1185
|
-
vim config/bug-patterns.yaml # 各skill自动通过引用获取
|
|
1186
|
-
|
|
1187
|
-
# 修改BLOCKER规则 → 只需编辑一个文件
|
|
1188
|
-
vim config/gate-config.yaml # gate-engine.js自动读取
|
|
1189
|
-
|
|
1190
|
-
# 修改PRD检测规则 → 只需编辑一个文件
|
|
1191
|
-
vim config/prd-rules.yaml # run-linters.js自动读取
|
|
1192
|
-
```
|
|
1193
|
-
|
|
1194
512
|
***
|
|
1195
513
|
|
|
1196
|
-
## API 层
|
|
514
|
+
## API 层 / API Layer
|
|
1197
515
|
|
|
1198
|
-
### 启动 API 服务器
|
|
516
|
+
### 启动 API 服务器 / Start API Server
|
|
1199
517
|
|
|
1200
518
|
```bash
|
|
1201
|
-
# 默认端口 3000
|
|
519
|
+
# 默认端口 / Default port 3000
|
|
1202
520
|
pdd api
|
|
1203
521
|
|
|
1204
522
|
# 自定义端口 + CORS
|
|
1205
523
|
pdd api -p 8080 --cors
|
|
1206
524
|
```
|
|
1207
525
|
|
|
1208
|
-
### 调用示例
|
|
526
|
+
### 调用示例 / Usage Examples
|
|
1209
527
|
|
|
1210
528
|
```bash
|
|
1211
|
-
# 生成规格
|
|
529
|
+
# 生成规格 / Generate spec
|
|
1212
530
|
curl -X POST http://localhost:3000/api/v1/generate \
|
|
1213
531
|
-H "Content-Type: application/json" \
|
|
1214
532
|
-d '{"prd_path": "./prd.prdx", "template": "default"}'
|
|
1215
533
|
|
|
1216
|
-
# 验证功能
|
|
534
|
+
# 验证功能 / Verify feature
|
|
1217
535
|
curl -X POST http://localhost:3000/api/v1/verify \
|
|
1218
536
|
-H "Content-Type: application/json" \
|
|
1219
537
|
-d '{"spec_path": "./spec.md", "source_dir": "./src"}'
|
|
1220
538
|
|
|
1221
|
-
# 列出技能
|
|
539
|
+
# 列出技能 / List skills
|
|
1222
540
|
curl http://localhost:3000/api/v1/skills?category=core
|
|
1223
541
|
```
|
|
1224
542
|
|
|
1225
|
-
### gRPC 调用示例
|
|
1226
|
-
|
|
1227
|
-
```bash
|
|
1228
|
-
# 基于 HTTP/2 + Protobuf JSON 格式
|
|
1229
|
-
curl -X POST http://localhost:50051/pdd.SkillService/ListSkills \
|
|
1230
|
-
-H "Content-Type: application/grpc+protojson" \
|
|
1231
|
-
-d '{}'
|
|
1232
|
-
```
|
|
1233
|
-
|
|
1234
543
|
***
|
|
1235
544
|
|
|
1236
|
-
## MCP 协议集成
|
|
545
|
+
## MCP 协议集成 / MCP Protocol Integration
|
|
1237
546
|
|
|
1238
547
|
PDD-Skills 可作为 MCP Server 被 Claude Desktop / Cursor / Windsurf 等 AI IDE 直接调用：
|
|
1239
548
|
|
|
1240
|
-
|
|
549
|
+
> **English**: PDD-Skills can serve as an MCP Server directly callable by AI IDEs like Claude Desktop, Cursor, and Windsurf.
|
|
550
|
+
|
|
551
|
+
### 配置 Claude Desktop / Configure Claude Desktop
|
|
1241
552
|
|
|
1242
553
|
```json
|
|
1243
554
|
{
|
|
@@ -1250,22 +561,20 @@ PDD-Skills 可作为 MCP Server 被 Claude Desktop / Cursor / Windsurf 等 AI ID
|
|
|
1250
561
|
}
|
|
1251
562
|
```
|
|
1252
563
|
|
|
1253
|
-
### 可用 Tools
|
|
1254
|
-
|
|
1255
|
-
AI Agent 可以直接调用以下工具：
|
|
564
|
+
### 可用 Tools / Available Tools
|
|
1256
565
|
|
|
1257
|
-
| Tool
|
|
566
|
+
| Tool | 参数 / Parameters | 返回值 / Returns |
|
|
1258
567
|
| -------------------- | ----------------------- | ------------- |
|
|
1259
|
-
| `pdd_generate_spec`
|
|
1260
|
-
| `pdd_generate_code`
|
|
1261
|
-
| `pdd_verify_feature` |
|
|
1262
|
-
| `pdd_code_review`
|
|
1263
|
-
| `pdd_list_skills`
|
|
1264
|
-
| `pdd_get_status`
|
|
568
|
+
| `pdd_generate_spec` | prd_path, template | 生成的规格文件路径 / Generated spec path |
|
|
569
|
+
| `pdd_generate_code` | spec_path, feature_id | 生成的文件列表 / Generated files |
|
|
570
|
+
| `pdd_verify_feature` | spec_path, source_dir | 验证结果 / Verification result |
|
|
571
|
+
| `pdd_code_review` | source_dir, rules | 审查报告 / Review report |
|
|
572
|
+
| `pdd_list_skills` | category, language | 技能列表 / Skills list |
|
|
573
|
+
| `pdd_get_status` | - | 系统状态 / System status |
|
|
1265
574
|
|
|
1266
575
|
***
|
|
1267
576
|
|
|
1268
|
-
## SDK 使用指南
|
|
577
|
+
## SDK 使用指南 / SDK Guide
|
|
1269
578
|
|
|
1270
579
|
### JavaScript SDK
|
|
1271
580
|
|
|
@@ -1279,29 +588,21 @@ const client = new PDDJS({
|
|
|
1279
588
|
enableCache: true
|
|
1280
589
|
});
|
|
1281
590
|
|
|
1282
|
-
// 事件监听
|
|
591
|
+
// 事件监听 / Event listening
|
|
1283
592
|
client.on('success', ({ method, result }) => {
|
|
1284
|
-
console.log(`✅ ${method}
|
|
593
|
+
console.log(`✅ ${method} 完成 / completed`);
|
|
1285
594
|
});
|
|
1286
595
|
|
|
1287
|
-
// 完整工作流
|
|
596
|
+
// 完整工作流 / Complete workflow
|
|
1288
597
|
const spec = await client.generateSpec({ prdPath: './prd.prdx' });
|
|
1289
|
-
console.log(`提取了 ${spec.features.length}
|
|
1290
|
-
|
|
1291
|
-
for (const feature of spec.features.slice(0, 3)) {
|
|
1292
|
-
const code = await client.generateCode({
|
|
1293
|
-
specPath: spec.specPath,
|
|
1294
|
-
featureId: feature.id
|
|
1295
|
-
});
|
|
1296
|
-
console.log(` 📄 ${feature.id}: ${code.filesGenerated.length} files`);
|
|
1297
|
-
}
|
|
598
|
+
console.log(`提取了 / Extracted ${spec.features.length} 个功能点 / features`);
|
|
1298
599
|
|
|
1299
|
-
// 验证
|
|
600
|
+
// 验证 / Verification
|
|
1300
601
|
const verifyResult = await client.verifyFeature({
|
|
1301
602
|
specPath: spec.specPath,
|
|
1302
603
|
sourceDir: './src'
|
|
1303
604
|
});
|
|
1304
|
-
console.log(
|
|
605
|
+
console.log(`覆盖率 / Coverage: ${verifyResult.coveragePercent}%`);
|
|
1305
606
|
|
|
1306
607
|
await client.close();
|
|
1307
608
|
```
|
|
@@ -1314,23 +615,20 @@ from pdd_sdk import PDDClient
|
|
|
1314
615
|
|
|
1315
616
|
async def main():
|
|
1316
617
|
async with PDDClient(endpoint="http://localhost:3000", debug=True) as client:
|
|
1317
|
-
#
|
|
1318
|
-
client.on("request:end", lambda e: print(f"✅ {e['method']} ({e['duration_ms']}ms)"))
|
|
1319
|
-
|
|
1320
|
-
# 生成规格
|
|
618
|
+
# 生成规格 / Generate spec
|
|
1321
619
|
spec = await client.generate_spec(prd_path="./prd.prdx")
|
|
1322
|
-
print(f"生成 {len(spec.features)} 个功能点")
|
|
620
|
+
print(f"生成 / Generated {len(spec.features)} 个功能点 / features")
|
|
1323
621
|
|
|
1324
|
-
# 批量生成代码
|
|
622
|
+
# 批量生成代码 / Batch generate code
|
|
1325
623
|
results = await client.batch_generate_specs([
|
|
1326
624
|
{"spec_path": spec.spec_path, "feature_id": f["id"]}
|
|
1327
625
|
for f in spec.features[:3]
|
|
1328
626
|
])
|
|
1329
627
|
|
|
1330
|
-
# 验证
|
|
628
|
+
# 验证 / Verify
|
|
1331
629
|
verify = await client.verify_feature(spec_path=spec.spec_path, source_dir="./src")
|
|
1332
|
-
print(f"
|
|
1333
|
-
print(f"
|
|
630
|
+
print(f"覆盖率 / Coverage: {verify.coverage_percent}%")
|
|
631
|
+
print(f"等级 / Grade: {verify.grade}")
|
|
1334
632
|
|
|
1335
633
|
if __name__ == "__main__":
|
|
1336
634
|
asyncio.run(main())
|
|
@@ -1338,9 +636,9 @@ if __name__ == "__main__":
|
|
|
1338
636
|
|
|
1339
637
|
***
|
|
1340
638
|
|
|
1341
|
-
## 智能引擎
|
|
639
|
+
## 智能引擎 / Intelligence Engine
|
|
1342
640
|
|
|
1343
|
-
### 缓存使用
|
|
641
|
+
### 缓存使用 / Cache Usage
|
|
1344
642
|
|
|
1345
643
|
```javascript
|
|
1346
644
|
import { createSystemCache } from 'pdd-skills/lib/cache/system-cache.js';
|
|
@@ -1351,16 +649,16 @@ const cache = createSystemCache({
|
|
|
1351
649
|
l3: { maxSize: 2000, ttl: 7200000, dir: './cache' } // 2h
|
|
1352
650
|
});
|
|
1353
651
|
|
|
1354
|
-
// 自动三级穿透
|
|
652
|
+
// 自动三级穿透 / Auto three-level penetration
|
|
1355
653
|
await cache.set('spec:user-auth', specData);
|
|
1356
|
-
const hit = await cache.get('spec:user-auth'); // L1 命中
|
|
654
|
+
const hit = await cache.get('spec:user-auth'); // L1 命中 / L1 hit
|
|
1357
655
|
|
|
1358
|
-
// 命中统计
|
|
656
|
+
// 命中统计 / Hit statistics
|
|
1359
657
|
console.log(cache.stats());
|
|
1360
658
|
// { l1: { hits: 95, misses: 5, rate: 0.95 }, ... }
|
|
1361
659
|
```
|
|
1362
660
|
|
|
1363
|
-
### Token 预算
|
|
661
|
+
### Token 预算 / Token Budget
|
|
1364
662
|
|
|
1365
663
|
```javascript
|
|
1366
664
|
import { TokenBudgetManager } from 'pdd-skills/lib/token/budget-manager.js';
|
|
@@ -1368,71 +666,47 @@ import { TokenBudgetManager } from 'pdd-skills/lib/token/budget-manager.js';
|
|
|
1368
666
|
const budget = new TokenBudgetManager({ totalTokens: 100000 });
|
|
1369
667
|
|
|
1370
668
|
budget.on('warning', ({ phase, percent }) => {
|
|
1371
|
-
console.log(`⚠️ ${phase} 阶段已使用 ${percent}%`);
|
|
669
|
+
console.log(`⚠️ ${phase} 阶段已使用 / phase used ${percent}%`);
|
|
1372
670
|
});
|
|
1373
671
|
|
|
1374
672
|
budget.on('critical', ({ phase }) => {
|
|
1375
|
-
console.log(`🚫 ${phase}
|
|
673
|
+
console.log(`🚫 ${phase} 阶段超预算! / phase exceeded budget!`);
|
|
1376
674
|
});
|
|
1377
675
|
|
|
1378
|
-
// 在各阶段消费
|
|
676
|
+
// 在各阶段消费 / Consume in phases
|
|
1379
677
|
budget.consume('analysis', 5000);
|
|
1380
678
|
budget.consume('implementation', 35000);
|
|
1381
679
|
|
|
1382
|
-
// 生成报告
|
|
680
|
+
// 生成报告 / Generate report
|
|
1383
681
|
console.log(budget.generateReport());
|
|
1384
682
|
```
|
|
1385
683
|
|
|
1386
|
-
### 质量评分
|
|
684
|
+
### 质量评分 / Quality Scoring
|
|
1387
685
|
|
|
1388
686
|
```javascript
|
|
1389
687
|
import { QualityScorer } from 'pdd-skills/lib/quality/scorer.js';
|
|
1390
688
|
|
|
1391
689
|
const scorer = new QualityScorer();
|
|
1392
690
|
|
|
1393
|
-
// 评分单个文件
|
|
691
|
+
// 评分单个文件 / Score single file
|
|
1394
692
|
const result = await scorer.scoreFile('./src/user-service.js');
|
|
1395
693
|
console.log(`${result.grade} (${result.score}/100)`);
|
|
1396
694
|
// B (72/100) — readability: B, maintainability: A, robustness: C, ...
|
|
1397
695
|
|
|
1398
|
-
// 评分整个目录
|
|
696
|
+
// 评分整个目录 / Score directory
|
|
1399
697
|
const report = await scorer.scoreDirectory('./src', {
|
|
1400
698
|
format: 'table', // table | json | markdown
|
|
1401
|
-
threshold: 'C' //
|
|
1402
|
-
});
|
|
1403
|
-
```
|
|
1404
|
-
|
|
1405
|
-
### 迭代优化
|
|
1406
|
-
|
|
1407
|
-
```javascript
|
|
1408
|
-
import { IterationController } from 'pdd-skills/lib/iteration/controller.js';
|
|
1409
|
-
|
|
1410
|
-
const controller = new IterationController({
|
|
1411
|
-
maxRounds: 5,
|
|
1412
|
-
convergenceThreshold: 0.05,
|
|
1413
|
-
reviewer: autoReviewer,
|
|
1414
|
-
fixer: autoFixer
|
|
1415
|
-
});
|
|
1416
|
-
|
|
1417
|
-
controller.on('round-complete', ({ round, score, improved }) => {
|
|
1418
|
-
console.log(`Round ${round}: score=${score.toFixed(1)}, improved=${improved ? 'yes' : 'no'}`);
|
|
699
|
+
threshold: 'C' // 低于此级别高亮 / Highlight below this level
|
|
1419
700
|
});
|
|
1420
|
-
|
|
1421
|
-
const result = await controller.run({
|
|
1422
|
-
specPath: './specs/auth.md',
|
|
1423
|
-
sourceDir: './src'
|
|
1424
|
-
});
|
|
1425
|
-
|
|
1426
|
-
console.log(`完成 ${result.roundsCompleted} 轮, 最终得分: ${result.finalScore}`);
|
|
1427
701
|
```
|
|
1428
702
|
|
|
1429
703
|
***
|
|
1430
704
|
|
|
1431
|
-
## 插件系统
|
|
705
|
+
## 插件系统 / Plugin System
|
|
1432
706
|
|
|
1433
|
-
### 开发插件
|
|
707
|
+
### 开发插件 / Develop Plugin
|
|
1434
708
|
|
|
1435
|
-
最小可行插件只需 2
|
|
709
|
+
最小可行插件只需 2 个文件 / Minimum viable plugin requires only 2 files:
|
|
1436
710
|
|
|
1437
711
|
**plugin.json**
|
|
1438
712
|
|
|
@@ -1440,7 +714,7 @@ console.log(`完成 ${result.roundsCompleted} 轮, 最终得分: ${result.finalS
|
|
|
1440
714
|
{
|
|
1441
715
|
"name": "my-plugin",
|
|
1442
716
|
"version": "1.0.0",
|
|
1443
|
-
"description": "我的插件",
|
|
717
|
+
"description": "我的插件 / My plugin",
|
|
1444
718
|
"main": "index.js",
|
|
1445
719
|
"pdd": ">=3.0.0",
|
|
1446
720
|
"hooks": ["post-verify"],
|
|
@@ -1457,27 +731,27 @@ import { PluginBase } from 'pdd-skills/lib/plugin/plugin-sdk.js';
|
|
|
1457
731
|
|
|
1458
732
|
export default class MyPlugin extends PluginBase {
|
|
1459
733
|
async onActivate(context) {
|
|
1460
|
-
context.logger.info('MyPlugin 已激活!');
|
|
734
|
+
context.logger.info('MyPlugin 已激活! / Activated!');
|
|
1461
735
|
|
|
1462
736
|
this.registerCommand('greet', {
|
|
1463
|
-
description: '打个招呼',
|
|
737
|
+
description: '打个招呼 / Say hello',
|
|
1464
738
|
handler: (args) => `Hello, ${args.name || 'world'}!`
|
|
1465
739
|
});
|
|
1466
740
|
}
|
|
1467
741
|
|
|
1468
742
|
async onDeactivate(context) {
|
|
1469
|
-
context.logger.info('MyPlugin 正在停用...');
|
|
743
|
+
context.logger.info('MyPlugin 正在停用... / Deactivating...');
|
|
1470
744
|
}
|
|
1471
745
|
}
|
|
1472
746
|
```
|
|
1473
747
|
|
|
1474
|
-
### 加载插件
|
|
748
|
+
### 加载插件 / Load Plugin
|
|
1475
749
|
|
|
1476
750
|
```bash
|
|
1477
|
-
# 复制到插件目录
|
|
751
|
+
# 复制到插件目录 / Copy to plugins directory
|
|
1478
752
|
cp -r my-plugin ~/.pdd-skills/plugins/
|
|
1479
753
|
|
|
1480
|
-
# 通过 PluginManager 加载
|
|
754
|
+
# 通过 PluginManager 加载 / Load via PluginManager
|
|
1481
755
|
node -e "
|
|
1482
756
|
import { PluginManager } from './lib/plugin/plugin-manager.js';
|
|
1483
757
|
const mgr = new PluginManager({ pluginsDir: './plugins' });
|
|
@@ -1488,28 +762,28 @@ console.log(mgr.listPlugins());
|
|
|
1488
762
|
|
|
1489
763
|
***
|
|
1490
764
|
|
|
1491
|
-
## OpenClaw 集成
|
|
765
|
+
## OpenClaw 集成 / OpenClaw Integration
|
|
1492
766
|
|
|
1493
|
-
### 启动 OpenClaw 服务
|
|
767
|
+
### 启动 OpenClaw 服务 / Start OpenClaw Service
|
|
1494
768
|
|
|
1495
769
|
```bash
|
|
1496
|
-
#
|
|
770
|
+
# 启动服务（后台守护进程 / Daemon mode）
|
|
1497
771
|
pdd openclaw start -p 5001 -t my-secret-token --daemon
|
|
1498
772
|
|
|
1499
|
-
# 查看状态
|
|
773
|
+
# 查看状态 / Check status
|
|
1500
774
|
pdd openclaw status
|
|
1501
775
|
|
|
1502
|
-
# 列出已注册工具
|
|
776
|
+
# 列出已注册工具 / List registered tools
|
|
1503
777
|
pdd openclaw list-tools
|
|
1504
778
|
|
|
1505
|
-
# 测试工具调用
|
|
779
|
+
# 测试工具调用 / Test tool invocation
|
|
1506
780
|
pdd openclaw test -n pdd_generate_spec
|
|
1507
781
|
|
|
1508
|
-
# 查看通信日志
|
|
782
|
+
# 查看通信日志 / View communication logs
|
|
1509
783
|
pdd openclaw logs --tail
|
|
1510
784
|
```
|
|
1511
785
|
|
|
1512
|
-
### 数据同步
|
|
786
|
+
### 数据同步 / Data Sync
|
|
1513
787
|
|
|
1514
788
|
```javascript
|
|
1515
789
|
import { DataSyncManager, SyncScheduler } from 'pdd-skills/lib/openclaw/data-sync.js';
|
|
@@ -1519,260 +793,178 @@ const sync = new DataSyncManager({
|
|
|
1519
793
|
conflictStrategy: 'last-write-wins'
|
|
1520
794
|
});
|
|
1521
795
|
|
|
1522
|
-
// 同步四种数据类型
|
|
796
|
+
// 同步四种数据类型 / Sync four data types
|
|
1523
797
|
await sync.syncSkills();
|
|
1524
798
|
await sync.syncConfig();
|
|
1525
799
|
await sync.syncCache();
|
|
1526
800
|
await sync.syncReports();
|
|
1527
801
|
|
|
1528
|
-
// 定时同步（每5
|
|
802
|
+
// 定时同步（每5分钟 / Every 5 minutes）
|
|
1529
803
|
const scheduler = new SyncScheduler(sync, { interval: 300000 });
|
|
1530
804
|
scheduler.start();
|
|
1531
805
|
```
|
|
1532
806
|
|
|
1533
807
|
***
|
|
1534
808
|
|
|
1535
|
-
## 项目结构
|
|
809
|
+
## 项目结构 / Project Structure
|
|
1536
810
|
|
|
1537
811
|
```
|
|
1538
812
|
pdd-skills-v3/
|
|
1539
813
|
├── bin/
|
|
1540
|
-
│ └── pdd.js # CLI 入口 (20+ 子命令)
|
|
814
|
+
│ └── pdd.js # CLI 入口 / CLI Entry (20+ 子命令 / subcommands)
|
|
1541
815
|
│
|
|
1542
|
-
├── lib/ # 核心库 (~80 个模块)
|
|
1543
|
-
│ ├── api-server.js # HTTP 服务器
|
|
1544
|
-
│ ├── api-routes.js # 18 个 RESTful 端点
|
|
1545
|
-
│ ├── mcp-server.js # MCP 协议服务器
|
|
1546
|
-
│ ├── grpc/ # gRPC 兼容层
|
|
1547
|
-
│
|
|
1548
|
-
│ │ ├── proto-definitions.js # Proto3 编解码
|
|
1549
|
-
│ │ └── grpc-routes.js # 8 个方法路由
|
|
1550
|
-
│ ├── sdk-base.js # SDK 统一接口
|
|
816
|
+
├── lib/ # 核心库 / Core Library (~80 个模块 / modules)
|
|
817
|
+
│ ├── api-server.js # HTTP 服务器 / HTTP Server
|
|
818
|
+
│ ├── api-routes.js # 18 个 RESTful 端点 / Endpoints
|
|
819
|
+
│ ├── mcp-server.js # MCP 协议服务器 / MCP Protocol Server
|
|
820
|
+
│ ├── grpc/ # gRPC 兼容层 / gRPC Compatible Layer
|
|
821
|
+
│ ├── sdk-base.js # SDK 统一接口 / SDK Unified Interface
|
|
1551
822
|
│ ├── sdk-js.js # JavaScript SDK
|
|
1552
|
-
│ ├── sdk-python/ # Python SDK (8 文件)
|
|
1553
|
-
│ ├── plugin/ # 插件系统
|
|
1554
|
-
│
|
|
1555
|
-
│
|
|
1556
|
-
│
|
|
1557
|
-
│
|
|
1558
|
-
│ ├──
|
|
1559
|
-
│
|
|
1560
|
-
│ │ ├── cli-integration.js
|
|
1561
|
-
│ │ ├── api-integration.js
|
|
1562
|
-
│ │ └── data-sync.js
|
|
1563
|
-
│ ├── cache/ # 三级缓存
|
|
1564
|
-
│ │ ├── system-cache.js # L1/L2/L3 缓存
|
|
1565
|
-
│ │ └── cache-config.js # 缓存配置
|
|
1566
|
-
│ ├── token/ # Token 预算
|
|
1567
|
-
│ │ ├── budget-manager.js # 预算管理器
|
|
1568
|
-
│ │ └── budget-alert.js # 预算预警
|
|
1569
|
-
│ ├── quality/ # 质量评分
|
|
1570
|
-
│ │ ├── scorer.js # 五维引擎
|
|
1571
|
-
│ │ └── rules/ # 31 条规则
|
|
1572
|
-
│ │ ├── readability.js
|
|
1573
|
-
│ │ ├── maintainability.js
|
|
1574
|
-
│ │ ├── robustness.js
|
|
1575
|
-
│ │ ├── performance.js
|
|
1576
|
-
│ │ └── security.js
|
|
1577
|
-
│ ├── iteration/ # 迭代优化
|
|
1578
|
-
│ │ ├── controller.js # 迭代控制器
|
|
1579
|
-
│ │ ├── auto-reviewer.js # 自动审查
|
|
1580
|
-
│ │ └── auto-fixer.js # 自动修复
|
|
1581
|
-
│ │
|
|
1582
|
-
│ └── vm/ # ★ PDD Visual Manager (Phase 7 新增, ~38 文件)
|
|
1583
|
-
│ ├── index.js # VM 入口
|
|
1584
|
-
│ ├── data-aggregator.js # 数据聚合器
|
|
1585
|
-
│ ├── state-manager.js # 状态管理器
|
|
1586
|
-
│ ├── event-bus.js # 事件总线
|
|
1587
|
-
│ │
|
|
1588
|
-
│ ├── dashboard/ # Web Dashboard (零依赖 SPA)
|
|
1589
|
-
│ │ ├── server.js # HTTP+SSE 服务器
|
|
1590
|
-
│ │ ├── sse.js # SSE 推送服务
|
|
1591
|
-
│ │ ├── api-routes.js # 11 个 REST API 端点
|
|
1592
|
-
│ │ ├── index.html # SPA 主页面
|
|
1593
|
-
│ │ ├── css/
|
|
1594
|
-
│ │ │ └── dashboard.css
|
|
1595
|
-
│ │ └── js/
|
|
1596
|
-
│ │ ├── app.js # SPA 框架
|
|
1597
|
-
│ │ ├── pipeline-view.js
|
|
1598
|
-
│ │ ├── kanban-view.js
|
|
1599
|
-
│ │ ├── quality-view.js
|
|
1600
|
-
│ │ ├── system-view.js
|
|
1601
|
-
│ │ └── charts/ # Canvas 图表引擎
|
|
1602
|
-
│ │ ├── canvas-engine.js
|
|
1603
|
-
│ │ ├── radar.js
|
|
1604
|
-
│ │ ├── histogram.js
|
|
1605
|
-
│ │ ├── gauge.js
|
|
1606
|
-
│ │ ├── line-chart.js
|
|
1607
|
-
│ │ └── horizontal-bar.js
|
|
1608
|
-
│ │
|
|
1609
|
-
│ ├── tui/ # Terminal TUI (零依赖 ANSI)
|
|
1610
|
-
│ │ ├── tui.js # 主控制器
|
|
1611
|
-
│ │ ├── renderer.js # ANSI 渲染引擎
|
|
1612
|
-
│ │ ├── input.js # 键盘输入处理
|
|
1613
|
-
│ │ ├── screens/ # 4 个屏幕
|
|
1614
|
-
│ │ │ ├── overview-screen.js
|
|
1615
|
-
│ │ │ ├── kanban-screen.js
|
|
1616
|
-
│ │ │ ├── quality-screen.js
|
|
1617
|
-
│ │ │ └── system-screen.js
|
|
1618
|
-
│ │ ├── components/ # 5 个组件
|
|
1619
|
-
│ │ │ ├── progress-bar.js
|
|
1620
|
-
│ │ │ ├── table.js
|
|
1621
|
-
│ │ │ ├── sparkline.js
|
|
1622
|
-
│ │ │ ├── status-light.js
|
|
1623
|
-
│ │ │ └── card.js
|
|
1624
|
-
│ │ └── overlays/ # 覆盖层
|
|
1625
|
-
│ │ ├── detail-overlay.js
|
|
1626
|
-
│ │ └── help-overlay.js
|
|
1627
|
-
│ │
|
|
1628
|
-
│ └── hooks/ # VM Hook 系统
|
|
1629
|
-
│ ├── vm-hooks.js
|
|
1630
|
-
│ └── handlers/
|
|
1631
|
-
│ ├── on-feature-update.js
|
|
1632
|
-
│ ├── on-phase-change.js
|
|
1633
|
-
│ └── on-quality-alert.js
|
|
823
|
+
│ ├── sdk-python/ # Python SDK (8 文件 / files)
|
|
824
|
+
│ ├── plugin/ # 插件系统 / Plugin System
|
|
825
|
+
│ ├── openclaw/ # OpenClaw 集成 / Integration
|
|
826
|
+
│ ├── cache/ # 三级缓存 / Three-Level Cache
|
|
827
|
+
│ ├── token/ # Token 预算 / Budget
|
|
828
|
+
│ ├── quality/ # 质量评分 / Quality Scoring
|
|
829
|
+
│ ├── iteration/ # 迭代优化 / Iteration
|
|
830
|
+
│ └── vm/ # ★ PDD Visual Manager (~38 文件 / files)
|
|
1634
831
|
│
|
|
1635
|
-
├── skills/
|
|
1636
|
-
│ ├── core/ # 12 个核心技能
|
|
1637
|
-
│ ├── expert/ # 11 个专家技能
|
|
1638
|
-
│ ├── entropy/ # 4 个熵减技能
|
|
1639
|
-
│ ├── openspec/ # 10 个 OpenSpec 技能
|
|
1640
|
-
│ └── pr/ # 7 个 PR 技能
|
|
832
|
+
├── skills/ # 技能文件 / Skill Files (41+ 个)
|
|
833
|
+
│ ├── core/ # 12 个核心技能 / Core Skills
|
|
834
|
+
│ ├── expert/ # 11 个专家技能 / Expert Skills
|
|
835
|
+
│ ├── entropy/ # 4 个熵减技能 / Entropy Skills
|
|
836
|
+
│ ├── openspec/ # 10 个 OpenSpec 技能 / OpenSpec Skills
|
|
837
|
+
│ └── pr/ # 7 个 PR 技能 / PR Skills
|
|
1641
838
|
│
|
|
1642
|
-
├── scripts/
|
|
1643
|
-
│ ├── linter/
|
|
1644
|
-
│
|
|
1645
|
-
│
|
|
1646
|
-
│
|
|
1647
|
-
│ ├──
|
|
1648
|
-
│
|
|
1649
|
-
│ ├── i18n-checker.js # 双语合规检查
|
|
1650
|
-
│ ├── token-analyzer.js # Token 分析
|
|
1651
|
-
│ └── windows-compat-check.js # Windows 兼容性检查
|
|
839
|
+
├── scripts/ # 工具脚本 / Tool Scripts
|
|
840
|
+
│ ├── linter/ # PRD Linter 工具链 / Toolchain
|
|
841
|
+
│ ├── cso-analyzer.js # CSO 触发准确率分析 / Trigger Accuracy
|
|
842
|
+
│ ├── eval-runner.js # Evals 测试运行器 / Test Runner
|
|
843
|
+
│ ├── i18n-checker.js # 双语合规检查 / Bilingual Compliance
|
|
844
|
+
│ ├── token-analyzer.js # Token 分析 / Analysis
|
|
845
|
+
│ └── windows-compat-check.js # Windows 兼容性检查 / Compatibility
|
|
1652
846
|
│
|
|
1653
|
-
├── docs/ # 项目文档
|
|
1654
|
-
│ ├── i18n-spec.md # i18n 规范
|
|
1655
|
-
│ ├── lessons.md # 经验教训
|
|
1656
|
-
│ ├── tasks.md # 任务跟踪
|
|
1657
|
-
│ ├── token-checklist.md # Token 检查清单
|
|
1658
|
-
│ └── vm-tasks.md # VM 任务清单
|
|
847
|
+
├── docs/ # 项目文档 / Documentation
|
|
848
|
+
│ ├── i18n-spec.md # i18n 规范 / Specification
|
|
849
|
+
│ ├── lessons.md # 经验教训 / Lessons Learned
|
|
850
|
+
│ ├── tasks.md # 任务跟踪 / Task Tracking
|
|
851
|
+
│ ├── token-checklist.md # Token 检查清单 / Checklist
|
|
852
|
+
│ └── vm-tasks.md # VM 任务清单 / VM Tasks
|
|
1659
853
|
│
|
|
1660
|
-
├── templates/
|
|
1661
|
-
├── config/
|
|
1662
|
-
│ ├── bug-patterns.yaml # Bug模式库 (14
|
|
1663
|
-
│ ├── prd-rules.yaml # PRD检测规则 (30
|
|
1664
|
-
│ ├── gate-config.yaml # 质量门控配置 (4
|
|
1665
|
-
│ ├── bpmn-rules.yaml # BPMN校验规则
|
|
854
|
+
├── templates/ # 项目模板 / Project Templates
|
|
855
|
+
├── config/ # 配置中心 / Configuration Center (Single Source of Truth)
|
|
856
|
+
│ ├── bug-patterns.yaml # Bug模式库 / Bug Patterns (14个模式)
|
|
857
|
+
│ ├── prd-rules.yaml # PRD检测规则 / PRD Rules (30条)
|
|
858
|
+
│ ├── gate-config.yaml # 质量门控配置 / Quality Gates (4级)
|
|
859
|
+
│ ├── bpmn-rules.yaml # BPMN校验规则 / BPMN Rules
|
|
1666
860
|
│ ├── checkstyle.xml # Java Checkstyle配置
|
|
1667
861
|
│ ├── eslint.config.js # ESLint配置
|
|
1668
862
|
│ ├── pmd.xml # PMD配置
|
|
1669
863
|
│ ├── ruff.toml # Python Ruff配置
|
|
1670
864
|
│ └── sqlfluff.cfg # SQL SQLFluff配置
|
|
1671
|
-
├── hooks/
|
|
1672
|
-
└── package.json
|
|
865
|
+
├── hooks/ # Hook 配置 / Hook Configuration
|
|
866
|
+
└── package.json # v3.1.2
|
|
1673
867
|
```
|
|
1674
868
|
|
|
1675
869
|
***
|
|
1676
870
|
|
|
1677
|
-
## 配置说明
|
|
1678
|
-
|
|
1679
|
-
### 全局配置文件
|
|
871
|
+
## 配置说明 / Configuration
|
|
1680
872
|
|
|
1681
|
-
|
|
873
|
+
### 全局配置文件 / Global Configuration
|
|
1682
874
|
|
|
1683
875
|
```bash
|
|
1684
|
-
# 查看当前配置
|
|
876
|
+
# 查看当前配置 / View current config
|
|
1685
877
|
pdd config --list
|
|
1686
878
|
|
|
1687
|
-
# 设置配置项
|
|
879
|
+
# 设置配置项 / Set config
|
|
1688
880
|
pdd config --set server.port=8080
|
|
1689
881
|
pdd config --set cache.l1.maxSize=200
|
|
1690
882
|
pdd config --set quality.threshold=B
|
|
1691
883
|
```
|
|
1692
884
|
|
|
1693
|
-
### 配置优先级
|
|
885
|
+
### 配置优先级 / Configuration Priority
|
|
1694
886
|
|
|
1695
887
|
```
|
|
1696
|
-
CLI 参数 > 环境变量 > .pddrc.local > .pddrc > defaults
|
|
888
|
+
CLI 参数 / CLI Args > 环境变量 / Env Vars > .pddrc.local > .pddrc > defaults
|
|
1697
889
|
```
|
|
1698
890
|
|
|
1699
|
-
### 关键配置项
|
|
1700
|
-
|
|
1701
|
-
| 分类
|
|
1702
|
-
| --------- |
|
|
1703
|
-
|
|
|
1704
|
-
|
|
|
1705
|
-
|
|
|
1706
|
-
|
|
|
1707
|
-
|
|
|
1708
|
-
|
|
|
1709
|
-
| **Token** | budget.total
|
|
1710
|
-
|
|
|
1711
|
-
|
|
|
1712
|
-
|
|
|
1713
|
-
|
|
|
1714
|
-
|
|
|
1715
|
-
|
|
|
1716
|
-
|
|
|
1717
|
-
| **★ VM**
|
|
1718
|
-
|
|
|
1719
|
-
|
|
|
1720
|
-
|
|
|
1721
|
-
|
|
|
1722
|
-
|
|
|
1723
|
-
| **★
|
|
1724
|
-
|
|
|
891
|
+
### 关键配置项 / Key Configurations
|
|
892
|
+
|
|
893
|
+
| 分类 / Category | 配置项 / Config | 默认值 / Default | 说明 / Description |
|
|
894
|
+
| --------- | ------------------------ | ---------------- | ----------------- |
|
|
895
|
+
| **服务器 / Server** | server.port | 3000 | API 端口 / API Port |
|
|
896
|
+
| | server.cors | false | CORS 跨域 / Cross-origin |
|
|
897
|
+
| | server.rateLimit | 100/min | 限流阈值 / Rate limit |
|
|
898
|
+
| **缓存 / Cache** | cache.l1.enabled | true | L1 缓存开关 / L1 Cache |
|
|
899
|
+
| | cache.l1.maxSize | 100 | L1 容量 / Capacity |
|
|
900
|
+
| | cache.l3.dir | ./cache | L3 磁盘目录 / Disk directory |
|
|
901
|
+
| **Token** | budget.total | 100000 | 总预算 / Total budget |
|
|
902
|
+
| | budget.warnAt | 0.80 | 警告阈值 / Warning threshold |
|
|
903
|
+
| | budget.blockAt | 0.95 | 阻断阈值 / Block threshold |
|
|
904
|
+
| **质量 / Quality** | quality.grade | C | 最低通过等级 / Min pass grade |
|
|
905
|
+
| | iteration.maxRounds | 5 | 最大迭代轮次 / Max iterations |
|
|
906
|
+
| | iteration.convergence | 0.05 | 收敛阈值 / Convergence threshold |
|
|
907
|
+
| **插件 / Plugins** | plugins.dir | ./plugins | 插件目录 / Plugins directory |
|
|
908
|
+
| | sandbox.enabled | true | 沙箱开关 / Sandbox enabled |
|
|
909
|
+
| **★ VM** | vm.port | 3001 | Dashboard 端口 / Dashboard port |
|
|
910
|
+
| | vm.refreshInterval | 30 | 刷新间隔(秒) / Refresh interval (s) |
|
|
911
|
+
| | vm.theme | light | 主题 / Theme light/dark |
|
|
912
|
+
| | vm.autoOpen | true | 自动打开浏览器 / Auto open browser |
|
|
913
|
+
| | vm.maxSSEConnections | 100 | 最大SSE连接数 / Max SSE connections |
|
|
914
|
+
| | vm.tuiRefreshInterval | 5 | TUI 刷新间隔(秒) / TUI refresh (s) |
|
|
915
|
+
| **★ 脚手架 / Scaffold** | scaffold.defaultTemplate | python-fullstack | 默认模板 / Default template |
|
|
916
|
+
| | scaffold.outputDir | ./output | 输出目录 / Output directory |
|
|
1725
917
|
|
|
1726
918
|
***
|
|
1727
919
|
|
|
1728
|
-
## 开发指南
|
|
920
|
+
## 开发指南 / Development Guide
|
|
1729
921
|
|
|
1730
|
-
### 贡献流程
|
|
922
|
+
### 贡献流程 / Contribution Process
|
|
1731
923
|
|
|
1732
|
-
1. Fork 本仓库
|
|
1733
|
-
2.
|
|
1734
|
-
3. 编写代码（遵循 ESM / JSDoc /
|
|
1735
|
-
4. 添加/更新 evals 测试
|
|
1736
|
-
5. 运行 `pdd i18n` 和 `pdd cso` 确保合规
|
|
1737
|
-
6. 提交 PR 并填写模板
|
|
924
|
+
1. Fork 本仓库 / Fork this repository
|
|
925
|
+
2. 创建特性分支 / Create feature branch: `git checkout -b feature/amazing`
|
|
926
|
+
3. 编写代码（遵循 ESM / JSDoc / 零依赖原则）/ Write code (follow ESM / JSDoc / zero-dependency principles)
|
|
927
|
+
4. 添加/更新 evals 测试 / Add/update evals tests
|
|
928
|
+
5. 运行 `pdd i18n` 和 `pdd cso` 确保合规 / Run `pdd i18n` and `pdd cso` for compliance
|
|
929
|
+
6. 提交 PR 并填写模板 / Submit PR with template
|
|
1738
930
|
|
|
1739
|
-
### 代码规范
|
|
931
|
+
### 代码规范 / Code Standards
|
|
1740
932
|
|
|
1741
|
-
-
|
|
1742
|
-
-
|
|
1743
|
-
-
|
|
1744
|
-
-
|
|
1745
|
-
- **i18n**: 新技能必须包含 🇨🇳/🇺🇸 双语章节
|
|
933
|
+
- **模块 / Modules**: ESM (`import`/`export`)
|
|
934
|
+
- **风格 / Style**: JSDoc 注释 + 中文注释 / JSDoc + Chinese comments
|
|
935
|
+
- **依赖 / Dependencies**: 仅 Node.js 内置模块（lib/ 下）/ Node.js built-in modules only
|
|
936
|
+
- **测试 / Tests**: evals 框架（`pdd eval -c your-category`）/ evals framework
|
|
937
|
+
- **i18n**: 新技能必须包含 🇨🇳/🇺🇸 双语章节 / New skills must include bilingual sections
|
|
1746
938
|
|
|
1747
|
-
### 技能开发模板
|
|
939
|
+
### 技能开发模板 / Skill Development Template
|
|
1748
940
|
|
|
1749
|
-
详见 [开发者指南](docs/developer-guide/developer-guide.md) 或参考 `example-plugins/hello-world/`。
|
|
941
|
+
详见 [开发者指南 / Developer Guide](docs/developer-guide/developer-guide.md) 或参考 `example-plugins/hello-world/`。
|
|
1750
942
|
|
|
1751
943
|
***
|
|
1752
944
|
|
|
1753
|
-
## 版本历史
|
|
945
|
+
## 版本历史 / Version History
|
|
1754
946
|
|
|
1755
|
-
| 版本
|
|
1756
|
-
| ---------- | ---------- |
|
|
1757
|
-
| **v3.1.2** | 2026-04-10 |
|
|
1758
|
-
| **v3.1.1** | 2026-04-08 | **Windows
|
|
1759
|
-
| **v3.1.0** | 2026-04-05 |
|
|
1760
|
-
| **v3.0.1** | 2026-04-07 | **PDD Visual Manager
|
|
1761
|
-
| **v3.0.0** | 2026-04-05 |
|
|
1762
|
-
| v2.x
|
|
1763
|
-
| v1.x
|
|
947
|
+
| 版本 / Version | 日期 / Date | 重要变更 / Major Changes |
|
|
948
|
+
| ---------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
949
|
+
| **v3.1.2** | 2026-04-10 | **技能生态大扩展 / Skill Ecosystem Expansion**: 新增 7 个专家技能 / 7 new expert skills, 新增 4 个熵减技能 / 4 entropy skills, PR技能扩展至7个 / PR skills expanded to 7, 核心技能增至12个 / Core skills increased to 12, 总计41+技能 / Total 41+ skills |
|
|
950
|
+
| **v3.1.1** | 2026-04-08 | **Windows兼容性+项目结构优化 / Windows Compatibility + Structure Optimization**: 添加 Windows 终端兼容支持 / Windows terminal support, 优化项目初始化流程 / Optimize init process |
|
|
951
|
+
| **v3.1.0** | 2026-04-05 | **智能能力+生态集成 / Intelligence + Ecosystem**: Bug模式库集中化 / Centralized bug patterns, PRD Linter扩展 / Extended PRD linter, 4级门控引擎 / 4-level gate engine, OpenAPI契约同步 / OpenAPI sync, PRD感知动态模板 / PRD-aware templates, MVP分层交付策略 / MVP delivery, expert-ruoyi+expert-activiti专家技能 / Expert skills |
|
|
952
|
+
| **v3.0.1** | 2026-04-07 | **PDD Visual Manager 发布 / PDD Visual Manager Release**: Web Dashboard + Terminal TUI 双形态可视化监控 / Dual-mode visualization, 11个REST API端点 / 11 REST endpoints, SSE实时推送 / SSE push, Canvas图表引擎 / Canvas charts, ANSI TUI组件库 / ANSI TUI components |
|
|
953
|
+
| **v3.0.0** | 2026-04-05 | **正式发布版 / Official Release**: 6大Phase全部完成 / 6 Phases completed + 插件系统 / Plugin system + OpenClaw + gRPC + Python SDK |
|
|
954
|
+
| v2.x | 2026-03 | 内部迭代版本 / Internal iteration: MCP/SDK/缓存/Token/质量/迭代 / Cache/Token/Quality/Iteration |
|
|
955
|
+
| v1.x | 2025-12 | 初始版本 / Initial version: 基础设施 + 核心技能 + Linter / Infrastructure + Core skills + Linter |
|
|
1764
956
|
|
|
1765
957
|
***
|
|
1766
958
|
|
|
1767
|
-
## 致谢
|
|
959
|
+
## 致谢 / Acknowledgments
|
|
1768
960
|
|
|
1769
|
-
- **Claude / Anthropic** — AI 原生开发的理想伙伴
|
|
1770
|
-
- **Node.js
|
|
1771
|
-
-
|
|
961
|
+
- **Claude / Anthropic** — AI 原生开发的理想伙伴 / Ideal partner for AI-native development
|
|
962
|
+
- **Node.js 社区 / Node.js Community** — 提供卓越的内置模块 / Providing excellent built-in modules
|
|
963
|
+
- **开源社区 / Open Source Community** — 所有灵感和最佳实践的来源 / Source of all inspiration and best practices
|
|
1772
964
|
|
|
1773
965
|
***
|
|
1774
966
|
|
|
1775
|
-
## 许可证
|
|
967
|
+
## 许可证 / License
|
|
1776
968
|
|
|
1777
969
|
[MIT](LICENSE) © PDD Team 2025-2026
|
|
1778
970
|
|
|
@@ -1780,6 +972,8 @@ CLI 参数 > 环境变量 > .pddrc.local > .pddrc > defaults
|
|
|
1780
972
|
|
|
1781
973
|
<p align="center">
|
|
1782
974
|
<b>PDD-Skills v3.1.2 — 让 AI 成为你的全职结对编程伙伴 🤖</b>
|
|
975
|
+
<br>
|
|
976
|
+
<b>Let AI be your full-time pair programming partner 🤖</b>
|
|
1783
977
|
</p>
|
|
1784
978
|
|
|
1785
979
|
<p align="center">
|