pdd-skills 3.1.8 → 3.1.10

package/lib/init.js

@@ -499,7 +499,7 @@ export async function initProject(targetPath = '.', options = {}) {
   }
 
   // Copy AI Test Framework source files (testcase-ai.py, login_manager.py)
-  const srcRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..');
+  const srcRoot = path.resolve(__dirname, '..');
   console.log(chalk.blue('\n>> Copying AI Test source files...\n'));
   for (const rel of AI_TEST_SOURCE_FILES) {
     const srcPath = path.join(srcRoot, 'tests', path.basename(rel));

package/package.json

@@ -1 +1 @@
-{"name":"pdd-skills","version":"3.1.8","type":"module","description":"PDD Skills - PRD驱动开发框架 | 41+技能: 核心(12)/专家(8)/熵减(4)/OpenSpec(10)/PR管理(7) | AI原生开发工作流 | Bug模式库(14) | PRD规则(30) | 4级门控引擎","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":{"chalk":"^5.3.0","commander":"^12.0.0","fs-extra":"^11.2.0","yaml":"^2.3.0"}}
+{"name":"pdd-skills","version":"3.1.10","type":"module","description":"PDD Skills - PRD驱动开发框架 | 41+技能: 核心(12)/专家(8)/熵减(4)/OpenSpec(10)/PR管理(7) | AI原生开发工作流 | Bug模式库(14) | PRD规则(30) | 4级门控引擎","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","tests/testcase-ai.py","tests/login_manager.py","testcases/examples/"],"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":{"chalk":"^5.3.0","commander":"^12.0.0","fs-extra":"^11.2.0","yaml":"^2.3.0"}}

package/testcases/examples/asset-eval-apply.env

@@ -0,0 +1,8 @@
+# 资产评估申请测试用例 - 环境变量配置
+# 与 asset-eval-apply.yaml 同目录，执行时自动加载
+
+TEST_USER=yuanye
+TEST_PASS=yuanye
+TEST_DISPLAY_NAME=袁野
+TEST_PROJECT_NAME=AI自动测试项目-001
+TEST_AMOUNT=1000000

package/testcases/examples/asset-eval-apply.yaml

