pdd-skills 3.0.0

package/bin/pdd.js

@@ -0,0 +1,354 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initProject } from '../lib/init.js';
+import { updateSkills } from '../lib/update.js';
+import { listSkills } from '../lib/list.js';
+import { showVersion } from '../lib/version.js';
+
+const program = new Command();
+
+program
+  .name('pdd')
+  .description('PDD-Skills - PRD Driven Development Skills')
+  .version(await showVersion());
+
+program
+  .command('init [path]')
+  .description('初始化PDD项目目录结构')
+  .option('-f, --force', '强制覆盖现有目录')
+  .option('-t, --template <name>', '使用指定模板', 'default')
+  .option('--no-skills', '不复制技能文件')
+  .action(async (path = '.', options) => {
+    console.log(chalk.blue('\n🚀 初始化PDD项目...\n'));
+    await initProject(path, options);
+    console.log(chalk.green('\n✅ PDD项目初始化完成!'));
+  });
+
+program
+  .command('update')
+  .description('更新PDD技能到最新版本')
+  .option('-v, --version <version>', '指定版本号')
+  .option('--check', '仅检查是否有更新')
+  .action(async (options) => {
+    await updateSkills(options);
+  });
+
+program
+  .command('list')
+  .description('列出所有可用技能')
+  .option('-c, --category <name>', '按分类筛选')
+  .option('--json', 'JSON格式输出')
+  .action(async (options) => {
+    await listSkills(options);
+  });
+
+program
+  .command('linter')
+  .description('运行代码质量门禁检查')
+  .option('-t, --type <type>', 'linter类型: java/js/python/sql/prd/skill/all', 'all')
+  .option('-f, --file <path>', '指定文件或目录')
+  .option('--incremental', '增量检查模式')
+  .option('-o, --output <format>', '输出格式: text/json/html', 'text')
+  .action(async (options) => {
+    const linterModule = await import('../scripts/linter/run-linters.js');
+    await linterModule.default(options);
+  });
+
+program
+  .command('generate')
+  .description('基于开发规格生成代码')
+  .option('-s, --spec <path>', '规格文件路径', 'dev-specs/spec.md')
+  .option('-o, --output <dir>', '输出目录', './generated')
+  .option('-f, --feature <name>', '指定功能点名称')
+  .option('--dry-run', '仅显示将要执行的操作，不实际生成')
+  .action(async (options) => {
+    const { generateCode } = await import('../lib/generate.js');
+    console.log(chalk.blue('\n🔨 基于开发规格生成代码...\n'));
+    await generateCode(options);
+    console.log(chalk.green('\n✅ 代码生成完成!'));
+  });
+
+program
+  .command('verify')
+  .description('验证功能实现是否符合规格和验收标准')
+  .option('-s, --spec <path>', '规格文件路径')
+  .option('-c, --code <dir>', '代码目录', './src')
+  .option('-v, --verbose', '显示详细验证信息')
+  .option('--json', '输出JSON格式的验证报告')
+  .action(async (options) => {
+    const { verifyFeature } = await import('../lib/verify.js');
+    console.log(chalk.blue('\n🔍 验证功能实现...\n'));
+    await verifyFeature(options);
+  });
+
+program
+  .command('report')
+  .description('生成分析报告(MD/JSON/HTML)')
+  .option('-t, --type <type>', '报告类型: md/json/html', 'md')
+  .option('-o, --output <path>', '输出路径', './reports/pdd-report')
+  .option('--include-stats', '包含统计信息')
+  .option('--include-charts', '包含图表(仅HTML)')
+  .action(async (options) => {
+    const { generateReport } = await import('../lib/report.js');
+    console.log(chalk.blue('\n📊 生成分析报告...\n'));
+    await generateReport(options);
+    console.log(chalk.green('\n✅ 报告生成完成!'));
+  });
+
+program
+  .command('config')
+  .description('管理PDD配置')
+  .option('-l, --list', '列出当前配置')
+  .option('-s, --set <key=value>', '设置配置项')
+  .option('-g, --get <key>', '获取指定配置项')
+  .option('--reset', '重置为默认配置')
+  .action(async (options) => {
+    const configManager = await import('../lib/config-manager.js');
+    await configManager.default(options);
+  });
+
+program
+  .command('cso')
+  .description('CSO分析 - 评估技能触发准确率和Token效率')
+  .option('-c, --category <name>', '分析指定分类')
+  .option('--token-analyze', 'Token效率分析模式')
+  .option('--fix', '自动优化description和triggers')
+  .action(async (options) => {
+    const { analyzeAllSkills, printCSOReport } = await import('../scripts/cso-analyzer.js');
+    const results = await analyzeAllSkills(options.category);
+    printCSOReport(results);
+  });
+
+program
+  .command('eval')
+  .description('运行技能评估测试')
+  .option('-s, --skill <name>', '测试指定技能')
+  .option('-c, --category <name>', '测试指定分类的所有技能')
+  .option('--verbose', '显示详细输出')
+  .action(async (options) => {
+    const { runEvals } = await import('../scripts/eval-runner.js');
+    await runEvals(options);
+  });
+
+program
+  .command('token')
+  .description('Token效率分析')
+  .option('-c, --category <name>', '分析指定分类')
+  .action(async (options) => {
+    const { analyzeTokenEfficiency } = await import('../scripts/token-analyzer.js');
+    await analyzeTokenEfficiency(options.category);
+  });
+
+program
+  .command('i18n')
+  .description('i18n双语化检查 - 验证技能的中英文双语覆盖')
+  .option('-c, --category <name>', '检查指定分类', 'core')
+  .action(async (options) => {
+    const { analyzeAllI18N, printI18NReport } = await import('../scripts/i18n-checker.js');
+    const results = await analyzeAllI18N(options.category);
+    printI18NReport(results);
+  });
+
+program
+  .command('api')
+  .description('启动PDD API服务器')
+  .option('-p, --port <port>', '监听端口号', '3000')
+  .option('-h, --host <host>', '绑定地址', 'localhost')
+  .option('--cors', '启用CORS跨域支持')
+  .action(async (options) => {
+    const { startApiServer } = await import('../lib/api-server.js');
+    await startApiServer({
+      port: parseInt(options.port, 10),
+      host: options.host,
+      cors: options.cors
+    });
+  });
+
+program
+  .command('openclaw [command]')
+  .description('OpenClaw AI Agent 编排平台集成')
+  .addCommand(
+    new Command()
+      .name('start')
+      .description('启动 OpenClaw 服务')
+      .option('-p, --port <port>', '监听端口号', '8080')
+      .option('-t, --token <token>', '认证令牌')
+      .option('--daemon', '以守护进程模式运行')
+      .action(async (options) => {
+        const { createCLI } = await import('../lib/openclaw/cli-integration.js');
+        const cli = createCLI();
+        await cli.execute('start', options);
+      })
+  )
+  .addCommand(
+    new Command()
+      .name('stop')
+      .description('停止 OpenClaw 服务')
+      .action(async () => {
+        const { createCLI } = await import('../lib/openclaw/cli-integration.js');
+        const cli = createCLI();
+        await cli.execute('stop');
+      })
+  )
+  .addCommand(
+    new Command()
+      .name('status')
+      .description('查看 OpenClaw 连接状态')
+      .action(async () => {
+        const { createCLI } = await import('../lib/openclaw/cli-integration.js');
+        const cli = createCLI();
+        await cli.execute('status');
+      })
+  )
+  .addCommand(
+    new Command()
+      .name('list-tools')
+      .description('列出已暴露给 OpenClaw 的工具')
+      .action(async () => {
+        const { createCLI } = await import('../lib/openclaw/cli-integration.js');
+        const cli = createCLI();
+        await cli.execute('list-tools');
+      })
+  )
+  .addCommand(
+    new Command()
+      .name('test')
+      .description('测试工具调用')
+      .option('-n, --tool-name <name>', '指定要测试的工具名称', 'pdd_list_skills')
+      .action(async (options) => {
+        const { createCLI } = await import('../lib/openclaw/cli-integration.js');
+        const cli = createCLI();
+        await cli.execute('test', options);
+      })
+  )
+  .addCommand(
+    new Command()
+      .name('logs')
+      .description('查看 OpenClaw 通信日志')
+      .option('--tail', '持续跟踪输出')
+      .option('-l, --limit <number>', '显示条数', '50')
+      .action(async (options) => {
+        const { createCLI } = await import('../lib/openclaw/cli-integration.js');
+        const cli = createCLI();
+        await cli.execute('logs', options);
+      })
+  );
+
+// === dashboard 子命令 (VM-D001) ===
+program
+  .command('dashboard')
+  .description('启动 PDD Web 可视化管理面板')
+  .option('-p, --port <port>', '监听端口号', '3001')
+  .option('--no-browser', '不自动打开浏览器')
+  .option('--no-open', '不自动打开浏览器（别名）')
+  .option('-r, --refresh <sec>', '自动刷新间隔(秒)', '30')
+  .action(async (options) => {
+    const { DashboardServer } = await import('../lib/vm/dashboard/server.js');
+    const server = new DashboardServer();
+    await server.start(parseInt(options.port, 10), {
+      open: !options.noBrowser && !options.noOpen,
+      refreshInterval: parseInt(options.refresh, 10) * 1000
+    });
+
+    process.on('SIGINT', async () => {
+      console.log(chalk.yellow('\n\n 正在关闭 Dashboard...'));
+      await server.stop();
+      process.exit(0);
+    });
+  });
+
+// === tui 子命令 (VM-D002) ===
+program
+  .command('tui')
+  .description('启动 PDD 终端可视化管理界面')
+  .option('-r, --refresh <sec>', '自动刷新间隔(秒)', '5')
+  .option('-t, --theme <theme>', '颜色主题', 'auto')  // auto/dark/light
+  .action(async (options) => {
+    const { TUIApp } = await import('../lib/vm/tui/tui.js');
+    const app = new TUIApp(process.cwd(), {
+      refresh: parseInt(options.refresh, 10),
+      theme: options.theme
+    });
+    await app.start();
+  });
+
+// === vm 子命令组 (VM-D003) ===
+const vmCmd = new Command()
+  .name('vm')
+  .description('PDD Visual Manager 状态查询命令');
+
+vmCmd
+  .command('status')
+  .description('查看项目状态摘要')
+  .option('--json', 'JSON格式输出')
+  .action(async (options) => {
+    const { PDDDataProvider } = await import('../lib/vm/data-provider.js');
+    const provider = new PDDDataProvider(process.cwd());
+    await provider.init();
+    const summary = provider.getSummary();
+    if (options.json) {
+      console.log(JSON.stringify(summary, null, 2));
+    } else {
+      // 终端表格输出
+      console.log(chalk.bold('\n📊 PDD 项目状态\n'));
+      console.log(`   项目名: ${summary.name}`);
+      console.log(`   总功能点: ${summary.totalFeatures}`);
+      console.log(`   整体进度: ${summary.overallProgress}%`);
+      console.log(`   平均质量分: ${summary.avgQualityScore}`);
+      console.log(`   Token消耗: ${summary.totalTokens}`);
+      console.log(`   平均迭代: ${summary.avgIterations}`);
+      console.log(`\n   阶段分布:`);
+      Object.entries(summary.stageDistribution || {}).forEach(([stage, count]) => {
+        console.log(`     ${stage.padEnd(12)} ${count} 个功能点`);
+      });
+    }
+  });
+
+vmCmd
+  .command('features')
+  .description('列出所有功能点')
+  .option('--stage <stage>', '按阶段筛选')
+  .option('--json', 'JSON格式输出')
+  .action(async (options) => {
+    const { PDDDataProvider } = await import('../lib/vm/data-provider.js');
+    const provider = new PDDDataProvider(process.cwd());
+    await provider.init();
+    let features = options.stage ? provider.getFeaturesByStage(options.stage) : provider.getFeatures();
+    if (options.json) {
+      console.log(JSON.stringify(features.map(f => f.toJSON()), null, 2));
+    } else {
+      console.log(chalk.bold(`\n📋 功能点列表 (${features.length}个)\n`));
+      features.forEach((f, i) => {
+        const stageColor = { prd:'magenta', extracted:'blue', spec:'green', implementing:'yellow', verifying:'red', done:'cyan' }[f.stage] || 'white';
+        console.log(`   ${String(i+1).padStart(2)}. ${chalk[stageColor](f.name.padEnd(30))} [${f.stage.toUpperCase().padEnd(12)}] ${f.quality?.score ? chalk.bold(f.quality.score+'('+f.quality.grade+')') : '-'}  tok:${f.tokens?.used||0}`);
+      });
+    }
+  });
+
+vmCmd
+  .command('export')
+  .description('导出项目数据')
+  .option('-f, --format <format>', '导出格式: json/md/csv', 'json')
+  .option('-o, --output <path>', '输出路径')
+  .action(async (options) => {
+    const { PDDDataProvider } = await import('../lib/vm/data-provider.js');
+    const fs = await import('fs');
+    const path_mod = await import('path');
+    const provider = new PDDDataProvider(process.cwd());
+    await provider.init();
+    let content = '';
+    const ext = options.format;
+    if (ext === 'json') content = provider.exportJSON({ mode: 'full' });
+    else if (ext === 'md') content = provider.exportMarkdown();
+    else if (ext === 'csv') content = provider.exportCSV();
+    else { console.error(chalk.red(`不支持格式: ${ext}`)); return; }
+    const outPath = options.output || `pdd-vm-export.${ext}`;
+    fs.writeFileSync(outPath, content, 'utf-8');
+    console.log(chalk.green(`✅ 已导出到: ${outPath} (${content.length} bytes)`));
+  });
+
+program.addCommand(vmCmd);
+
+program.parse();

