用途:在 Codex 构建或迭代网页游戏(HTML/JS)时,提供可靠的开发与测试循环。每次迭代遵循“实现→操作→暂停→观察→调整”,小步改动并验证。
主要能力:通过 Playwright 客户端脚本执行动作序列、虚拟时间步进、截图与缓冲控制台错误;要求游戏暴露 window.render_game_to_text 输出简洁 JSON 状态,以及 window.advanceTime(ms) 确定性步进钩子,便于自动化测试稳定推进帧。
使用方式:先设置路径变量(CODEX_HOME、WEB_GAME_CLIENT、WEB_GAME_ACTIONS),技能默认安装在 $CODEX_HOME/skills。每次有意义改动后运行客户端脚本,动作基于 action_payloads.json 参考,避免猜测按键。示例命令:node "$WEB_GAME_CLIENT" --url http://localhost:5173 --actions-file "$WEB_GAME_ACTIONS" --click-selector "#start-btn" --iterations 3 --pause-ms 250。需实际打开并目视检查最新截图,核对文本状态与画面一致,修复首个新报错后再继续。
适用场景:网页游戏功能开发、交互与控制验证、胜负与分数/生命变化、边界碰撞、菜单暂停流程、特殊能力与解谜等。
限制与要求:需 Playwright 可用(优先本地依赖,否则检查 npx,必要时 npm install -g @playwright/mcp@latest);不要改用 @playwright/test,除非明确要求。建议单画布居中、背景绘制在画布上、文字尽量少、用 f 切换全屏并支持 Esc 退出。需维护 progress.md 记录原始提示与 TODO。具体收费、平台与效果资料暂未提供。