用途
该技能用于处理需要真实 Design 编辑器会话才能确认的缺陷:在 Agent-Native Design 的本地或生产副本上,直接按报告步骤复现问题并描述实际应用行为,而不是仅靠阅读代码推断。
主要能力
- 启动工作树的 Design 应用:
.agents/skills/design-editor-repro/harness/start-dev.sh。 - 运行环境检查:
node .agents/skills/design-editor-repro/harness/doctor.mjs,直到本地应用和编辑器会话就绪。 - 复制源设计:
node .agents/skills/design-editor-repro/scripts/copy-design.mjs .;仅在配置了DESIGN_TEST_EMAIL与DESIGN_TEST_PASSWORD时使用生产副本,用完后删除。 - 使用
harness/dlib.mjs中的辅助函数打开编辑器、选择图层、检查字段、触发动作并读取持久化文件。 - 优先通过应用页面使用 Playwright 输入;仅当浏览器输入无法覆盖报告路径时,才使用操作系统输入助手。
- 需要视觉证据时,用
harness/shot.mjs截图,辅助函数返回本地路径供检查。
使用方式
先按上述命令启动应用并运行 doctor 检查,复制源设计,然后在修改应用代码前按报告步骤复现问题。仅将任务相关文件保存在 templates/design/.tmp/editor-repro/ 下。调查时检查相关实现和邻近测试,修复保持在应用边界内,并在现有测试套件支持处添加回归测试。
验证与限制
在修改后的构建上复现原始步骤;运行范围最窄的相关单元测试或浏览器测试,当改动影响画布行为时运行要求的 Design 交互测试通道;若修复改变可见行为,检查渲染后的应用。完成前关闭编辑器页面并删除任何临时生产副本。诊断数据仅保留在本地任务中,不要提交截图、复制的用户设计、会话数据、凭据或临时导出文件。更多细节参见 harness-recipes.md、reference/input-and-osmouse.md、reference/fixing.md、reference/tests-and-blast-radius.md 和 reference/performance.md。