package/config/bpmn-rules.yaml

@@ -0,0 +1,166 @@
+# Activiti BPMN Linter 规则配置
+#
+# 用于检查BPMN流程文件的规范性和最佳实践
+
+rules:
+  structure:
+    enabled: true
+    checks:
+      - id: bpmn-has-start-event
+        name: "流程必须有开始事件"
+        severity: error
+        message: "BPMN流程缺少开始事件(StartEvent)"
+        xpath: "//*[local-name()='process']"
+        condition: "count(//*[local-name()='startEvent']) > 0"
+
+      - id: bpmn-has-end-event
+        name: "流程必须有结束事件"
+        severity: error
+        message: "BPMN流程缺少结束事件(EndEvent)"
+        xpath: "//*[local-name()='process']"
+        condition: "count(//*[local-name()='endEvent']) > 0"
+
+      - id: bpmn-single-start-event
+        name: "建议只有一个开始事件"
+        severity: warn
+        message: "建议每个流程只包含一个开始事件"
+        max_count: 1
+
+      - id: bpmn-process-id-required
+        name: "流程ID必须存在且有效"
+        severity: error
+        pattern: "^[a-zA-Z][a-zA-Z0-9_]*$"
+        message: "流程ID格式无效，应以字母开头，仅包含字母数字下划线"
+
+      - id: bpmn-process-name-required
+        name: "流程必须有名称"
+        severity: error
+        message: "BPMN流程缺少name属性"
+
+  connectivity:
+    enabled: true
+    checks:
+      - id: bpmn-no-orphan-nodes
+        name: "无孤立节点"
+        severity: error
+        message: "检测到未连接的孤立节点，所有节点应有入边或出边"
+
+      - id: bpmn-no-dangling-flows
+        name: "无悬空流"
+        severity: warn
+        message: "检测到未连接到目标节点的序列流"
+
+      - id: bpmn-gateway-balance
+        name: "网关进出平衡"
+        severity: error
+        message: "网关的流入和流出数量不匹配（排他/并行网关应平衡）"
+
+      - id: bpmn-all-paths-to-end
+        name: "所有路径通向结束节点"
+        severity: error
+        message: "存在无法到达结束事件的执行路径"
+
+  naming:
+    enabled: true
+    checks:
+      - id: bpmn-task-id-convention
+        name: "任务ID命名规范"
+        severity: info
+        pattern: "^task_[a-z][a-z0-9_]*$"
+        message: "任务ID建议使用 task_xxx 格式的小写蛇形命名"
+
+      - id: bpmn-gateway-id-convention
+        name: "网关ID命名规范"
+        severity: info
+        pattern: "^gateway_[a-z][a-z0-9_]*$"
+        message: "网关ID建议使用 gateway_xxx 格式"
+
+      - id: bpmn-sequence-flow-id-convention
+        name: "序列流ID命名规范"
+        severity: info
+        pattern: "^flow_[a-z][a-z0-9_]*$"
+        message: "序列流ID建议使用 flow_xxx 格式"
+
+      - id: bpmn-chinese-name-required
+        name: "节点名称使用中文"
+        severity: warn
+        message: "节点名称建议使用中文以便业务理解"
+
+  best_practices:
+    enabled: true
+    checks:
+      - id: bpmn-no-deep-nesting
+        name: "避免过深嵌套"
+        severity: warn
+        max_depth: 5
+        message: "流程嵌套层级超过5层，建议拆分子流程"
+
+      - id: bpmn-reasonable-size
+        name: "流程规模合理"
+        severity: warn
+        max_nodes: 50
+        message: "流程节点数过多(>50)，建议拆分为子流程"
+
+      - id: bpmn-user-task-has-assignee
+        name: "用户任务需指定处理人"
+        severity: error
+        message: "用户任务(UserTask)必须指定assignee或candidateUsers"
+
+      - id: bpmn-service-task-has-class
+        name: "服务任务需指定实现类"
+        severity: error
+        message: "服务任务(ServiceTask)必须指定class或expression"
+
+      - id: bpmn-timer-event-valid
+        name: "定时器配置有效性"
+        severity: error
+        message: "定时器边界事件的配置不完整或格式无效"
+
+      - id: bpmn-signal-event-defined
+        name: "信号事件已定义"
+        severity: warn
+        message: "引用了未定义的信号(Signal)"
+
+      - id: bpmn-no-inline-scripts
+        name: "避免内联脚本"
+        severity: warn
+        message: "不建议在流程中使用内联脚本，建议使用ServiceTask委托"
+
+      - id: bpmn-form-key-configured
+        name: "表单Key已配置"
+        severity: info
+        message: "用户任务建议配置formKey以支持动态表单"
+
+  security:
+    enabled: true
+    checks:
+      - id: bpmn-no-hardcoded-passwords
+        name: "禁止硬编码密码"
+        severity: error
+        pattern: "(password|passwd|pwd)\s*[:=]\s*['\"][^'\"]+['\"]"
+        message: "检测到可能的硬编码密码"
+
+      - id: bpmn-no-sql-injection-risk
+        name: "SQL注入风险检查"
+        severity: error
+        pattern: "\\$\\{.*(?:SELECT|INSERT|UPDATE|DELETE|DROP)"
+        message: "检测到潜在的SQL注入风险，请使用参数化查询"
+
+      - id: bpmn-permission-check-before-approval
+        name: "审批前权限检查"
+        severity: warn
+        message: "审批节点前建议添加权限校验步骤"
+
+  documentation:
+    enabled: true
+    checks:
+      - id: bpmn-process-documentation
+        name: "流程文档说明"
+        severity: info
+        message: "建议为流程添加documentation文档说明"
+
+      - id: bpmn-task-documentation
+        name: "关键任务文档说明"
+        severity: info
+        min_priority_tasks: true
+        message: "关键任务建议添加documentation说明用途"

