语言运行时编译器JIT编译解释器内存管理【免费下载链接】v8The official mirror of the V8 Git repository项目地址https://gitcode.com/gh_mirrors/v81/v8点击查看免费下载agents/是 V8 仓库中面向 AI 编码 Agent如 Gemini CLI、GitHub Copilot CLI、Jetski 等的集中式资源目录负责以可扩展、有组织的方式在开发者之间共享提示词Prompts、规则Rules、技能Skills与工具插件Plugins并兼容 Linux、macOS、Windows 多种开发环境。读完本文你将掌握该目录的整体架构、四个内置子代理Subagents的配置模型、三个平台安装脚本Gemini CLI / Jetski / Copilot CLI的工作原理与用法以及如何按既定格式向其中贡献新的 Agent 技能。一、目录定位与设计目标本目录的入口文档为 agents/README.md其核心定位是为 V8 开发中使用的 AI 编码 Agent 提供一个集中存放共享文件的单一入口。设计上主要解决三个问题规模化与组织化随着 Agent 提示词和工具不断增多需要一个清晰的目录结构来避免混乱跨环境兼容开发者分布在 Linux、Mac、Windows 等不同平台使用的 Agent 类型也各不相同Gemini CLI、Copilot CLI、Jetski 等生态一致性除 V8 专属的 skills 和 plugins 外目录结构与文档规范与 Chromium 的 agents 目录保持一致便于在两个大型代码库之间迁移经验。从仓库实际布局看该目录下共组织了六个核心组成部分agents/子代理、skills/技能、rules/规则、prompts/提示词、plugins/MCP 插件与scripts/安装与辅助脚本外加顶层 agents/OWNERS 与 agents/PRESUBMIT.py 负责权限与提交检查。二、Subagents按需调用的专属专家子代理Subagents是按需提供特定任务专家能力的 Agent 配置。所有子代理的源文件位于 agents/agents/ 目录下当前内置了四个角色子代理目录角色定位builderagents/agents/builder/按指定配置编译 V8读文件、搜代码以理解构建错误debuggeragents/agents/debugger/使用 GDB 等工具调查崩溃与非预期行为researcheragents/agents/researcher/在 V8 代码库与 Web 上检索相关代码、文档与信息产出带文件路径和行号的报告testeragents/agents/tester/运行测试与基准测试并汇报结果理解测试失败原因每个子代理目录由两个文件构成以 builder 为例agents/agents/builder/agent.json声明代理元数据包括namebuilder、descriptionSpecializes in building V8.以及指向配置文件的config_pathagents/agents/builder/config.yaml定义custom_agent结构其中system_prompt_sections以标题 内容形式给出系统提示词tool_names声明该代理可用的工具白名单。从源码结构看各子代理的工具配置存在明显分工builder、debugger、tester 均声明了run_command、view_file、grep_search、list_dir及mcp_*通配工具researcher 则不启用run_command转而声明search_web联网搜索与mcp_*与只做检索、不改动仓库的定位一致debugger 额外使用call_mcp_tool调用 GDB 相关的 MCP 工具。这种工具即权限边界的设计让子代理在获得任务所需能力的同时保持职责收敛。三、安装脚本把源配置变成各平台可识别的产物子代理源文件并不能被各 Agent 平台直接识别必须先在agents/目录下运行对应的安装脚本脚本均要求以vpython3或python3执行从仓库根目录的agents/目录进入1. Gemini CLIvpython3 scripts/install_for_gemini_cli.py该脚本agents/scripts/install_for_gemini_cli.py遍历 agents/agents/ 下每个子代理目录读取agent.json与config.yaml并执行以下转换拼接系统提示词把system_prompt_sections中的每个 section 渲染为# 标题 内容的 Markdown 段落工具名映射将通用工具名映射为 Gemini CLI 的工具名映射关系为通用工具名Gemini CLI 工具名view_fileread_filerun_commandrun_shell_commandlist_dirlist_directorysearch_webgoogle_web_searchcall_mcp_tool跳过不映射生成 frontmatter以name、description、kind: local、tools、model: inherit构成 YAML 头写入产物将结果写到仓库根目录的.gemini/agents/{name}.md。脚本最后还会检查仓库根目录是否存在GEMINI.md若不存在则自动创建内容为[Modular Rules](https://link.gitcode.com/i/161cec69e8e5a370aee6aad47fcc0f2f)用于以语法导入模块化规则模板。2. Jetskivpython3 scripts/install_for_jetski.py该脚本agents/scripts/install_for_jetski.py以符号链接方式在仓库根目录创建.agents/目录对agents/下的普通顶层项如prompts、scripts等直接符号链接到.agents/对agents、skills、rules、plugins四个关键目录先在.agents/下创建真实目录再对其中的每个子项逐个创建符号链接若.agents/本身是旧的符号链接或存在失效的符号链接脚本会先清理再重建保证幂等与 Gemini 脚本一样也会在需要时创建GEMINI.md。符号链接方案的好处是开发者每次同步本地 checkout 后技能内容自动保持最新无需重复生成。3. GitHub Copilot CLIvpython3 scripts/install_for_copilot_cli.py该脚本agents/scripts/install_for_copilot_cli.py面向 Copilot CLI 的适配逻辑最为复杂产出的文件都标记了!-- Generated by agents/scripts/install_for_copilot_cli.py. --生成标记且全部位于.github/下、被 Git 忽略.github/copilot-instructions.md总指令文件说明 V8 Agent 知识的规范来源位于agents/并列出 Copilot 无法自动触发的可选规则清单.github/instructions/把兼容的规则文件转换为 Copilot 可识别的指令文件。由于 Copilot 只读取带.instructions.md后缀的指令文件脚本会把规范的trigger/globsfrontmatter 翻译为applyToglobalways_on映射为**文件名形如{rule}.instructions.md.github/skills/优先以符号链接方式暴露兼容技能若符号链接失败则回退为生成包装器wrapperSKILL.md内容指引 Agent 去读取规范技能文件。此外脚本维护了两张不兼容黑名单跳过无法被 Copilot 适配的规则与技能COPILOT_INCOMPATIBLE_RULES如硬编码 Jetski/Gemini 行为的framework.md、强制TAGagy的git-commit.md等与COPILOT_INCOMPATIBLE_SKILLS如依赖未映射的编排 API 的orchestrator、v8-security-triaging等。脚本还支持--force参数强制刷新之前生成的文件并具备清理过期适配器能力只删除本脚本生成的产物绝不覆盖用户自建文件。四、Skills按需激活的共享专家知识与常规上下文文件不同agents/skills/ 中的技能是按需激活的共享专家知识可被 Gemini CLI、Claude、GitHub Copilot 等多个 Agent 在相关请求出现时自动识别并请求激活。每个技能都自包含在自己的目录中根目录必须有一个带 YAML frontmatter至少包含name与description的SKILL.md。仓库当前提供了约 30 个技能覆盖 V8 开发的典型场景编译与构建v8-setup、v8-commands调试workflow-debugging、workflow-general-debugging、workflow-gerrit-fix、clangd-setup性能分析v8-profile、crossbench、wasm-d8-perf、workflow-perf测试与回归v8-testing、v8-regression-testing、minimize-reproducer含配套脚本scripts/repro_check.sh安全与漏洞v8-security-triaging、v8-poc-classification领域知识torqueTorque.tq内建函数编写与调试、ecmascript-evaluation、v8-log、v8-structure、v8-understandingAgent 工程orchestrator、subagent-env-passing、agent-evaluation-framework、agent-self-improvement、env-abstraction、header-cycle-breaker。以 agents/skills/torque/SKILL.md 为例其 frontmatter 声明修改或调试 Torque 文件时使用不要用于 C 宏内建函数正文则完整给出 Torque 的四阶段执行流水线生成 → 编译 → 快照 → 链接与类型转换、控制流等实现模式属于高密度的按需领域知识。技能的实际激活方式参考 agents/skills/README.md优先以符号链接方式安装以保持同步例如gemini skills link agents/skills/skill-name --scope workspace安装后 Gemini CLI 会在请求与该技能相关时自动询问是否激活。五、Rules始终生效的约束与规范agents/rules/ 中的规则文件带有triggerfrontmatter用于声明触发方式如always_on表示始终生效。当前包括execution-constraints.md执行约束与循环防护例如禁止相同参数重复调用工具、先搜索再精读文件、复杂任务必须作为 Orchestrator 委托子代理并行执行、运行长输出命令时设置--no-pager或PAGERcat避免卡在分页器debugging.md、framework.md、git-cl.md、git-commit.md调试流程、Agent 框架约定、Gerrit CL 提交流程与提交信息规范torque.md、v8-best-practices.md、v8-regression-testing.mdTorque 编写、V8 最佳实践与回归测试纪律writing-skills.md编写新技能时应遵循的格式规范。正是这些规则的trigger词汇表被 Copilot 适配脚本读取并转换为applyToglob从而实现了规则在多个平台间的自动生效。六、Prompts公共提示词与模板体系agents/prompts/ 存放 V8 的公共提示词common.md与用于教会 Agent 特定工具的模板提示词templates/整体面向 Gemini CLI 工作流。使用方式是在仓库根目录创建本地、不被 Git 跟踪的GEMINI.md用语法引入相关提示词agents/prompts/common.md导入是否成功可用 Gemini CLI 的/memory show命令确认。已知限制是所有导入必须限定在当前提示词文件的作用域内a/prompt.md 可以导入同级或下级目录的 prompt但无法跨目录向上导入。agents/prompts/common.md 本身即是一份浓缩的V8 开发速查手册内容包括关键命令调试/优化调试/发布构建分别用tools/dev/gm.py quiet x64.debug/optdebug/release tests运行测试用tools/run-tests.py --progress dots --exit-after-n-failures5 --outdirout/x64.optdebug可追加cctest unittests、mjsunit等套件名格式化代码用git cl format目录结构速览逐一说明src/api/、src/ast/、src/compiler/、src/heap/、src/objects/、src/sandbox/、src/snapshot/、src/wasm/等核心子目录的职责帮助 Agent 快速定位代码构建与调试gm.py三种构建配置release / debug / optdebug的差异与--sync、--syncforce用法gdb --args out/x64.debug/d8 --my-flag my-script.js调试示例常用诊断 flag--trace-opt、--trace-deopt、--trace-gc、--allow-natives-syntax并指明 flag 定义位置在flag-definitions.h、d8 专属 flag 在src/d8/d8.cc的Shell::SetOptions测试run-tests.py的套件说明unittests、cctest、mjsunit、--progress dots的用法以及失败用例的重放方式提交规范[component]: Short descriptionBug:行的提交信息格式以及git cl format等最佳实践常见陷阱不编辑out/下的生成文件、测试配置与构建类型必须匹配、-inl.h头文件只能被其他-inl.h与.cc包含等。模板提示词方面agents/prompts/templates/modular.md 即安装脚本默认写入GEMINI.md的模块化规则模板。七、Plugins基于 MCP 的工具插件agents/plugins/ 存放通过 MCPModel Context Protocol向 Agent 暴露外部工具能力的插件并由 agents/plugins/install.py 统一管理安装。当前内置的插件是trace_processoragents/plugins/trace_processor/它通过 server.py 启动一个长驻的 FastMCP 服务器包装 Perfetto 的 Trace Processor使 Agent 能直接查询.pftrace、.perfetto-trace、.pb等 trace 文件其 mcp_config.json 声明了trace-processor这个 MCP 服务器及其启动命令。安装脚本支持四个目标平台Gemini CLIgemini mcp命令、Jetskijetski-cli plugin命令、Claude Desktop写claude_desktop_config.json与 Claude CLIclaude mcp add-json。CLI 用法示例# 列出可用与已安装的插件--agent 默认 jetski可选 gemini / claude-desktop / claude-cli vpython3 agents/plugins/install.py --agent gemini list # 为指定平台注册插件add / enable 等价remove / disable 为反操作 vpython3 agents/plugins/install.py --agent gemini add trace-processor # 重新注册所有本地插件把路径刷新为绝对路径 vpython3 agents/plugins/install.py --agent gemini fix插件配套技能 agents/plugins/trace_processor/skills/trace_processor/SKILL.md 还说明了如何编写 PerfettoSQL常见表包括slice、thread、process、sched_slice、track使用标准库模块如slices.with_context时以INCLUDE PERFETTO MODULE开头并指引参考third_party/perfetto/ai/skills下的原生 Perfetto AI 技能。八、Scripts开发流程辅助工具agents/scripts/ 除三个安装脚本外还包含支撑 V8 Agent 日常开发流程的辅助脚本create_worktree.sh / cleanup_worktree.sh创建与清理 git worktree便于并行处理多个 CLupload_cl.sh上传 CL 到 Gerritedit_cl_description.sh、validate_cl_description.py编辑与校验 CL 描述配合规则中的git-cl.md、git-commit.md使用get_recent_commits.py、analyze_brain.py分析最近提交与 Agent 上下文install_for_copilot_cli_test.pyCopilot 安装脚本的测试。九、如何贡献新的 Agent 内容agents/README.md 的贡献指南明确鼓励自由添加与现有示例格式一致的自包含 Agent 技能。结合前文新增内容的正确姿势是技能在 agents/skills/ 下新建独立目录根目录放带name与descriptionfrontmatter 的SKILL.md配套资源放在同目录内保持自包含可参考 writing-skills.md 与 skills/README.md子代理在 agents/agents/ 下新建目录提供agent.json与config.yaml并在tool_names中声明合理的工具白名单规则与提示词规则文件放入 agents/rules/ 并声明trigger公共提示词修改需谨慎common.md被广泛使用新模板放入 agents/prompts/templates/同步生效按所用平台运行对应的安装脚本Gemini CLI / Jetski / Copilot CLI或对技能使用gemini skills link符号链接方式安装以保持与仓库同步。需要注意的是agents/目录受 OWNERS 与 PRESUBMIT.py 约束合入改动需遵循 V8 常规的 Gerrit git cl提交流程。十、小结agents/目录是 V8 将人类开发规范沉淀为可被 AI Agent 消费的工程资产的典范子代理定义角色与工具边界技能承载按需激活的领域专家知识规则提供始终生效的约束提示词充当 Agent 的系统指令插件打通外部工具如 Perfetto而三个安装脚本则在 Gemini CLI、Jetski 与 Copilot CLI 之间实现了一次编写、多处适配。对于希望在 V8 上高效使用 AI 编码 Agent 的开发者理解这一目录的构成与安装流程是让 Agent 真正理解 V8 代码库、遵守其工程纪律的第一步。赞分享语言运行时编译器JIT编译解释器内存管理【免费下载链接】v8The official mirror of the V8 Git repository项目地址https://gitcode.com/gh_mirrors/v81/v8点击查看免费下载相关推荐猫抓Cat-Catch零门槛掌握浏览器资源嗅探的5个实用技巧猫抓Cat Catch零门槛掌握浏览器资源嗅探的5个实用技巧 你是否曾经遇到过这样的情况在网上看到一个精彩的视频教程却找不到下载按钮或者想保存某个在线讲语言运行时编译器JIT编译解释器内存管理open-agents 的 AGENTS.md 全解为 AI 编码 Agent 定义 Bun Turbo 单体仓库的工作契约open agents 的 AGENTS.md 全解为 AI 编码 Agent 定义 Bun Turbo 单体仓库的工作契约 AGENTS.md 是 op人工智能AI Agent代码智能体Agent 工作流Agent 沙箱工具调用后端前端Midscene 仓库中的 AGENTS.md/CLAUDE.md面向 AI 编码 Agent 的工程约定体系解析Midscene 仓库中的 AGENTS.md/CLAUDE.md面向 AI 编码 Agent 的工程约定体系解析 本篇技术指南以 Midscene 仓库根目人工智能AI Agent测试GUI 自动化浏览器控制测试智能体创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考