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 CHANGED
@@ -1,14 +1,15 @@
1
1
  # PDD-Skills v3.0
2
2
 
3
- [![Version](https://img.shields.io/badge/version-3.1.0-blue.svg null)](https://github.com/pdd-skills/pdd-skills)
3
+ [![Version](https://img.shields.io/badge/version-3.1.2-blue.svg null)](https://github.com/pdd-skills/pdd-skills)
4
4
  [![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg null)](https://nodejs.org/)
5
5
  [![License](https://img.shields.io/badge/license-MIT-orange.svg null)](LICENSE)
6
6
  [![Patterns](https://img.shields.io/badge/bug_patterns-14-purple.svg null)](config/bug-patterns.yaml)
7
7
  [![Gate](https://img.shields.io/badge/gate_rules-30-critical.svg null)](config/prd-rules.yaml)
8
+ [![Skills](https://img.shields.io/badge/skills-41+-brightgreen.svg null)](skills/)
8
9
 
9
10
  > **PRD 驱动的 AI 原生软件开发工作流框架**
10
11
  >
11
- > 从需求文档到代码交付的全链路自动化平台 — **7 大 Phase**、**双脚手架**、**14 个 Bug 模式**、**30 条 PRD 规则**、**4 级质量门控**
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.0 |
234
- | **核心技能** | 11 个(全双语 🇨🇳🇺🇸) |
235
- | **专家技能** | 4 个(安全 + 性能 + 若依 + Activiti) |
236
- | **PR技能** | 5 个(模板引擎 + 多轮审查 + PR创建/审查/合并) |
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
- 11 个核心技能 + 五大行为塑造机制。
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
- └── expert-activiti/ # Activiti工作流专家
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
- ├── pr/ # PR与交付技能
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
- └── pdd-pr-merge/ # PR合并
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
- ├── scaffolds/ # 脚手架模板系统 (v3.0.1+ 新增)
1586
- └── python-fullstack/ # Python 全栈模板 (FastAPI + Vue3)
1587
- ├── template_config.yaml # 模板元数据 & Hooks & 变量配置
1588
- ├── README.md # 模板使用指南
1589
- ├── docs/ # 4份架构设计文档
1590
- ├── architecture-design.md
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运行器 (集成Gate Engine)
1623
- │ ├── openapi-contract-sync.js # OpenAPI契约同步工具
1624
- │ ├── skill-linter.py # Skill 文件检查器
1625
- │ ├── i18n-checker.js # 双语合规检查
1626
- └── token-analyzer.js # Token 分析
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/ # 社区文档 (~10,700 行)
1629
- │ ├── user-guide/
1630
- │ ├── developer-guide/
1631
- │ ├── api-reference/
1632
- │ ├── operations/
1633
- ├── plugin-market/
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.0
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.0** | 2026-04-15 | **智能能力+生态集成**: Bug模式库集中化(14模式), PRD Linter扩展(30规则6大类), 4级门控引擎(Blocker/Critical/Warning/Info), OpenAPI契约同步, PRD感知动态模板, MVP分层交付策略, 上下文注入+微验证, expert-ruoyi+expert-activiti专家技能, 若依RuoYi脚手架支持, 种子数据分层设计 |
1734
- | **v3.0.2** | 2026-04-12 | **脚手架系统发布**: python-fullstack 全栈模板(FastAPI+Vue3), 数据权限引擎, OAuth2六平台认证, 工作流状态机引擎, 响应式前端, 4份架构设计文档, Docker一键部署, CI流水线 |
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 ✅ · Dual Scaffold ✅</sub>
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",
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"}}
@@ -10,4 +10,4 @@ const app = createApp(App)
10
10
 
11
11
  app.use(createPinia())
12
12
  app.use(router)
13
- app.mount('#app')
13
+ app.mount('#app')
@@ -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": ["交通事故", "车祸", "责任判定", "交通法规", "事故定责", "责任划分", "事故评估"]}