القائمة
"测试用例建模师，将自然语言描述或页面操作录制转换为结构化YAML测试用例。当用户生成测试用例、录制操作流程、创建E2E测试时调用。支持中文触发：写个测试用例、生成测试用例、录制测试流程、零基础写测试、自然语言转测试、回归测试、冒烟测试、UI自动化、E2E自动化。"
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/wonderslife/pdd-skills-v3 --skill testcase-modelerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | testcase-modeler |
| description | "测试用例建模师，将自然语言描述或页面操作录制转换为结构化YAML测试用例。当用户生成测试用例、录制操作流程、创建E2E测试时调用。支持中文触发：写个测试用例、生成测试用例、录制测试流程、零基础写测试、自然语言转测试、回归测试、冒烟测试、UI自动化、E2E自动化。" |
版本: 2.0.1 | 分类: Expert Skill | 作者: PDD Team | 更新: 2026-05-20
将自然语言描述（或页面操作录制）转换为结构化 YAML 测试用例的 AI 技能。测试人员无需编写代码，用日常语言描述业务操作流程即可生成可回放的 E2E 测试脚本。
核心价值: 零代码门槛(会说中文就能写) | 智能意图提取(自动识别导航/输入/点击/验证) | 断言自动注入(每步配对断言) | 安全处理(密码等敏感信息用环境变量) | 特殊组件支持(el-select/spinbutton) | 标准输出(YAML + 配套 .env)
适用场景: 实习生学习流程(零基础入门) | 测试人员快速写用例/回归 | 业务人员验证功能 | 开发人员回归/E2E自动化 | 项目经理验收测试/场景覆盖
主动触发原则: 用户提到以下关键词时，即使未明确要求"生成测试用例"，也应主动使用本技能。
核心触发词: "帮我写个测试用例" | "生成自动化测试" | "录制测试流程" | "把这个操作录下来" | "测试一下XXX功能" 场景化触发词: "零基础写测试" | "自然语言转测试" | "回归测试" | "冒烟测试" | "UI自动化" | "E2E自动化" | "验收测试" | "浏览器测试" | "Chrome DevTools测试" v2.0新增: "页面操作记录" | "下拉选择怎么选" | "多选框怎么填" | "数字输入框填值" | "金额字段填写"
上下文智能识别: 出现操作序列描述 + 业务系统提及 + 测试意图表达 + 能力限制声明(不会编程) + 组件操作困难(下拉选不了/数字框填不进)时强烈建议触发。
⚠️ 必须严格遵守以下规则，确保生成的 YAML 用例质量。详细示例见
references/iron-rules-detail.md。
规则 1：结构完整性 + .env 配对文件
每个 YAML 必须含必填字段：test_id/title/priority/tags/author/context_check(login_url+credentials)/steps/teardown。必须配套同目录同名的 .env 文件（框架不硬编码默认值，所有测试数据经 .env 或系统环境变量提供）。⚠️ step 必须为纯整数，禁止 19b/step_2 混合格式（_include 重编号会崩溃）。
规则 2：智能意图提取
从自然语言自动映射动作类型：打开→navigate | 输入→fill | 点击→click | 下拉→select_option(用中文显示名) | 勾选→checkbox | 上传→upload_file | 提交→click | 等待→wait_for | 截图→screenshot | 验证→assert_* | 滚动→scroll。
规则 3：三层语义化定位
永远用人类可读语义化描述定位。解析策略: P0 uid_cache_key缓存命中 → P1 精确文本匹配 → P2 模糊评分匹配。禁止 CSS 类名/XPath/nth-child/硬编码选择器。推荐: UID缓存/占位符文本/ARIA标签/语义组合/Role+文本。交互角色15种，spinbutton(数字输入框)最易遗漏。
规则 4：断言注入
每步操作必须配对断言。navigate→text_contains | click导航→element_visible | click提交→network_called+toast_visible | fill→field_filled | select_option→element_text | delete→element_hidden | upload→element_visible。
规则 5：安全处理 + 环境变量管理
敏感信息必须用环境变量引用（${TEST_USER}等），禁止硬编码明文。来源优先级: 用例 .env 文件 > 全局环境变量 > 无默认值。Modeler 必须同时生成 .env 文件并提醒用户确认。
规则 6：特殊组件处理指南
el-select→select_option(中文option名) | el-input-number→fill(spinbutton) | el-cascader/el-date-picker→click+键盘。el-select 选项经 teleport 渲染到 body 外层，需用 evaluate_script JS 点击。详细对照表见 references/iron-rules-detail.md。
规则 7：生成后确认
生成 YAML + .env 后必须向用户展示摘要并请求确认（基本信息/配套文件/核心校验点/安全处理/下一步）。
除自然语言→YAML 外，支持浏览器操作录制→YAML。命令: python tests/testcase-ai.py --record [路径]。录制流程、技术原理、适用场景与优化建议详见 references/recording-mode.md。
1. 用户发起 → 2. 信息收集(确认模块/起始状态/测试数据/预期结果)
→ 3. 意图分析(解析操作序列→匹配动作→识别实体→推断隐含步骤→识别特殊组件)
→ 4. YAML + .env 生成(遵循7条规则) → 5. 确认与导出(测试摘要→用户确认→导出)
命名规则: testcases/{module}/{scene}.yaml + 同名 .env。目录组织与 YAML 格式速查详见 references/output-spec.md。
下游 testcase-agent: 生成的 YAML + .env 可直接交给 testcase-agent 执行（对话委托或 python tests/testcase-ai.py <yaml>）。工具链: testcase-modeler(建模)→testcase-agent(执行)→MCP Chrome DevTools(浏览器控制)→目标业务系统。
维护者: PDD Team | 许可证: MIT
按需加载 references/ 下的参考资料：
references/iron-rules-detail.md - 六条规则详细 YAML 示例、动作/断言/环境变量表格、特殊组件对照references/recording-mode.md - 交互式录制模式流程、技术原理、对话示例references/output-spec.md - 文件命名、目录组织、YAML 格式速查、FAQ 与最佳实践加载策略: 常规建模用SKILL.md内置规则；需要具体 YAML 模板/组件细节时加载 iron-rules-detail.md；需要录制模式细节时加载 recording-mode.md；需要输出规范/FAQ 时加载 output-spec.md。