pdd-skills 3.1.2 → 3.1.4
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 +87 -62
- package/package.json +1 -1
- package/scaffolds/python-fullstack/frontend/src/main.ts +1 -1
- package/skills/core/pdd-vm/SKILL.md +111 -0
- package/skills/core/pdd-vm/_meta.json +1 -0
- package/skills/core/traffic-accident-assessor/_meta.json +1 -0
- package/skills/expert/expert-bug-fixer/SKILL.md +241 -241
- package/skills/expert/expert-bug-fixer/_meta.json +1 -0
- 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/expert-ruoyi-permission/_meta.json +1 -0
- package/skills/expert/expert-springcloud/_meta.json +1 -0
- package/skills/expert/expert-vue3/_meta.json +1 -0
- package/skills/pr/pdd-multi-review/evals/default-evals.json +1 -0
- package/skills/pr/pdd-pr-batch/evals/default-evals.json +1 -0
- package/skills/pr/pdd-pr-create/evals/default-evals.json +1 -0
- package/skills/pr/pdd-pr-merge/evals/default-evals.json +1 -0
- package/skills/pr/pdd-pr-review/evals/default-evals.json +1 -0
- package/skills/pr/pdd-task-manager/evals/default-evals.json +1 -0
- package/skills/pr/pdd-template-engine/evals/default-evals.json +1 -0
package/README.md
CHANGED
|
@@ -1,14 +1,15 @@
|
|
|
1
1
|
# PDD-Skills v3.0
|
|
2
2
|
|
|
3
|
-
[](https://github.com/pdd-skills/pdd-skills)
|
|
4
4
|
[](https://nodejs.org/)
|
|
5
5
|
[](LICENSE)
|
|
6
6
|
[](config/bug-patterns.yaml)
|
|
7
7
|
[](config/prd-rules.yaml)
|
|
8
|
+
[](skills/)
|
|
8
9
|
|
|
9
10
|
> **PRD 驱动的 AI 原生软件开发工作流框架**
|
|
10
11
|
>
|
|
11
|
-
> 从需求文档到代码交付的全链路自动化平台 — **7 大 Phase
|
|
12
|
+
> 从需求文档到代码交付的全链路自动化平台 — **7 大 Phase**、**41+ 技能**、**14 个 Bug 模式**、**30 条 PRD 规则**、**4 级质量门控**
|
|
12
13
|
|
|
13
14
|
***
|
|
14
15
|
|
|
@@ -230,14 +231,15 @@ scaffolds/python-fullstack/
|
|
|
230
231
|
|
|
231
232
|
| 指标 | 数值 |
|
|
232
233
|
| ----------- | --------------------------------------------- |
|
|
233
|
-
| **版本** | v3.1.
|
|
234
|
-
| **核心技能** |
|
|
235
|
-
| **专家技能** |
|
|
236
|
-
|
|
|
234
|
+
| **版本** | v3.1.2 |
|
|
235
|
+
| **核心技能** | 12 个(全双语 🇨🇳🇺🇸) |
|
|
236
|
+
| **专家技能** | 12 个(安全/性能/MySQL/若依/若依权限/Activiti/Vue3/微服务/Bug修复/测试/架构) |
|
|
237
|
+
| **熵减技能** | 4 个(审计 + 架构约束 + 代码质量 + 自动重构) |
|
|
238
|
+
| **OpenSpec技能**| 10 个(变更管理全生命周期) |
|
|
239
|
+
| **PR技能** | 7 个(模板引擎 + 多轮审查 + PR创建/审查/合并/批量/任务管理) |
|
|
237
240
|
| **Bug模式库** | 14 个(7通用 + 7若依专用),集中式管理 `config/bug-patterns.yaml` |
|
|
238
241
|
| **PRD规则** | 30 条(6大类),集中式管理 `config/prd-rules.yaml` |
|
|
239
242
|
| **质量门控** | 4级(Blocker/Critical/Warning/Info)+ 0-100评分 |
|
|
240
|
-
| **脚手架模板** | 2 个(Python Fullstack + 若依RuoYi) |
|
|
241
243
|
| **协议支持** | RESTful + MCP + gRPC + SSE |
|
|
242
244
|
| **SDK 语言** | JavaScript + Python |
|
|
243
245
|
|
|
@@ -399,7 +401,7 @@ pdd config --get key # 读取配置项
|
|
|
399
401
|
|
|
400
402
|
### Phase 2: 核心能力增强
|
|
401
403
|
|
|
402
|
-
|
|
404
|
+
12 个核心技能 + 五大行为塑造机制。
|
|
403
405
|
|
|
404
406
|
#### 核心技能列表
|
|
405
407
|
|
|
@@ -416,6 +418,7 @@ pdd config --get key # 读取配置项
|
|
|
416
418
|
| `pdd-doc-gardener` | 文档清理与维护 | ✅ |
|
|
417
419
|
| `pdd-entropy-reduction` | 技术债务治理 | ✅ |
|
|
418
420
|
| `official-doc-writer` | 党政机关公文生成 | ✅ |
|
|
421
|
+
| `pdd-vm` | PDD Visual Manager 可视化监控 | ✅ |
|
|
419
422
|
|
|
420
423
|
#### 行为塑造三层防御
|
|
421
424
|
|
|
@@ -444,9 +447,39 @@ pdd config --get key # 读取配置项
|
|
|
444
447
|
| ---------------------- | --------------------------------------- | -------------------------------------- |
|
|
445
448
|
| **expert-security** | SQL注入 / XSS / CSRF / 命令注入 / 路径遍历 / SSRF | OWASP Top 10 2021 完整覆盖,8 条安全铁律 |
|
|
446
449
|
| **expert-performance** | CPU / 内存 / I/O / 网络 / 锁竞争诊断 | HikariCP / Redis多级缓存 / G1 GC调优 / P99指标 |
|
|
450
|
+
| **expert-mysql** | SQL优化 / 索引设计 / 表结构分析 / 慢查询诊断 | MySQL官方文档参考,执行计划分析,索引优化建议 |
|
|
447
451
|
| **expert-ruoyi** | 若依框架全流程开发 / 代码生成 / 权限配置 / 菜单管理 | 7个若依Bug模式(PATTERN-R001~R007) + Spec模板参考 |
|
|
452
|
+
| **expert-ruoyi-permission** | 若依框架权限配置 / 权限校验失败诊断 / 菜单按钮权限 | 四端一致原则 + @PreAuthorize + v-hasPermi |
|
|
448
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 标准,项目初始化,技术栈选择 |
|
|
449
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
|
+
|
|
450
483
|
### Phase 4: 平台化建设
|
|
451
484
|
|
|
452
485
|
将核心能力暴露为标准化接口,支持远程调用和多语言接入。
|
|
@@ -1023,18 +1056,35 @@ skills/
|
|
|
1023
1056
|
│ ├── pdd-entropy-reduction/
|
|
1024
1057
|
│ └── official-doc-writer/
|
|
1025
1058
|
│
|
|
1026
|
-
├── expert/ # 专家技能 (
|
|
1059
|
+
├── expert/ # 专家技能 (12个,按需加载)
|
|
1027
1060
|
│ ├── expert-security/ # 安全审计专家
|
|
1028
1061
|
│ ├── expert-performance/ # 性能优化专家
|
|
1062
|
+
│ ├── expert-mysql/ # MySQL数据库专家
|
|
1029
1063
|
│ ├── expert-ruoyi/ # 若依框架专家 (含Bug模式库R001~R007)
|
|
1030
|
-
│
|
|
1064
|
+
│ ├── expert-ruoyi-permission/ # 若依权限配置专家
|
|
1065
|
+
│ ├── expert-activiti/ # Activiti工作流专家
|
|
1066
|
+
│ ├── expert-vue3/ # Vue3前端专家
|
|
1067
|
+
│ ├── expert-springcloud/ # SpringCloud微服务专家
|
|
1068
|
+
│ ├── expert-bug-fixer/ # Bug修复专家
|
|
1069
|
+
│ ├── expert-testcases/ # 测试用例专家
|
|
1070
|
+
│ ├── software-architect/ # 软件架构师
|
|
1071
|
+
│ ├── software-engineer/ # 软件工程师
|
|
1072
|
+
│ └── system-architect/ # 系统架构师
|
|
1031
1073
|
│
|
|
1032
|
-
├──
|
|
1074
|
+
├── entropy/ # 熵减治理技能 (4个)
|
|
1075
|
+
│ ├── expert-entropy-auditor/ # 技术债务审计
|
|
1076
|
+
│ ├── expert-arch-enforcer/ # 架构约束强制
|
|
1077
|
+
│ ├── expert-code-quality/ # 代码质量专家
|
|
1078
|
+
│ └── expert-auto-refactor/ # 自动重构专家
|
|
1079
|
+
│
|
|
1080
|
+
├── pr/ # PR与交付技能 (7个)
|
|
1033
1081
|
│ ├── pdd-template-engine/ # PRD感知动态模板引擎
|
|
1034
|
-
│ ├── pdd-multi-review/ #
|
|
1082
|
+
│ ├── pdd-multi-review/ # 多轮代码审查
|
|
1035
1083
|
│ ├── pdd-pr-create/ # PR创建
|
|
1036
1084
|
│ ├── pdd-pr-review/ # PR审查
|
|
1037
|
-
│
|
|
1085
|
+
│ ├── pdd-pr-merge/ # PR合并
|
|
1086
|
+
│ ├── pdd-pr-batch/ # 批量PR处理
|
|
1087
|
+
│ └── pdd-task-manager/ # 任务管理
|
|
1038
1088
|
│
|
|
1039
1089
|
├── openspec/ # OpenSpec 协作技能
|
|
1040
1090
|
│ ├── openspec-explore/
|
|
@@ -1582,56 +1632,30 @@ pdd-skills-v3/
|
|
|
1582
1632
|
│ ├── on-phase-change.js
|
|
1583
1633
|
│ └── on-quality-alert.js
|
|
1584
1634
|
│
|
|
1585
|
-
├──
|
|
1586
|
-
│
|
|
1587
|
-
│
|
|
1588
|
-
│
|
|
1589
|
-
│
|
|
1590
|
-
│
|
|
1591
|
-
│ │ ├── database-design.md
|
|
1592
|
-
│ │ ├── api-design.md
|
|
1593
|
-
│ │ └── deployment-guide.md
|
|
1594
|
-
│ ├── backend/ # 后端代码 (FastAPI + SQLAlchemy)
|
|
1595
|
-
│ │ ├── app/core/ # 核心模块 (权限/OAuth/工作流)
|
|
1596
|
-
│ │ ├── app/api/ # API 路由层
|
|
1597
|
-
│ │ ├── app/models/ # 数据模型
|
|
1598
|
-
│ │ ├── app/schemas/ # 请求/响应模型
|
|
1599
|
-
│ │ ├── app/services/ # 业务逻辑层
|
|
1600
|
-
│ │ ├── alembic/ # 数据库迁移
|
|
1601
|
-
│ │ └── tests/ # 单元 & 集成测试
|
|
1602
|
-
│ ├── frontend/ # 前端代码 (Vue3 + Vite + TS)
|
|
1603
|
-
│ │ ├── src/views/ # 页面组件 (响应式布局)
|
|
1604
|
-
│ │ ├── src/components/ # UI 组件库
|
|
1605
|
-
│ │ ├── src/stores/ # Pinia 状态管理
|
|
1606
|
-
│ │ ├── src/api/ # API 请求封装
|
|
1607
|
-
│ │ └── tailwind.config.js # 6档断点配置
|
|
1608
|
-
│ ├── docker-compose.yml # 一键部署编排
|
|
1609
|
-
│ └── .github/workflows/ # CI 流水线
|
|
1610
|
-
│
|
|
1611
|
-
├── skills/ # 技能文件
|
|
1612
|
-
│ ├── core/ # 11 个核心技能
|
|
1613
|
-
│ ├── expert/ # 2 个专家技能
|
|
1614
|
-
│ └── openspec/ # 10 个 OpenSpec 技能
|
|
1635
|
+
├── skills/ # 技能文件 (41+ 个)
|
|
1636
|
+
│ ├── core/ # 12 个核心技能
|
|
1637
|
+
│ ├── expert/ # 11 个专家技能
|
|
1638
|
+
│ ├── entropy/ # 4 个熵减技能
|
|
1639
|
+
│ ├── openspec/ # 10 个 OpenSpec 技能
|
|
1640
|
+
│ └── pr/ # 7 个 PR 技能
|
|
1615
1641
|
│
|
|
1616
1642
|
├── scripts/ # 工具脚本
|
|
1617
1643
|
│ ├── linter/ # PRD Linter 工具链
|
|
1618
1644
|
│ │ ├── prd-linter.js # PRD Linter 引擎
|
|
1619
|
-
│ │ ├── prd-rules.yaml # (符号链接→config/)
|
|
1620
|
-
│ │ ├── gate-engine.js # 4级门控引擎 (读取config/gate-config.yaml)
|
|
1621
1645
|
│ │ ├── report-generator.js# 报告生成器
|
|
1622
|
-
│ │ └── run-linters.js # Linter运行器
|
|
1623
|
-
│ ├──
|
|
1624
|
-
│ ├──
|
|
1625
|
-
│ ├── i18n-checker.js
|
|
1626
|
-
│
|
|
1646
|
+
│ │ └── run-linters.js # Linter运行器
|
|
1647
|
+
│ ├── cso-analyzer.js # CSO 触发准确率分析
|
|
1648
|
+
│ ├── eval-runner.js # Evals 测试运行器
|
|
1649
|
+
│ ├── i18n-checker.js # 双语合规检查
|
|
1650
|
+
│ ├── token-analyzer.js # Token 分析
|
|
1651
|
+
│ └── windows-compat-check.js # Windows 兼容性检查
|
|
1627
1652
|
│
|
|
1628
|
-
├── docs/ #
|
|
1629
|
-
│ ├──
|
|
1630
|
-
│ ├──
|
|
1631
|
-
│ ├──
|
|
1632
|
-
│ ├──
|
|
1633
|
-
│
|
|
1634
|
-
│ └── tasks.md # 任务跟踪 (153/100%)
|
|
1653
|
+
├── docs/ # 项目文档
|
|
1654
|
+
│ ├── i18n-spec.md # i18n 规范
|
|
1655
|
+
│ ├── lessons.md # 经验教训
|
|
1656
|
+
│ ├── tasks.md # 任务跟踪
|
|
1657
|
+
│ ├── token-checklist.md # Token 检查清单
|
|
1658
|
+
│ └── vm-tasks.md # VM 任务清单
|
|
1635
1659
|
│
|
|
1636
1660
|
├── templates/ # 项目模板
|
|
1637
1661
|
├── config/ # 配置中心 (Single Source of Truth)
|
|
@@ -1645,7 +1669,7 @@ pdd-skills-v3/
|
|
|
1645
1669
|
│ ├── ruff.toml # Python Ruff配置
|
|
1646
1670
|
│ └── sqlfluff.cfg # SQL SQLFluff配置
|
|
1647
1671
|
├── hooks/ # Hook 配置
|
|
1648
|
-
└── package.json # v3.1.
|
|
1672
|
+
└── package.json # v3.1.2
|
|
1649
1673
|
```
|
|
1650
1674
|
|
|
1651
1675
|
***
|
|
@@ -1730,8 +1754,9 @@ CLI 参数 > 环境变量 > .pddrc.local > .pddrc > defaults
|
|
|
1730
1754
|
|
|
1731
1755
|
| 版本 | 日期 | 重要变更 |
|
|
1732
1756
|
| ---------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
1733
|
-
| **v3.1.
|
|
1734
|
-
| **v3.
|
|
1757
|
+
| **v3.1.2** | 2026-04-10 | **技能生态大扩展**: 新增 7 个专家技能(expert-mysql/expert-vue3/expert-springcloud/expert-bug-fixer/expert-testcases/software-architect/software-engineer/system-architect), 新增 4 个熵减技能(entropy-auditor/arch-enforcer/code-quality/auto-refactor), PR技能扩展至7个(新增pdd-pr-batch/pdd-task-manager), 核心技能增至12个(pdd-vm), 总计41+技能 |
|
|
1758
|
+
| **v3.1.1** | 2026-04-08 | **Windows兼容性+项目结构优化**: 添加 Windows 终端兼容支持, 优化项目初始化流程, 更新目录结构规范, 完善 .npmignore 配置 |
|
|
1759
|
+
| **v3.1.0** | 2026-04-05 | **智能能力+生态集成**: Bug模式库集中化(14模式), PRD Linter扩展(30规则6大类), 4级门控引擎(Blocker/Critical/Warning/Info), OpenAPI契约同步, PRD感知动态模板, MVP分层交付策略, 上下文注入+微验证, expert-ruoyi+expert-activiti专家技能, 若依RuoYi脚手架支持, 种子数据分层设计 |
|
|
1735
1760
|
| **v3.0.1** | 2026-04-07 | **PDD Visual Manager 发布**: Web Dashboard + Terminal TUI 双形态可视化监控, 11个REST API端点, SSE实时推送, Canvas图表引擎, ANSI TUI组件库 |
|
|
1736
1761
|
| **v3.0.0** | 2026-04-05 | **正式发布版**: 6大Phase全部完成 + 插件系统 + OpenClaw + gRPC + Python SDK + 暂缓清零 |
|
|
1737
1762
|
| v2.x | 2026-03 | 内部迭代版本: MCP/SDK/缓存/Token/质量/迭代 |
|
|
@@ -1754,9 +1779,9 @@ CLI 参数 > 环境变量 > .pddrc.local > .pddrc > defaults
|
|
|
1754
1779
|
***
|
|
1755
1780
|
|
|
1756
1781
|
<p align="center">
|
|
1757
|
-
<b>PDD-Skills v3.1 — 让 AI 成为你的全职结对编程伙伴 🤖</b>
|
|
1782
|
+
<b>PDD-Skills v3.1.2 — 让 AI 成为你的全职结对编程伙伴 🤖</b>
|
|
1758
1783
|
</p>
|
|
1759
1784
|
|
|
1760
1785
|
<p align="center">
|
|
1761
|
-
<sub>14 Bug Patterns ✅ · 30 PRD Rules ✅ · 4-Level Gate ✅ ·
|
|
1786
|
+
<sub>41+ Skills ✅ · 14 Bug Patterns ✅ · 30 PRD Rules ✅ · 4-Level Gate ✅ · 4 Entropy Skills ✅</sub>
|
|
1762
1787
|
</p>
|
package/package.json
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
{"name": "pdd-skills",
|
|
2
|
-
"version": "3.1.
|
|
2
|
+
"version": "3.1.4",
|
|
3
3
|
"description": "PDD Skills - PRD驱动开发框架 | 41+技能: 核心(12)/专家(8)/熵减(4)/OpenSpec(10)/PR管理(7) | AI原生开发工作流 | Bug模式库(14) | PRD规则(30) | 4级门控引擎", "type": "module", "main": "index.js", "bin": {"pdd": "./bin/pdd.js", "pdd-skills": "./bin/pdd.js"}, "files": ["bin/", "lib/", "skills/", "templates/", "scaffolds/", "scripts/", "config/", "hooks/", "docs/", "index.js"], "scripts": {"start": "node bin/pdd.js", "list": "node bin/pdd.js list", "lint": "node bin/pdd.js linter --type code prd sql activiti", "generate": "node bin/pdd.js generate", "verify": "node bin/pdd.js verify", "report": "node bin/pdd.js report", "config": "node bin/pdd.js config --list", "api": "node bin/pdd.js api", "api:dev": "node bin/pdd.js api -p 3000 --cors", "init": "node bin/pdd.js init", "update": "node bin/pdd.js update", "cso": "node bin/pdd.js cso", "eval": "node bin/pdd.js eval", "token": "node bin/pdd.js token", "i18n": "node bin/pdd.js i18n"}, "keywords": ["pdd", "prd-driven-development", "ai", "claude", "skills", "tdd", "code-generation", "linter", "api-server", "cli"], "author": "PDD Team", "license": "MIT", "engines": {"node": ">=18.0.0"}, "dependencies": {"commander": "^12.0.0", "chalk": "^5.3.0", "fs-extra": "^11.2.0", "yaml": "^2.3.0"}}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pdd-vm
|
|
3
|
+
description: "PDD Visual Manager 可视化监控技能。当用户需要查看项目状态、启动Dashboard、使用TUI终端界面、监控流水线进度、查看质量评分、导出项目数据时自动触发。支持中文触发:可视化监控、Dashboard、看板、TUI、项目状态、流水线、质量评分、pdd vm。"
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: PDD-Skills v3.0+ 项目
|
|
6
|
+
metadata:
|
|
7
|
+
author: "PDD Team"
|
|
8
|
+
version: "1.0"
|
|
9
|
+
triggers:
|
|
10
|
+
- "/vm" | "/dashboard" | "/tui"
|
|
11
|
+
- "可视化监控" | "Dashboard" | "看板" | "TUI"
|
|
12
|
+
- "项目状态" | "流水线" | "质量评分" | "pdd vm"
|
|
13
|
+
- "Web Dashboard" | "Terminal TUI" | "SSE"
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# PDD Visual Manager / PDD 可视化监控
|
|
17
|
+
|
|
18
|
+
## 1. 技能概述 / Overview
|
|
19
|
+
|
|
20
|
+
### 🇨🇳 定位
|
|
21
|
+
|
|
22
|
+
PDD Visual Manager (PDD-VM) 提供双形态可视化监控能力,用于监控使用 PDD 方法开发的业务项目的运行状态。
|
|
23
|
+
|
|
24
|
+
**双形态架构**:
|
|
25
|
+
- **Web Dashboard**: 基于 HTML/CSS/JS 的零依赖 SPA,通过浏览器实时查看项目状态
|
|
26
|
+
- **Terminal TUI**: 基于 Node.js ANSI 的终端 UI,适合 SSH 远程场景
|
|
27
|
+
|
|
28
|
+
**核心能力**:
|
|
29
|
+
- Pipeline 流水线视图 — 展示 PDD 开发流水线各阶段状态和进度
|
|
30
|
+
- Kanban 看板视图 — 以看板形式展示功能点的开发状态
|
|
31
|
+
- Quality 质量视图 — 多维度展示代码质量指标(五维评分雷达图)
|
|
32
|
+
- System 系统视图 — 监控系统运行状态和资源使用
|
|
33
|
+
- SSE 实时推送 — Server-Sent Events 实时数据更新
|
|
34
|
+
- 数据导出 — 支持 CSV/JSON 格式导出
|
|
35
|
+
|
|
36
|
+
### 🇺🇸 Positioning
|
|
37
|
+
|
|
38
|
+
PDD Visual Manager provides dual-form visualization monitoring for PDD-driven business projects, offering both Web Dashboard and Terminal TUI interfaces.
|
|
39
|
+
|
|
40
|
+
## 2. CLI 命令 / CLI Commands
|
|
41
|
+
|
|
42
|
+
### Web Dashboard
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
pdd dashboard # 启动 Dashboard (默认 http://localhost:3001)
|
|
46
|
+
pdd dashboard -p 8080 # 自定义端口
|
|
47
|
+
pdd dashboard --no-open # 不自动打开浏览器
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Terminal TUI
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
pdd tui # 启动 TUI
|
|
54
|
+
pdd tui --refresh 3 # 自定义刷新间隔(秒)
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### VM 数据查询
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
pdd vm status # 项目状态摘要 (JSON 格式)
|
|
61
|
+
pdd vm features # 功能点列表 (含状态)
|
|
62
|
+
pdd vm features --status done # 筛选已完成功能点
|
|
63
|
+
pdd vm export --format csv # 导出为 CSV
|
|
64
|
+
pdd vm export --format json # 导出为 JSON
|
|
65
|
+
pdd vm export -o report.csv # 导出到指定文件
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## 3. TUI 快捷键 / TUI Keyboard Shortcuts
|
|
69
|
+
|
|
70
|
+
| 按键 | 功能 | 适用场景 |
|
|
71
|
+
|------|------|----------|
|
|
72
|
+
| `Tab` | 切换到下一个屏幕 | 所有屏幕 |
|
|
73
|
+
| `q` / `Ctrl+C` | 退出 TUI | 所有屏幕 |
|
|
74
|
+
| `r` / `F5` | 强制刷新当前屏幕 | 所有屏幕 |
|
|
75
|
+
| `p` | 暂停/恢复自动刷新 | 所有屏幕 |
|
|
76
|
+
| `j` / `↓` | 向下选择 | 列表/表格 |
|
|
77
|
+
| `k` / `↑` | 向上选择 | 列表/表格 |
|
|
78
|
+
| `Enter` | 查看选中项详情 | 列表/表格 |
|
|
79
|
+
| `Esc` | 返回上一级 | 详情 overlay |
|
|
80
|
+
| `?` | 显示帮助信息 | 所有屏幕 |
|
|
81
|
+
| `1`-`4` | 直接跳转到指定屏幕 | 所有屏幕 |
|
|
82
|
+
|
|
83
|
+
## 4. 数据模型 / Data Model
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
Project (业务项目)
|
|
87
|
+
├── metadata (元数据: name, version, createdAt, updatedAt)
|
|
88
|
+
├── features (功能点列表: id, name, status, priority, metrics)
|
|
89
|
+
├── pipeline (流水线状态: phase, progress, stages[])
|
|
90
|
+
├── quality (质量指标: overallScore, dimensions, rulesViolated[])
|
|
91
|
+
└── system (系统状态: apiStatus, cacheHitRate, tokenUsage, errors[])
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
功能点状态流转: `backlog → analysis → design → implement → review → verify → done`
|
|
95
|
+
|
|
96
|
+
## 5. 配置项 / Configuration
|
|
97
|
+
|
|
98
|
+
| 配置项 | 默认值 | 说明 |
|
|
99
|
+
|--------|--------|------|
|
|
100
|
+
| vm.port | 3001 | Dashboard 端口 |
|
|
101
|
+
| vm.refreshInterval | 30 | Dashboard 刷新间隔(秒) |
|
|
102
|
+
| vm.theme | light | 主题 light/dark |
|
|
103
|
+
| vm.autoOpen | true | 自动打开浏览器 |
|
|
104
|
+
| vm.maxSSEConnections | 100 | 最大SSE连接数 |
|
|
105
|
+
| vm.tuiRefreshInterval | 5 | TUI 刷新间隔(秒) |
|
|
106
|
+
|
|
107
|
+
## 6. 重要说明 / Important Notes
|
|
108
|
+
|
|
109
|
+
> PDD Visual Manager 用于可视化监控使用 PDD 方法开发的**业务项目**的运行状态,而非管理 PDD-Skills 自身的开发任务。
|
|
110
|
+
|
|
111
|
+
Web Dashboard 和 Terminal TUI 共享同一数据模型和 API 层,可根据使用场景自由切换。
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"name": "pdd-vm", "version": "1.0.0", "category": "core", "description": "PDD Visual Manager skill providing dual-form visualization monitoring for PDD-driven projects. Invoke when users need Web Dashboard, Terminal TUI, project status monitoring, feature pipeline tracking, quality metrics visualization, or SSE real-time push. 支持中文触发:可视化监控、Dashboard、看板、TUI、项目状态、流水线、质量评分。", "triggers": ["可视化监控", "Dashboard", "看板", "TUI", "项目状态", "流水线", "质量评分", "pdd vm"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"name": "traffic-accident-assessor", "version": "1.0.0", "category": "core", "description": "Traffic accident liability assessment skill. Invoke when users need traffic accident responsibility analysis, scene photo evaluation, traffic law consultation, liability determination, or legal basis lookup. 支持中文触发:交通事故、车祸、责任判定、交通法规、事故定责、责任划分、事故评估。", "triggers": ["交通事故", "车祸", "责任判定", "交通法规", "事故定责", "责任划分", "事故评估"]}
|