ego-lite贡献者指南分支命名、Conventional Commits与PR流程完整教程【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-liteego-lite是一个专为 AI agent 设计的浏览器自动化项目它让 Codex、Claude Code 等智能体共享你已登录的浏览器状态在你不打扰的前提下并行执行浏览器任务。本仓库提供ego-browser的 Node.js 运行时与 agent 技能包零成本、零配置。想在 AI 浏览器自动化赛道上贡献代码本文带你从分支命名到 PR 合入一次走通完整流程。为什么值得参与 ego-lite 贡献 小而精的代码库核心源码集中在package/ego-browser/src/运行时仅依赖acorn一个包新人容易快速上手。规范透明贡献规则全部写在 CONTRIBUTING.md 和 AGENTS.md 中人类与 AI agent 共用同一套准则。自动化质量门禁本地 git hooks CI 双重把关提交前的问题会被提前拦截。快速了解项目全貌README.md、skills/ego-browser/SKILL.mdagent 使用手册。一键搭建本地开发环境所有命令都在package/ego-browser/目录下执行详见 CONTRIBUTING.md 第 4 节git clone https://gitcode.com/GitHub_Trending/eg/ego-lite cd ego-lite/package/ego-browser npm ci # 安装依赖会顺带安装 lefthook git hooks npm run build # 构建产物 npm test # 自动包含 build typecheck 测试环境要求Node.js ≥ 22、ESM only、npm 包管理器提交package-lock.json。分支命名规范如何创建一条合格的分支从最新的main日常改动请基于dev拉出分支命名格式为git checkout -b type/short-description分支名示例说明fix/restore-skill-1.2.3修复类改动feature/video-recording新功能docs/browser-automation-wording文档改动chore/issue-pr-templates工程杂项codex/update-readme-taglineAI agent 提交的分支codex/前缀 技巧短描述用英文小写 短横线与提交信息保持一致reviewer 一眼就能对应上。Conventional Commits 提交信息怎么写 仓库遵循 Conventional Commits 规范格式为type(scope): subject。参考真实提交历史fix(ego-browser): format object-shaped ego errors with message/JSON test(ego-browser): expand e2e coverage for handoff and control probing feat(ego-browser): add video recording and ticket rush e2e docs(ego-browser): restore runtime contract guidance chore(github): add issue and pull request templates常用 type 速查type用途feat新功能fix缺陷修复refactor重构不改变行为test仅测试docs仅文档chore/ci工程杂项 / CI 配置scope通常填ego-browser或对应的站点学习包名称如learnings/github。PR 提交流程从模板到合入 ✅1. 填写 PR 模板— 仓库预置了模板 .github/pull_request_template.md至少包含Summary一句话说明改了什么、为什么这是最小的可用方案Related issue用Closes #123关联 issueVerification列出验证命令及结果如npm testImpact 勾选清单是否触及公共 helper API、agent 技能、站点学习包等release-note 标签必选其一 ——feat/fix/docs/chore/ci/refactor2. 提交前本地自查最低标准npm test # 必须全绿 npm run typecheck # 类型检查 npm run validate:site-skills # 改动了 learnings 时必跑3. 目标分支日常改动 targetdev只有dev可以 targetmain。本地 Git Hooks提交被自动拦截的 7 道关卡 lefthook.yml 配置了 pre-commit 钩子npm install时自动启用钩子作用branch-up-to-date分支落后origin/dev时禁止提交提示先 rebasestyle-check对暂存的 ts/mjs/js/json/md 跑 prettier 检查vulnerability-auditnpm audit中等以上漏洞直接拦截code-checkTypeScript 类型检查smoke-test完整npm testsite-skill-validation站点技能格式校验e2e-testtask-space 端到端测试本地全绿CI 基本全绿 —— 这是本项目最小外科式改动文化的直接体现。CI 与发布流程从 Tag 到 Release ️CI 配置见 .github/workflows/ci.yml另有独立的 .github/workflows/quality-gates.yml 质量门禁每次 push / PRNode 22 下执行npm ci→npm test→npm run validate:site-skillsTagvX.Y.Z-beta.N构建 Beta 预发布版TagvX.Y.Z构建正式版并标记 latest发布说明由 .github/release.yml 按标签自动分组Features / Fixes / Documentation / Maintenance / Other Changes。这就是 PR 上必须打 release-note 标签的原因——不打标签你的改动会落入 Other Changes。四大设计原则改代码前必读 CONTRIBUTING.md 将四原则定为硬性要求每一条改动都应能追溯到任务本身原则含义Think Before Coding不臆测、不掩盖困惑显式提出取舍Simplicity First用最小代码解决问题不做投机式抽象Surgical Changes只改必须改的不顺手优化无关代码Goal-Driven Execution先把任务翻译成可验证目标先写检查再迭代Every changed line should trace back to the requirement of this task.提交前最终检查清单npm test与npm run typecheck通过分支名符合type/short-description格式提交信息符合 Conventional Commits 规范PR 已关联 issue 并勾选 Impact 区域已选择 release-note 标签公共 helper 有变动时同步更新了SKILL.md与SKILL.zh.md未引入未声明的运行时依赖 走到这一步你的第一个 PR 就只差 reviewer 的一个赞了。欢迎提交 Issues、PR 和新的站点学习包learnings pack让 ego-browser 因为你的贡献变得更聪明。【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考