pdd-skills 3.0.0

package/scripts/vm-test.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+/**
+ * PDD-VM 集成测试脚本
+ * 测试 Dashboard 和 TUI 的基本启动和数据流
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+let passed = 0;
+let failed = 0;
+
+function test(name, fn) {
+  try {
+    fn();
+    console.log(`  ✅ ${name}`);
+    passed++;
+  } catch (e) {
+    console.log(`  ❌ ${name}: ${e.message}`);
+    failed++;
+  }
+}
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message || 'Assertion failed');
+}
+
+// 颜色支持
+let chalk;
+try { chalk = (await import('chalk')).default; } catch { chalk = { green:(s)=>s, red:(s)=>s, cyan:(s=>s), bold:(s)=>s }; }
+
+console.log(chalk.bold.cyan('\n🧪 PDD-VM 集成测试\n'));
+
+// Test 1: 模块导入测试
+console.log(chalk.bold('1. 模块导入测试'));
+test('models.js 可导入', async () => {
+  const m = await import('../lib/vm/models.js');
+  assert(m.StageEnum !== undefined, 'StageEnum 存在');
+  assert(m.Feature !== undefined, 'Feature 存在');
+  assert(m.ProjectSummary !== undefined, 'ProjectSummary 存在');
+});
+
+test('state-store.js 可导入', async () => {
+  const m = await import('../lib/vm/state-store.js');
+  assert(m.StateStore !== undefined, 'StateStore 存在');
+});
+
+test('data-provider.js 可导入', async () => {
+  const m = await import('../lib/vm/data-provider.js');
+  assert(m.PDDDataProvider !== undefined, 'PDDDataProvider 存在');
+});
+
+test('event-bus.js 可导入', async () => {
+  const m = await import('../lib/vm/event-bus.js');
+  assert(m.VMEvents !== undefined, 'VMEvents 存在');
+  assert(m.VMEventBus !== undefined, 'VMEventBus 存在');
+});
+
+test('dashboard/server.js 可导入', async () => {
+  const m = await import('../lib/vm/dashboard/server.js');
+  assert(m.DashboardServer !== undefined, 'DashboardServer 存在');
+});
+
+test('tui/tui.js 可导入', async () => {
+  const m = await import('../lib/vm/tui/tui.js');
+  assert(m.TUIApp !== undefined, 'TUIApp 存在');
+});
+
+// Test 2: Feature 模型测试
+console.log(chalk.bold('\n2. Feature 数据模型测试'));
+test('Feature 创建与序列化', async () => {
+  const { Feature, StageEnum, QualityMetrics, TokenUsage } = await import('../lib/vm/models.js');
+  const f = new Feature({
+    id: 'test-001',
+    name: 'Test Feature',
+    stage: StageEnum.IMPLEMENTING,
+    priority: 'P0'
+  });
+  assert(f.id === 'test-001', 'ID 正确');
+  assert(f.stage === 'implementing', 'Stage 正确');
+  const json = f.toJSON();
+  assert(json.id === 'test-001', 'JSON ID 正确');
+  const restored = Feature.fromJSON(json);
+  assert(restored.id === f.id, 'Roundtrip ID 匹配');
+  assert(restored.stage === f.stage, 'Roundtrip stage 匹配');
+});
+
+// Test 3: StageEnum 完整性
+test('StageEnum 包含6个阶段', async () => {
+  const { StageEnum, STAGE_VALUES } = await import('../lib/vm/models.js');
+  assert(STAGE_VALUES.length === 6, `应有6个阶段, 实际${STAGE_VALUES.length}`);
+  assert(STAGE_VALUES.includes('prd'), '包含 prd');
+  assert(STAGE_VALUES.includes('done'), '包含 done');
+});
+
+// Test 4: QualityMetrics 等级映射
+test('评分到等级映射正确', async () => {
+  const { getGradeFromScore } = await import('../lib/vm/models.js');
+  assert(getGradeFromScore(98) === 'S', '98 → S');
+  assert(getGradeFromScore(90) === 'A', '90 → A');
+  assert(getGradeFromScore(75) === 'B', '75 → B');
+  assert(getGradeFromScore(60) === 'C', '60 → C');
+  assert(getGradeFromScore(45) === 'D', '45 → D');
+  assert(getGradeFromScore(20) === 'F', '20 → F');
+});
+
+// Test 5: EventBus 事件发射
+test('EventBus 事件发射与接收', async () => {
+  const { createEventBus, VMEvents } = await import('../lib/vm/event-bus.js');
+  const bus = createEventBus();
+  let received = false;
+  bus.on(VMEvents.FEATURE_STAGE_CHANGED, () => { received = true; });
+  bus.emitStageChange('f1', 'prd', 'spec', {});
+  assert(received, '事件被接收');
+
+  const evt = bus.getSSEEvent();
+  assert(evt !== null, 'SSE事件存在');
+  assert(evt.type === 'feature_stage_changed', 'SSE事件类型正确');
+});
+
+// Test 6: 文件结构完整性
+console.log(chalk.bold('\n3. 文件结构完整性测试'));
+const requiredFiles = [
+  'lib/vm/models.js',
+  'lib/vm/state-schema.js',
+  'lib/vm/state-store.js',
+  'lib/vm/scanner.js',
+  'lib/vm/reconciler.js',
+  'lib/vm/event-bus.js',
+  'lib/vm/data-provider.js',
+  'lib/vm/hooks/hook-interface.js',
+  'lib/vm/hooks/generate-hook.js',
+  'lib/vm/hooks/verify-hook.js',
+  'lib/vm/hooks/extract-hook.js',
+  'lib/vm/hooks/report-hook.js',
+  'lib/vm/dashboard/server.js',
+  'lib/vm/dashboard/sse.js',
+  'lib/vm/dashboard/api-routes.js',
+  'lib/vm/dashboard/static/index.html',
+  'lib/vm/dashboard/static/css/dashboard.css',
+  'lib/vm/dashboard/static/js/app.js',
+  'lib/vm/dashboard/static/js/charts.js',
+  'lib/vm/dashboard/static/js/pipeline-view.js',
+  'lib/vm/dashboard/static/js/kanban-view.js',
+  'lib/vm/dashboard/static/js/quality-view.js',
+  'lib/vm/dashboard/static/js/system-view.js',
+  'lib/vm/tui/tui.js',
+  'lib/vm/tui/renderer.js',
+  'lib/vm/tui/input.js',
+  'lib/vm/tui/components/progress-bar.js',
+  'lib/vm/tui/components/table.js',
+  'lib/vm/tui/components/sparkline.js',
+  'lib/vm/tui/components/status-light.js',
+  'lib/vm/tui/components/card.js',
+  'lib/vm/tui/screens/overview-screen.js',
+  'lib/vm/tui/screens/kanban-screen.js',
+  'lib/vm/tui/screens/quality-screen.js',
+  'lib/vm/tui/screens/system-screen.js'
+];
+
+for (const file of requiredFiles) {
+  test(`文件存在: ${file}`, () => {
+    const fullPath = path.join(__dirname, '..', file);
+    assert(fs.existsSync(fullPath), `文件不存在: ${fullPath}`);
+  });
+}
+
+// 结果汇总
+console.log(chalk.bold('\n' + '='.repeat(40)));
+console.log(chalk.bold('Result: ' + chalk.green(passed + ' passed') + ' / ' + chalk.red(failed + ' failed') + ' / ' + (passed + failed) + ' total'));
+if (failed > 0) {
+  console.log(chalk.red('\n❌ 有测试失败！'));
+  process.exit(1);
+} else {
+  console.log(chalk.green('\n✅ 所有测试通过！PDD-VM 集成就绪。'));
+  process.exit(0);
+}

package/skills/core/official-doc-writer/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wonderqi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/core/official-doc-writer/README.md

@@ -0,0 +1,232 @@
+# official-doc-writer
+
+党政机关公文生成技能，符合 GB/T 9704-2012《党政机关公文格式》国家标准。
+
+## 概述
+
+本技能用于生成符合《党政机关公文处理工作条例》和 GB/T 9704-2012《党政机关公文格式》国家标准的公文文档，支持多种公文类型，并可导出为标准格式的 Word 文档。
+
+## 功能特性
+
+### 支持的公文类型
+
+| 公文类型 | 说明              | 适用场景      |
+| ---- | --------------- | --------- |
+| 通知   | 传达要求下级机关执行事项    | 部署工作、发布信息 |
+| 报告   | 向上级机关汇报工作       | 工作汇报、情况报告 |
+| 请示   | 向上级机关请求指示批准     | 申请审批、请求指示 |
+| 函    | 平行机关或不相隶属机关商洽工作 | 业务沟通、协商函  |
+
+### 核心功能
+
+1. **智能对话交互** - 通过引导式对话收集公文要素
+2. **自动格式排版** - 符合 GB/T 9704-2012 标准格式
+3. **Word 文档导出** - 生成可直接使用的 .docx 文件
+4. **公文字体支持** - 内置所需字体文件
+
+### 对话交互要素
+
+**核心要素（必填）**：
+
+- 公文类型
+- 发文机关
+- 主送机关
+- 公文标题
+- 成文日期
+- 正文内容
+
+**可选要素**：
+
+- 发文字号
+- 密级
+- 紧急程度
+- 签发人
+- 附件
+- 抄送机关
+
+## 快速开始
+
+### 方式一：使用 Trae/Trae AI
+
+在 Trae 或 Claude 中直接调用本技能：
+
+`
+帮我写一份关于安全生产的通知
+`
+
+### 方式二：运行 Python 脚本
+
+`bash 
+
+cd official-doc-writer
+
+python scripts/generate_official_doc.py
+`
+
+## 目录结构
+
+`
+official-doc-writer/
+ SKILL.md                    # 技能定义文件
+ LICENSE                     # MIT 许可证
+ README.md                   # 说明文档
+ document_generator.py       # 文档生成核心类
+ examples.md                 # 使用示例
+ fonts/                     # 字体资源目录
+    README.md              # 字体安装说明
+    FONTS_LIST.md         # 字体清单
+    SIMFANG.TTF            # 仿宋_GB2312
+    SIMHEI.TTF            # 黑体
+    SIMKAI.TTF            # 楷体_GB2312
+    SIMSUN.TTC            # 宋体
+    方正小标宋GBK.TTF     # 方正小标宋_GBK
+ references/                # 参考文档
+    GBT_9704-2012_党政机关公文格式.md  # 国标文档
+ scripts/                   # 可执行脚本
+     generate_official_doc.py   # 公文生成脚本
+     install_fonts.py           # 字体安装脚本
+     dialog_manager.py          # 对话管理器
+     smart_prompts.py           # 智能提示系统
+`
+
+## 字体安装
+
+### 为什么需要安装字体？
+
+GB/T 9704-2012 标准对公文字体有特殊要求，需要安装以下字体才能正确显示：
+
+| 字体        | 用途         |
+| --------- | ---------- |
+| 方正小标宋_GBK | 发文机关标志、标题  |
+| 仿宋_GB2312 | 正文、发文字号    |
+| 黑体        | 一级标题、密级    |
+| 楷体_GB2312 | 二级标题、签发人姓名 |
+| 宋体        | 页码         |
+
+### 自动安装（推荐自己提前安装好字体）
+
+`ash
+
+# Windows 系统（以管理员身份运行）
+
+python scripts/install_fonts.py
+
+# macOS/Linux 系统
+
+python scripts/install_fonts.py
+`
+
+脚本会自动：
+
+1. 从系统字体目录复制字体到 fonts 目录
+2. 检测系统已安装的字体
+3. 安装缺失的字体
+
+### 手动安装
+
+1. 复制 fonts 目录中的字体文件到系统字体目录：
+   
+   - Windows: C:\\Windows\\Fonts
+   - macOS: ~/Library/Fonts
+   - Linux: ~/.fonts
+
+2. 重启 WPS/Word 使字体生效
+
+## 使用示例
+
+### 示例 1：生成通知
+
+**输入**：
+`
+帮我写一份关于安全生产的通知，发文机关是XXX公司，主送机关是各部门。
+`
+
+**输出**：生成符合标准的通知文档，包含：
+
+- 发文机关标志
+- 标题：关于安全生产的通知
+- 主送机关
+- 正文内容
+- 成文日期
+- 落款
+
+### 示例 2：生成请示
+
+**输入**：
+`
+我需要一份关于采购办公设备的请示，向集团申请购买一批电脑。
+`
+
+**输出**：生成符合标准的请示文档，包含：
+
+- 标题：关于采购办公设备的请示
+- 主送机关
+- 正文：采购原因、预算金额等
+- 签发人
+- 附件（如有）
+
+## 技术实现
+
+### 依赖库
+
+- python-docx: Word 文档生成
+- python-dateutil: 日期处理
+
+### 核心模块
+
+#### document_generator.py
+
+文档生成核心类，负责：
+
+- 创建 Word 文档
+- 设置页面格式
+- 插入公文要素
+- 应用公文字体样式
+
+#### dialog_manager.py
+
+对话状态管理器，负责：
+
+- 跟踪对话进度
+- 收集公文要素
+- 生成下一步提示
+
+#### smart_prompts.py
+
+智能提示系统，负责：
+
+- 生成开头语建议
+- 生成结尾语建议
+- 提供格式参考
+
+## 许可证
+
+本项目采用 MIT 许可证，详见 LICENSE 文件。
+
+## 作者
+
+- 作者: neuqik@hotmail.com
+- 许可证: MIT
+
+## 相关标准
+
+- GB/T 9704-2012《党政机关公文格式》
+- 《党政机关公文处理工作条例》（中办发〔2012〕14号）
+
+## 常见问题
+
+### Q: 生成的 Word 文档字体显示不正常？
+
+A: 请确保已正确安装所需字体，参考「字体安装」章节。
+
+### Q: 如何修改默认的发文机关？
+
+A: 在对话中直接指定，如：发文机关是XXX公司。
+
+### Q: 支持哪些输出格式？
+
+A: 目前支持 .docx 格式，可直接用 WPS 或 Word 打开。
+
+### Q: 如何添加附件说明？
+
+A: 在对话中提及附件，如：附：采购清单一份，系统会自动添加附件说明。