package/config/checkstyle.xml

@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE module PUBLIC "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN" "https://checkstyle.org/dtds/configuration_1_3.dtd">
+<module name="Checker">
+  <property name="charset" value="UTF-8"/>
+  <property name="fileExtensions" value="java"/>
+  <property name="severity" value="warning"/>
+
+  <module name="TreeWalker">
+    <property name="severity" value="warning"/>
+
+    <module name="JavadocMethod">
+      <property name="scope" value="public"/>
+      <property name="allowMissingParamTags" value="true"/>
+      <property name="allowMissingReturnTag" value="true"/>
+    </module>
+
+    <module name="JavadocType">
+      <property name="scope" value="public"/>
+    </module>
+
+    <module name="JavadocStyle">
+      <property name="scope" value="public"/>
+      <property name="checkEmptyJavadoc" value="true"/>
+    </module>
+
+    <module name="ConstantName"/>
+    <module name="LocalFinalVariableName"/>
+    <module name="LocalVariableName"/>
+    <module name="MemberName"/>
+    <module name="MethodName"/>
+    <module name="PackageName"/>
+    <module name="ParameterName"/>
+    <module name="StaticVariableName"/>
+    <module name="TypeName"/>
+
+    <module name="AvoidStarImport"/>
+    <module name="IllegalImport"/>
+    <module name="RedundantImport"/>
+    <module name="UnusedImports">
+      <property name="processJavadoc" value="true"/>
+    </module>
+
+    <module name="LineLength">
+      <property name="max" value="120"/>
+      <property name="ignorePattern" value="^package.*|^import.*|a href|href|http://|https://|ftp://"/>
+    </module>
+
+    <module name="MethodLength">
+      <property name="max" value="80"/>
+    </module>
+
+    <module name="FileLength">
+      <property name="max" value="800"/>
+    </module>
+
+    <module name="ParameterNumber">
+      <property name="max" value="7"/>
+    </module>
+
+    <module name="EmptyBlock">
+      <property name="option" value="TEXT"/>
+      <property name="tokens" value="LITERAL_TRY, LITERAL_FINALLY, LITERAL_IF, LITERAL_ELSE, LITERAL_SWITCH"/>
+    </module>
+
+    <module name="NeedBraces">
+      <property name="tokens" value="LITERAL_DO, LITERAL_ELSE, LITERAL_FOR, LITERAL_IF, LITERAL_WHILE"/>
+    </module>
+
+    <module name="EmptyCatchBlock">
+      <property name="exceptionVariableName" value="expected|ignore"/>
+    </module>
+
+    <module name="AvoidNestedBlocks">
+      <property name="allowInSwitchCase" value="true"/>
+    </module>
+
+    <module name="UpperEll"/>
+    <module name="ArrayTrailingComma"/>
+    <module name="DefaultComesLast"/>
+
+    <module name="SimplifyBooleanReturn"/>
+    <module name="StringLiteralEquality"/>
+    <module name="NestedIfDepth">
+      <property name="max" value="4"/>
+    </module>
+    <module name="MethodCount">
+      <property name="max" value="30"/>
+      <property name="maxPrivate" value="25"/>
+    </module>
+  </module>
+
+  <module name="FileTabCharacter">
+    <property name="eachLine" value="true"/>
+  </module>
+
+  <module name="NewlineAtEndOfFile">
+    <property name="lineSeparator" value="lf"/>
+  </module>
+
+  <module name="RegexpSingleline">
+    <property name="format" value="\s+$"/>
+    <property name="minimum" value="0"/>
+    <property name="message" value="行尾有多余空格"/>
+  </module>
+</module>

