[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82220":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":12,"contributorsCount":12,"subscribersCount":12,"size":12,"stars1d":12,"stars7d":14,"stars30d":15,"stars90d":12,"forks30d":12,"starsTrendScore":12,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":19,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":12,"starSnapshotCount":12,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},82220,"velocitai","DanielSuo117\u002Fvelocitai","DanielSuo117","Next-generation UI automation harness powered by Python & Playwright. Chat with AI Agents to seamlessly generate, architect, and execute enterprise-grade UI test code.",null,"HTML",183,0,112,21,54,52.9,false,"main",true,[],"2026-06-12 04:01:37","\u003Cdiv align=\"center\">\n\n# VelocitAI\n\n**[中文](#中文) | [English](#english)**\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Ca id=\"中文\">\u003C\u002Fa>\n\n## 中文\n\n**为 AI 编程代理提供的完整 UI 自动化方法论，基于可组合技能和强制规则构建。**\n\nVelocitAI 是一套 Agent Harness（代理治理框架）—— 不是又一个测试框架，而是让 AI 代理能够**自主生成、执行、调试和进化**企业级 UI 测试代码，基于 Python + Playwright + pytest。\n\n> 使用 AI Agent 仅需 15 个工作日，传统人工编码预估 60 个工作日 —— **4 倍开发速度**。\n\n---\n\n### 安装\n\n#### Claude Code（推荐）\n\n```bash\nclaude install-plugin velocitai\n```\n\n#### Copilot CLI\n\n```bash\n# 克隆并复制到你的项目\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{skills,rules,hooks,docs,CLAUDE.md,AGENTS.md} your-project\u002F\n```\n\n#### Gemini CLI\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{skills,rules,hooks,docs,CLAUDE.md,GEMINI.md} your-project\u002F\n```\n\n#### 手动安装\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{.claude,.claude-plugin,skills,rules,hooks,docs,CLAUDE.md,AGENTS.md,GEMINI.md} your-project\u002F\n```\n\n---\n\n### 包含内容\n\n#### 13 个技能（How-to）\n\n技能告诉你的代理**如何**完成任务 —— 分步操作指南。\n\n| 技能 | 用途 |\n|------|------|\n| `ui-automation-harness` | 路由器：将子技能组合成多步骤工作流 |\n| `gen-page-test` | 从目标页面生成 PageObject + 测试文件 |\n| `add-regression-point` | 为已有页面添加回归测试点 |\n| `locator-replacer` | 使用六级优先级替换脆弱定位符（P0 ARIA → P5 XPath） |\n| `test-runner` | 运行测试 + 结构化失败分析 |\n| `quick-debug` | 三步超时排查：页面 → tab → 定位符 |\n| `page-load-assertion` | 用 4 种验证模式设计 `is_page_loaded()` |\n| `wait-strategy` | 配置隐式\u002F显式等待策略 |\n| `browser-config` | viewport、超时、context、headless\u002Fheaded |\n| `case-round-trip` | 确保测试往返闭合（状态一致性） |\n| `save-verify-strategy` | Toast \u002F 重定向 \u002F 数据对比 \u002F 富文本验证 |\n| `architecture` | 架构决策、继承设计、角色拆分 |\n| `code-review-graph` | AST 知识图谱驱动的代码审查 |\n\n#### 14 个规则文件（Must \u002F Must-not）\n\n规则强制硬性约束。每条规则包含 ❌ 反模式 + ✅ 最佳实践。\n\n| 规则域 | 文件数 | 关键规则 |\n|--------|--------|---------|\n| **Agent 行为** | 3 | 运行测试前确认 `--env`；不自动提交；文档\u002F代码冲突时询问 |\n| **编码规范** | 1 | PascalCase 类名、snake_case 方法名、定位符声明为类常量 |\n| **Playwright** | 8 | 六级定位符优先级、禁止 `time.sleep()`、context 隔离 |\n| **报告策略** | 1 | 仅失败时生成 HTML 报告、自动轮转、域名统计 |\n\n#### 1 个子代理\n\n- **code-reviewer**：P0\u002FP1\u002FP2 分级审查 + AST 影响半径分析\n\n#### 自我进化机制\n\nVelocitAI 代理从错误中学习。遇到问题后，自动将经验持久化：\n\n| 类型 | 目标 |\n|------|------|\n| How-to（经验） | `skills\u002F\u003C主题>\u002FSKILL.md` |\n| Must\u002FMust-not（规则） | `rules\u002F\u003C规则域>\u002F\u003C规则>.md` |\n| 项目事实 | `docs\u002F\u003C文件>.md` |\n\n---\n\n### 工作流\n\n```\n1. 探索页面       → agent-browser（相比 Playwright MCP 节省 82-93% token）\n2. 生成 PageObject → gen-page-test 技能\n3. 编写测试用例    → add-regression-point + case-round-trip\n4. 运行 & 调试     → test-runner → quick-debug（自动三步排查）\n5. 代码审查        → code-reviewer 代理 + AST 知识图谱\n6. 进化沉淀        → 自动持久化到 skills \u002F rules \u002F docs\n```\n\n---\n\n### 项目结构\n\n```\nvelocitai\u002F\n├── CLAUDE.md                 # Agent 入口 & 路由表\n├── AGENTS.md                 # Copilot CLI 入口\n├── GEMINI.md                 # Gemini CLI 入口\n├── package.json              # npm 发布配置\n├── .claude-plugin\u002F           # Claude Code 插件配置\n│   ├── plugin.json\n│   └── marketplace.json\n├── .claude\u002F                  # Claude 专属配置\n│   ├── settings.json         # 权限 + hooks\n│   └── agents\u002F               # 子代理定义\n│       └── code-reviewer.md\n├── skills\u002F                   # 操作技能（How-to）\n│   ├── SKILL.md              # 路由器（组合子技能）\n│   ├── gen-page-test\u002F\n│   ├── locator-replacer\u002F\n│   ├── test-runner\u002F\n│   ├── quick-debug\u002F\n│   └── ... （共 13 个）\n├── rules\u002F                    # 强制规则（Must\u002FMust-not）\n│   ├── agent-behavior\u002F       # 3 个文件\n│   ├── coding-conventions\u002F   # 1 个文件\n│   ├── playwright\u002F           # 8 个文件\n│   └── report-strategy\u002F      # 1 个文件\n├── hooks\u002F                    # 会话与工具 hooks\n│   └── hooks.json\n└── docs\u002F                     # 项目知识库\n    ├── architecture.md\n    ├── pages-catalog.md\n    ├── regression-points.md\n    └── setup.md\n```\n\n---\n\n### 兼容的 AI Agent 平台\n\n| 平台 | 状态 | 入口文件 |\n|------|------|---------|\n| **Claude Code** | 原生支持（插件） | `CLAUDE.md` |\n| **GitHub Copilot CLI** | 技能兼容 | `AGENTS.md` |\n| **Gemini CLI** | 技能兼容 | `GEMINI.md` |\n| **Cursor** | 规则兼容 | `CLAUDE.md` |\n| **Windsurf** | 规则兼容 | `CLAUDE.md` |\n\n---\n\n### 技术栈\n\n- **Python 3.10+** — 核心语言\n- **Playwright** — 浏览器自动化\n- **pytest** — 测试框架\n- **Allure** — 测试报告\n- **agent-browser** — AI 驱动的浏览器 DOM 探索（可选，Rust CLI）\n- **code-review-graph** — AST 知识图谱 MCP（可选）\n\n---\n\n### 快速开始\n\n```bash\n# 1. 克隆并集成\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{skills,rules,hooks,docs,.claude,CLAUDE.md} your-project\u002F\n\n# 2. 安装依赖\ncd your-project\npython -m venv .venv && source .venv\u002Fbin\u002Factivate\npip install -r requirements.txt\nplaywright install chromium\n\n# 3. 运行测试（--env 必须指定）\npytest tests\u002F --env=pre\n\n# 4. 查看报告\nallure serve reports\u002Fallure-results\n```\n\n---\n\n### 许可证\n\nMIT\n\n\u003Cbr>\n\n**[⬆ 回到顶部](#velocitai) | [Switch to English ⬇](#english)**\n\n---\n\n\u003Ca id=\"english\">\u003C\u002Fa>\n\n## English\n\n**A complete UI automation methodology for your coding agents, built on composable skills and enforced rules.**\n\nVelocitAI is an agent harness — not another test framework — that gives AI agents the ability to **autonomously generate, execute, debug, and evolve** enterprise-grade UI test code using Python + Playwright + pytest.\n\n> 15 working days with AI Agent vs. 60 working days manual coding — **4x development speed**.\n\n---\n\n### Installation\n\n#### Claude Code (recommended)\n\n```bash\nclaude install-plugin velocitai\n```\n\n#### Copilot CLI\n\n```bash\n# Clone and copy to your project\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{skills,rules,hooks,docs,CLAUDE.md,AGENTS.md} your-project\u002F\n```\n\n#### Gemini CLI\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{skills,rules,hooks,docs,CLAUDE.md,GEMINI.md} your-project\u002F\n```\n\n#### Manual Setup\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{.claude,.claude-plugin,skills,rules,hooks,docs,CLAUDE.md,AGENTS.md,GEMINI.md} your-project\u002F\n```\n\n---\n\n### What's Inside\n\n#### 13 Skills (How-to)\n\nSkills teach your agent _how_ to do things — step-by-step operational guides.\n\n| Skill | Purpose |\n|-------|---------|\n| `ui-automation-harness` | Router: composes sub-skills into multi-step workflows |\n| `gen-page-test` | Generate PageObject + test file from a target page |\n| `add-regression-point` | Add regression test points to existing pages |\n| `locator-replacer` | Replace fragile locators using 6-level priority (P0 ARIA → P5 XPath) |\n| `test-runner` | Run tests + structured failure analysis |\n| `quick-debug` | 3-step timeout triage: page → tab → locator |\n| `page-load-assertion` | Design `is_page_loaded()` with 4 verification modes |\n| `wait-strategy` | Configure implicit\u002Fexplicit wait strategies |\n| `browser-config` | Viewport, timeout, context, headless\u002Fheaded |\n| `case-round-trip` | Ensure test round-trip closure (state consistency) |\n| `save-verify-strategy` | Toast \u002F redirect \u002F data comparison \u002F rich-text verification |\n| `architecture` | Architecture decisions, inheritance design, role splitting |\n| `code-review-graph` | AST knowledge graph driven code review |\n\n#### 14 Rule Files (Must \u002F Must-not)\n\nRules enforce hard constraints. Every rule includes ❌ anti-pattern + ✅ best practice.\n\n| Domain | Files | Key Rules |\n|--------|-------|-----------|\n| **Agent Behavior** | 3 | Confirm `--env` before tests; no auto-commit; ask on doc\u002Fcode conflict |\n| **Coding Conventions** | 1 | PascalCase classes, snake_case methods, locator class constants |\n| **Playwright** | 8 | 6-level locator priority, no `time.sleep()`, context isolation |\n| **Report Strategy** | 1 | HTML report only on failure, auto-rotation, domain stats |\n\n#### 1 Sub-Agent\n\n- **code-reviewer**: P0\u002FP1\u002FP2 graded review + AST impact radius analysis\n\n#### Self-Evolution\n\nVelocitAI agents learn from mistakes. After encountering issues, they automatically persist learnings:\n\n| Type | Target |\n|------|--------|\n| How-to (experience) | `skills\u002F\u003Ctopic>\u002FSKILL.md` |\n| Must\u002FMust-not (rule) | `rules\u002F\u003Cdomain>\u002F\u003Crule>.md` |\n| Project facts | `docs\u002F\u003Cfile>.md` |\n\n---\n\n### Workflow\n\n```\n1. Explore page       → agent-browser (82-93% token savings vs Playwright MCP)\n2. Generate PageObject → gen-page-test skill\n3. Write test cases    → add-regression-point + case-round-trip\n4. Run & debug         → test-runner → quick-debug (auto 3-step triage)\n5. Code review         → code-reviewer agent + AST knowledge graph\n6. Evolve              → auto-persist to skills \u002F rules \u002F docs\n```\n\n---\n\n### Project Structure\n\n```\nvelocitai\u002F\n├── CLAUDE.md                 # Agent entry point & route table\n├── AGENTS.md                 # Copilot CLI entry point\n├── GEMINI.md                 # Gemini CLI entry point\n├── package.json              # npm distribution\n├── .claude-plugin\u002F           # Claude Code plugin config\n│   ├── plugin.json\n│   └── marketplace.json\n├── .claude\u002F                  # Claude-specific config\n│   ├── settings.json         # Permissions + hooks\n│   └── agents\u002F               # Sub-agent definitions\n│       └── code-reviewer.md\n├── skills\u002F                   # Operational skills (How-to)\n│   ├── SKILL.md              # Router (composes sub-skills)\n│   ├── gen-page-test\u002F\n│   ├── locator-replacer\u002F\n│   ├── test-runner\u002F\n│   ├── quick-debug\u002F\n│   └── ... (13 total)\n├── rules\u002F                    # Enforced rules (Must\u002FMust-not)\n│   ├── agent-behavior\u002F       # 3 files\n│   ├── coding-conventions\u002F   # 1 file\n│   ├── playwright\u002F           # 8 files\n│   └── report-strategy\u002F      # 1 file\n├── hooks\u002F                    # Session & tool hooks\n│   └── hooks.json\n└── docs\u002F                     # Project knowledge base\n    ├── architecture.md\n    ├── pages-catalog.md\n    ├── regression-points.md\n    └── setup.md\n```\n\n---\n\n### Compatible Agents\n\n| Platform | Status | Entry File |\n|----------|--------|------------|\n| **Claude Code** | Native support (plugin) | `CLAUDE.md` |\n| **GitHub Copilot CLI** | Skills compatible | `AGENTS.md` |\n| **Gemini CLI** | Skills compatible | `GEMINI.md` |\n| **Cursor** | Rules compatible | `CLAUDE.md` |\n| **Windsurf** | Rules compatible | `CLAUDE.md` |\n\n---\n\n### Tech Stack\n\n- **Python 3.10+** — Core language\n- **Playwright** — Browser automation\n- **pytest** — Test framework\n- **Allure** — Test reporting\n- **agent-browser** — AI browser DOM exploration (optional, Rust CLI)\n- **code-review-graph** — AST knowledge graph MCP (optional)\n\n---\n\n### Quick Start\n\n```bash\n# 1. Clone and integrate\ngit clone https:\u002F\u002Fgithub.com\u002FDanielSuo117\u002Fvelocitai.git\ncp -r velocitai\u002F{skills,rules,hooks,docs,.claude,CLAUDE.md} your-project\u002F\n\n# 2. Install dependencies\ncd your-project\npython -m venv .venv && source .venv\u002Fbin\u002Factivate\npip install -r requirements.txt\nplaywright install chromium\n\n# 3. Run tests (--env is REQUIRED)\npytest tests\u002F --env=pre\n\n# 4. View report\nallure serve reports\u002Fallure-results\n```\n\n---\n\n### License\n\nMIT\n\n\u003Cbr>\n\n**[⬆ Back to top](#velocitai) | [切换到中文 ⬆](#中文)**\n","VelocitAI 是一个基于 Python 和 Playwright 的下一代 UI 自动化框架，通过与 AI 代理交互来生成、架构和执行企业级的 UI 测试代码。其核心功能包括自主生成测试代码、多步骤工作流组合、智能调试及代码审查，并且支持自我进化机制，能够从错误中学习并优化规则。该框架适合需要高效开发和维护大规模自动化测试的企业场景使用，尤其对于希望缩短开发周期同时保证测试质量的团队来说，是一个理想的选择。",2,"2026-06-11 04:08:05","CREATED_QUERY"]