@@ -0,0 +1,171 @@
+# 资产评估申请 - 正常路径测试
+# 示例用例：演示完整的 YAML 结构和最佳实践
+
+test_id: "ASSET-EVAL-001-apply-normal"
+title: "资产评估申请正常提交流程"
+priority: "P0"
+tags: ["资产评估", "申请流程", "正常路径", "E2E"]
+author: "通过对话录入（示例）"
+
+# 前置状态感知
+context_check:
+  login_url: "http://uniportal.sjjk.com.cn"
+  home_indicator: "门户"
+  credentials:
+    username: "${TEST_USER}"
+    password: "${TEST_PASS}"
+    display_name: "${TEST_DISPLAY_NAME}"
+  captcha_required: false
+
+# 测试步骤
+steps:
+  # ===== 步骤 1：打开统一门户 =====
+  - step: 1
+    desc: "打开统一门户登录页面"
+    action: navigate
+    url: "http://uniportal.sjjk.com.cn"
+    assertion:
+      type: text_contains
+      expected: "欢迎登录"
+
+  # ===== 步骤 2：输入用户名（登录页，精确匹配）=====
+  - step: 2
+    desc: "输入用户名"
+    action: fill
+    target: "用户名输入框"
+    value: "${TEST_USER}"
+    assertion:
+      type: field_filled
+
+  # ===== 步骤 3：输入密码（登录页，精确匹配）=====
+  - step: 3
+    desc: "输入密码"
+    action: fill
+    target: "密码输入框"
+    value: "${TEST_PASS}"
+    isSensitive: true
+    assertion:
+      type: field_filled
+
+  # ===== 步骤 4：点击登录按钮（登录页，精确匹配）=====
+  - step: 4
+    desc: "点击登录按钮"
+    action: click
+    target: "登录按钮"
+    wait_after:
+      type: navigation
+      timeout: 10000
+    assertion:
+      type: text_contains
+      expected: "门户"
+
+  # ===== 步骤 5：进入资产评估系统（保留UID - 结构性入口稳定）=====
+  - step: 5
+    desc: "点击资产评估系统入口"
+    action: click
+    target: "资产处置及评估系统"
+    locator:
+      uid: "6_422"
+    wait_after:
+      type: navigation
+      timeout: 8000
+    assertion:
+      type: text_contains
+      expected: "资产处置及评估系统"
+
+  # ===== 步骤 6：展开一级菜单（保留UID - 导航结构相对稳定）=====
+  - step: 6
+    desc: "展开左侧菜单'资产评估'"
+    action: click
+    target: "资产评估"
+    locator:
+      uid: "7_22"
+    assertion:
+      type: element_visible
+      expected: "资产评估核准"
+
+  # ===== 步骤 7：展开二级菜单（保留UID - 导航结构相对稳定）=====
+  - step: 7
+    desc: "展开子菜单'资产评估核准'"
+    action: click
+    target: "资产评估核准"
+    locator:
+      uid: "15_1"
+    assertion:
+      type: element_visible
+      expected: "核准申请"
+
+  # ===== 步骤 8：点击"核准申请"页面（保留UID - 导航链接稳定）=====
+  - step: 8
+    desc: "点击'核准申请'菜单项，打开列表页"
+    action: click
+    target: "核准申请"
+    locator:
+      uid: "23_1"
+    wait_after:
+      type: navigation
+      timeout: 5000
+    assertion:
+      type: text_contains
+      expected: "项目名称"
+
+  # ===== 步骤 9：点击"新增"按钮（去UID - 靠文本匹配）=====
+  - step: 9
+    desc: "点击新增按钮，打开申请表单"
+    action: click
+    target: "新增"
+    assertion:
+      type: element_visible
+      expected: "项目名称"
+
+  # ===== 步骤 10：填写项目名称（去UID - 靠placeholder精确匹配）=====
+  - step: 10
+    desc: "填写项目名称字段"
+    action: fill
+    target: "请输入项目名称"
+    value: "${TEST_PROJECT_NAME}"
+    assertion:
+      type: field_filled
+
+  # ===== 步骤 11：填写评估金额（去UID - 靠placeholder精确匹配）=====
+  - step: 11
+    desc: "填写评估金额"
+    action: fill
+    target: "请输入报送评估值"
+    value: "${TEST_AMOUNT}"
+    assertion:
+      type: field_filled
+
+  # ===== 步骤 12：选择评估方法（去UID - 靠placeholder精确匹配）=====
+  - step: 12
+    desc: "选择评估方法为'市场法'"
+    action: select_option
+    target: "请选择评估方法"
+    option: "市场法"
+    assertion:
+      type: element_text
+      expected: "市场法"
+
+  # ===== 步骤 13：点击提交按钮（去UID - 靠文本匹配）=====
+  - step: 13
+    desc: "点击提交按钮，保存申请信息"
+    action: click
+    target: "提交申请"
+    wait_after:
+      type: time
+      duration: 2000
+    assertions:
+      - type: toast_visible
+        expected: "请输入评估对象"
+        confidence: high
+      - type: network_called
+        url_pattern: "/api/asset-eval/apply*"
+        method: POST
+        response_code: 200
+        confidence: high
+
+# 后置清理
+teardown:
+  - action: screenshot
+    name: "apply-normal-result-{timestamp}.png"
+    fullPage: true

package/testcases/examples/login-flow.env

@@ -0,0 +1,7 @@
+# 统一门户登录流程 - 环境变量配置
+# 与 login-flow.yaml 同目录，执行时自动加载
+
+TEST_USER=yuanye
+TEST_PASS=yuanye
+TEST_DISPLAY_NAME=袁野
+LOGIN_URL=http://uniportal.sjjk.com.cn

package/testcases/examples/login-flow.yaml

