java-codegen-pro

Java Playwright + TestNG + Page Object 自动化代码生成 skill，面向 SAP 自动化、SOP 转代码、Playwright 录制脚本转 Java 自动化代码。

能做什么

• 将 Word、截图、口述流程整理为标准 SOP。
• 根据已有 SOP 生成 Java Playwright PO/Test。
• 将 Playwright codegen 录制脚本转换为 Java PO/Test。
• 在复杂流程中生成“防线模式”代码：策略恢复、DOM 感知、可选 AI 视觉兜底。
• 针对 SAP WebDynpro/Fiori 的表格、下拉、弹窗、消息区校验提供专门规则。

目录结构

SKILL.md                     # skill 入口和主流程
references/                  # 代码风格、SOP、SAP、防线模式、编译修复规则
scripts/extract_word.py      # 提取 docx 文字、表格、图片
scripts/write_word.py        # 将 SOP 文本写回 docx
fixtures/recovery-engine-compile/ # 防线引擎模板编译验证 fixture
evals/evals.json             # 回归测试提示词
SOP案例.md                   # 标准 SOP 示例
使用说明.md                  # 使用者说明

安装依赖

Word 处理脚本需要 python-docx：

pip install -r requirements.txt

使用入口

典型触发语：

• “帮我把这个 SOP 生成 Java Playwright PO/Test”
• “把这个 Playwright 录制脚本转成 Java 自动化代码”
• “这个 SAP 流程用防线模式生成自动化”
• “根据 Word 文档整理 SOP 并生成 Java Playwright 代码”

不要用于普通 Java 业务代码生成、只问 Playwright API、非 Java 项目或只修 bug 的场景。

生成前需要的信息

如果材料里已经包含 SOP 或录制脚本，skill 会先处理材料，再集中询问缺失项。通常需要确认：

• 参考项目路径：用于学习 PO/Test/工具类风格。
• 目标项目路径：生成代码写入的位置。
• 校验点：成功提示、状态变化或页面消息位置。
• 生成模式：传统模式或防线模式。

防线模式说明

防线模式会在 PO 中把每个操作步骤封装为 ActionContext，并复用一套 engine 代码执行恢复策略。

默认防线层级：

1. 策略引擎：重试点击、等待网络、重新触发上一步、滚动等。
2. DOM 感知：基于当前页面状态处理弹窗、遮罩、下拉等。
3. AI 视觉层：可选，需要生成 engine/ai/* 并补 Jackson 依赖。

如果目标项目不能新增 Jackson 依赖，不要生成 AI 视觉层；防线模式仍可使用前两层。

验证建议

生成目标项目代码后至少执行：

mvn test-compile

如果编译通过，再按目标项目的单测命令运行对应 Test 类。运行失败时，优先查看 Playwright 截图、控制台执行摘要和目标项目报告。

防线引擎模板可用下面的 fixture 验证：

python scripts/verify_recovery_engine_fixture.py

如果 Maven 不在 PATH，可以传入 --maven <mvn.cmd路径>。