package/config/eslint.config.js

@@ -0,0 +1,48 @@
+export default [
+  {
+    ignores: ['**/node_modules/**', '**/dist/**', '**/.pdd/**', '**/coverage/**'],
+    files: ['**/*.{js,mjs,cjs,jsx,vue,ts,tsx}']
+  },
+
+  {
+    rules: {
+      'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+      'no-console': ['warn', { allow: ['warn', 'error'] }],
+      'no-debugger': 'error',
+      'no-duplicate-imports': 'error',
+      'no-var': 'error',
+      'prefer-const': 'warn',
+      'eqeqeq': ['warn', 'always'],
+      'curly': ['warn', 'multi-line'],
+
+      'complexity': ['warn', { max: 15 }],
+      'max-lines-per-function': ['warn', { max: 80, skipBlankLines: true, skipComments: true }],
+      'max-depth': ['warn', { max: 4 }],
+      'max-params': ['warn', { max: 5 }],
+      'max-lines': ['warn', { max: 300, skipBlankLines: true, skipComments: true }],
+
+      'padding-line-between-statements': [
+        'warn',
+        { blankLine: 'always', prev: '*', next: 'return' },
+        { blankLine: 'always', prev: ['const', 'let', 'var'], next: '*' },
+        { blankLine: 'any', prev: ['const', 'let', 'var'], next: ['const', 'let', 'var'] }
+      ]
+    }
+  },
+
+  {
+    files: ['**/*.vue'],
+    rules: {
+      'vue/multi-word-component-names': 'off',
+      'vue/no-unused-components': 'warn'
+    }
+  },
+
+  {
+    files: ['**/*.test.{js,ts}', '**/*.spec.{js,ts}'],
+    rules: {
+      'no-unused-vars': 'off',
+      'max-lines-per-function': 'off'
+    }
+  }
+];