@@ -0,0 +1,171 @@
+# 统一门户登录流程 - 正常路径测试
+# 
+# 📋 用途: 验证PDD Test Skill的完整执行流程
+# 🎯 场景: 打开统一门户 → 输入凭据 → 点击登录 → 验证首页
+# 🔗 业务系统: http://uniportal.sjjk.com.cn
+# ⚠️ 安全提示: 所有敏感信息使用环境变量，禁止硬编码！
+
+test_id: "LOGIN-001-portal-normal"
+title: "统一门户登录正常流程"
+priority: "P0"
+tags: ["登录", "统一门户", "正常路径", "E2E", "试点验证"]
+author: "PDD Team (v1.0.1 试点用例)"
+
+# 前置状态感知
+context_check:
+  login_url: "http://uniportal.sjjk.com.cn"
+  home_indicator: "统一门户（新）"  # 已登录状态的标志性文本
+  credentials:
+    username: "${TEST_USER}"        # 从环境变量读取用户名
+    password: "${TEST_PASS}"        # 从环境变量读取密码（绝对禁止明文！）
+    display_name: "${TEST_DISPLAY_NAME}"  # 中文名，用于登录状态对比
+  captcha_required: false           # 测试环境通常不需要验证码
+  sso_enabled: true                 # 支持SSO单点登录
+
+# 测试步骤
+steps:
+  
+  # ===== 步骤 1：打开统一门户登录页面 =====
+  - step: 1
+    desc: "打开统一门户登录页面"
+    action: navigate
+    url: "${LOGIN_URL:-http://uniportal.sjjk.com.cn}"
+    wait_after:
+      type: time
+      duration: 2000  # 等待页面完全加载
+    assertions:
+      - type: text_contains
+        expected: "欢迎登录"
+        confidence: high
+      - type: element_visible
+        target: "盛京金控统一门户平台"
+        confidence: high
+
+  # ===== 步骤 2：输入用户名 =====
+  - step: 2
+    desc: "在用户名输入框中填入用户名"
+    action: fill
+    target: "用户"
+    locator:
+      uid_cache_key: "username_input"  # 缓存UID以便后续复用
+    value: "${TEST_USER}"
+    assertions:
+      - type: field_filled
+        expected: "字段已填写"
+        confidence: high
+      - type: value_equals
+        expected: "${TEST_USER}"
+        confidence: medium
+
+  # ===== 步骤 3：输入密码 =====
+  - step: 3
+    desc: "在密码输入框中填入密码"
+    action: fill
+    target: "密码"
+    locator:
+      uid_cache_key: "password_input"  # 缓存UID
+    value: "${TEST_PASS}"
+    assertions:
+      - type: field_filled
+        expected: "字段已填写"
+        confidence: high
+      # 注意：不验证密码值本身（安全原因），只验证字段非空
+
+  # ===== 步骤 4：点击登录按钮 =====
+  - step: 4
+    desc: "点击登录按钮提交登录信息"
+    action: click
+    target: "登录"
+    locator:
+      uid_cache_key: "login_button"  # 缓存UID
+    wait_after:
+      type: navigation              # 等待页面跳转
+      timeout: 10000                # 最长等待10秒
+    assertions:
+      # 断言 1：页面跳转到首页
+      - type: url_contains
+        expected: "/sys-portal"          # 或其他首页URL特征
+        confidence: high
+      # 断言 2：显示登录成功的标志
+      - type: text_contains
+        expected: "统一门户"         # 首页标题或欢迎信息
+        confidence: high
+      # 断言 3：网络校验（深度验证！）
+      - type: network_called
+        url_pattern: "/api/login*"   # 登录接口
+        method: POST
+        response_code: 200           # 必须返回200
+        response_body_contains:
+          - '"code":0'               # 或其他成功标识
+          - '"token"'                # 应该返回认证token
+        confidence: high
+
+  # ===== 步骤 5：验证首页关键元素 =====
+  - step: 5
+    desc: "验证首页加载完成并显示关键元素"
+    action: assert_multiple
+    assertions:
+      # 检查用户信息显示
+      - type: element_visible
+        target: "待办"
+        confidence: high
+      # 检查导航菜单
+      - type: element_visible
+        target: "主导航菜单"
+        confidence: high
+      # 检查应用图标/快捷方式
+      - type: element_count_greater_than
+        target: "电子档案"
+        min_count: 3                # 至少有3个应用入口
+        confidence: medium
+
+# 后置清理
+teardown:
+  - action: screenshot
+    name: "login-success-{timestamp}.png"
+    fullPage: true                  # 全页截图
+  - action: log
+    message: "登录流程测试完成，当前页面: {current_url}"
+
+# 元数据（用于报告和追踪）
+metadata:
+  created_by: "testcase-modeler v1.0.1"
+  test_environment: "staging"
+  browser: "chromium"
+  viewport: "1920x1080"
+  estimated_duration: "15-30s"
+  dependencies:
+    - "Chrome DevTools MCP 服务可用"
+    - "环境变量 TEST_USER 和 TEST_PASS 已设置"
+    - "网络连接正常"
+  risk_level: "low"                # 只读取数据，不修改任何内容
+  
+# 变体说明（供Modeler参考）
+variants:
+  - name: "错误密码登录"
+    description: "验证错误密码时的错误提示"
+    modifications:
+      - step: 3
+        value: "wrong_password"
+      - step: 4
+        assertions:
+          - type: replace
+            target: url_contains
+            with: error_message_visible
+            expected: "用户名或密码错误"
+
+  - name: "空用户名登录"
+    description: "验证必填字段校验"
+    modifications:
+      - step: 2
+        value: ""
+      - step: 4
+        assertions:
+          - type: add
+            target: validation_error_visible
+            expected: "请输入用户名"
+
+  - name: "Session过期重登"
+    description: "验证Session过期的自动检测和重新登录"
+    pre_condition: "已登录但Session已过期"
+    expected_behavior: "Agent自动检测到未登录状态，重新执行步骤1-4"