语言运行时编译器JIT编译解释器内存管理【免费下载链接】v8The official mirror of the V8 Git repository项目地址https://gitcode.com/gh_mirrors/v81/v8点击查看免费下载本篇技术指南围绕 V8 官方镜像仓库gh_mirrors/v81/v8中agents/prompts/templates/目录下的 prompt 模板机制展开系统讲解如何通过path语法把提示片段导入GEMINI.md、如何独立或组合使用模板、如何借助仓库内的安装脚本自动生成子 Agent 配置以及如何验证导入结果。读完本文你将掌握在 V8 仓库中为 Gemini CLI 搭建模块化系统指令System Instruction的完整流程并理解其背后的目录组织与源码实现。一、模板目录是什么可复用的 Prompt 片段在 V8 仓库中agents/prompts/templates/README.md 对模板目录做了精确定义These are prompt snippets that can be used independently or added to a base prompt to provide specific context and functionality.即agents/prompts/templates/下的文件是一组prompt 片段prompt snippets既可以独立使用也可以作为基础 prompt 的附加部分为 Agent 提供特定的上下文与功能。当前仓库中该目录实际包含两个文件agents/prompts/templates/README.md模板机制的说明文档即本指南的主体来源agents/prompts/templates/modular.md名为 Gemini Workspace for V8 的模块化模板是仓库中唯一的可导入模板示例。这种片段化 组合的设计思路是为了避免把海量上下文一次性塞进单个 prompt而是按需加载Agent 需要理解 V8 目录结构时导入v8-structure技能说明需要调试时导入调试工作流需要提交代码时导入 CL 规范从而实现轻量系统指令 按需扩展上下文的工程化 Prompt 管理。模板与 Skills / Rules 的分工值得强调的是templates/目录只是 prompt 体系的入口之一。从 agents/prompts/README.md 可以看到整个体系的分层prompts本目录面向 Gemini CLI 的公共 promptcommon.md与模板 prompttemplates/rulesagents/rules/强制性的行为规则如 framework.mdAgent 编排框架、execution-constraints.md执行约束、v8-best-practices.md最佳实践等skillsagents/skills/可随时调用的参考知识如 v8-structure目录结构、v8-commands构建/调试命令、v8-testing测试指南等agentsagents/agents/专门化的子 Agent 定义Researcher / Builder / Tester / Debugger。模板文件的作用就是把上述 skills、rules 与子 Agent 的入口以可导入的 prompt 片段形式统一组织起来。二、核心机制path导入语法模板能被系统指令吸收的关键在于 Gemini CLI 的导入语法。按照 agents/prompts/templates/README.md 的说明可以在GEMINI.md中通过path引用任意 prompt 文件agents/prompts/common.md agents/prompts/templates/example.md上面的示例展示了组合使用的场景把公共 prompt 与某个模板文件同时导入。其中agents/prompts/common.md是 V8 面向 Gemini 的公共基础 prompt内容涵盖关键命令tools/dev/gm.py quiet x64.debug tests、tools/run-tests.py ...、git cl format等、目录结构速览src/、test/、include/、out/各子目录职责、构建配置说明release / debug / optdebug 的区别、调试诊断 flag--trace-opt、--trace-deopt、--trace-gc、--allow-natives-syntax、测试套件unittests / cctest / mjsunit以及提交规范与常见陷阱agents/prompts/templates/example.md则是模板占位符实际使用时替换为具体模板文件名例如 agents/prompts/templates/modular.md。而独立使用的场景则只导入模板本身不附加公共 promptagents/prompts/templates/example.md这种用法适合模板本身已经自带完整上下文、无需基础 prompt 的情况。导入路径的语义注意上述代码块中的路径以仓库根为起点agents/prompts/...即相对仓库根目录的路径。如果你在仓库根目录创建GEMINI.md那么agents/prompts/common.md即可正确解析到agents/prompts/common.md文件。这与模板文档内部引用其他文件的方式保持一致——例如 agents/prompts/templates/modular.md 中引用的 v8-understanding 技能、agents/agents/researcher/等路径同样是以仓库根为起点。三、仓库中的唯一模板modular.md 深度解析agents/prompts/templates/modular.md 的标题是 Gemini Workspace for V8它是一份完整的模块化规则模板也是安装脚本自动生成的GEMINI.md的默认导入对象见下文第四节。该模板的内容结构如下3.1 总体定位与核心提示Hints模板开头说明它是 the workspace configuration for V8 when using Gemini并建议理解 V8 概念与结构时参考 v8-understanding 技能。随后给出了三条贯穿全篇的关键提示你是资深 C 开发者expert C developer正确性优先V8 面向用户运行不可信代码untrusted code正确性 bug 通常会导致终端用户的安全问题因此代码必须绝对正确、无 bug性能优先V8 为 Web 提供 JavaScript 与 WebAssembly 运行支持优化 V8 时必须追求最佳性能。这三条提示界定了 Agent 在 V8 中工作时的角色与价值取向是后续所有行为规则的基调。3.2 Subagents Setup安装脚本入口模板指明要使用仓库中的子 Agent需要根据环境运行对应的安装脚本Gemini CLI运行vpython3 agents/scripts/install_for_gemini_cli.py在.gemini/agents/下生成子 Agent 文件Jetski运行vpython3 agents/scripts/install_for_jetski.py在.agents/agents/下创建符号链接。这两个脚本的具体实现将在第五节详述。3.3 Workspace Subagents四个专门化子 Agent模板将详细信息的入口指向 agents/agents/ 目录下的四个子 Agent按需使用Researcher探索代码库、查找信息见 agents/agents/researcher/Builder编译 V8见 agents/agents/builder/Tester运行测试与基准测试见 agents/agents/tester/Debugger使用 GDB 调查崩溃见 agents/agents/debugger/。以 Researcher 为例其定义由两个文件组成agents/agents/researcher/agent.json元数据name、description、config_path与 agents/agents/researcher/config.yaml自定义 Agent 的 system prompt 段落与工具清单。config.yaml 中的system_prompt_sections以标题 内容的结构化方式定义指令tool_names则声明该 Agent 可用的工具如view_file、grep_search、list_dir、search_web、mcp_*。3.4 Workspace Skills Rules知识索引模板列出了一系列按需引用的 skills 与 rules全部指向仓库内以仓库根为起点的相对路径主题入口文件目录结构agents/skills/v8-structure/SKILL.md关键命令agents/skills/v8-commands/SKILL.md测试指南agents/skills/v8-testing/SKILL.md最佳实践agents/rules/v8-best-practices.md环境配置agents/skills/v8-setup/SKILL.mdGit CL 规范agents/rules/git-cl.mdTorque 指南agents/skills/torque/SKILL.md问题驱动调试agents/skills/workflow-debugging/SKILL.md通用调试agents/skills/workflow-general-debugging/SKILL.md性能评估agents/skills/workflow-perf/SKILL.mdAgent 评估agents/skills/agent-evaluation-framework/SKILL.mdAgent 自改进agents/skills/agent-self-improvement/SKILL.mdV8 开发工作流agents/skills/v8-workflow/SKILL.md这套索引让 Agent 在遇到具体任务时能快速定位权威参考而不是依赖模型自身的模糊记忆。例如 v8-structure 技能agents/skills/v8-structure/SKILL.md的 frontmatter 中带有name与description字段description 明确写明了该技能适用的场景Maps the V8 dir/folder structure, component locations, and local documentation便于 Agent 按语义匹配。3.5 Coding and Committing编码与提交规范模板要求在编码与提交时遵守以下约束始终遵循所修改代码周围的风格约定否则遵循 Chromium 的 C 风格指南使用git cl format自动格式化改动提交遵循 agents/rules/git-cl.md 中的约定最佳实践与常见陷阱参考 agents/rules/v8-best-practices.md。3.6 Agent Framework强制编排规则模板最后定义了 Agent 框架的强制要求强制编排Mandatory Orchestration在 V8 中执行任何任务时Agent 必须扮演 Orchestrator编排者角色使用agents/agents/中定义的专门化子 Agent必须遵守 agents/rules/framework.md 与 agents/rules/execution-constraints.md 中的规则这样做的目的是保证任务执行的效率efficiency、并行性parallelism与一致性consistency。这一节揭示了整个 prompt 体系的设计哲学模板不是简单的文本拼接而是一套编排层 执行层的 Agent 架构描述。四、从模板到系统指令GEMINI.md 的创建流程模板机制落地的完整流程记录在 agents/prompts/README.md 中分为三步第 1 步在仓库根目录创建本地、不被版本跟踪的GEMINI.md文件。第 2 步使用语法导入相关 prompt。例如只导入公共 promptagents/prompts/common.md更完整的做法是同时导入公共 prompt 与模板与第一节的组合示例一致使 Agent 既拥有基础能力又具备模块化的扩展上下文。第 3 步验证导入是否成功。在 gemini-cli 中运行/memory show命令确认 prompts 已正确导入。导入的已知限制agents/prompts/README.md 明确记录了一个已知问题All imports must be scoped to the current prompt file. a/prompt.md can import a/prompt2.md or a/b/prompt3.md, but cannot import c/prompt4.md.即所有导入必须限定在当前 prompt 文件所在的目录范围之内a/prompt.md可以导入a/prompt2.md或a/b/prompt3.md但不能导入c/prompt4.md跨目录兄弟节点。这意味着你无法用..跳转到无关目录去导入 prompt组织模板时必须保持目录结构的层级关系这一限制对设计自己的模板目录具有直接指导意义。五、源码视角安装脚本如何落地模板与子 Agent模板与子 Agent 的落地并非全靠手工仓库提供了两个自动化安装脚本其源码逻辑值得拆解。5.1 install_for_gemini_cli.py生成 .gemini/agents/agents/scripts/install_for_gemini_cli.py 的核心逻辑如下确定目标目录repo_root / .gemini / agents若该目录是符号链接则先移除遍历agents/agents/下的每个子目录要求同时存在agent.json与config.yaml否则跳过读取配置从agent.json取name、description从config.yaml的custom_agent节点取system_prompt_sections与tool_names拼接 system prompt将每个 section 以# {title} 内容的形式拼成 Markdown body工具名映射把通用工具名映射为 Gemini CLI 的工具名——view_file→read_file、run_command→run_shell_command、list_dir→list_directory、search_web→google_web_search、call_mcp_tool则被跳过其余工具名原样保留生成子 Agent 文件以frontmattername / description / kind: local / tools / model: inherit body的格式写出{name}.md到.gemini/agents/自动创建 GEMINI.md若仓库根目录尚不存在GEMINI.md则自动写入一行[Modular Rules](https://link.gitcode.com/i/dd53d496a5288969d769d49657658d62)把 agents/prompts/templates/modular.md 作为默认导入模板。从这段源码可以确认几个关键事实子 Agent 的最终形态是带 YAML frontmatter 的 Markdown 文件工具权限由config.yaml中的tool_names声明并映射而模板目录的modular.md正是安装脚本钦定的默认模板。5.2 install_for_jetski.py创建 .agents/ 符号链接agents/scripts/install_for_jetski.py 采用不同的落地方式目标目录为repo_root / .agents若它是指向agents的符号链接则先移除再确保其为真实目录清理.agents/下失效的顶层符号链接遍历agents/顶层条目对于agents、skills、rules、plugins之外的条目直接创建符号链接对于这四个特殊目录则在.agents/下建真实目录再对其内部每个子项逐一创建符号链接skills还会额外链接共享的git-cl-helper技能与 Gemini CLI 脚本相同若GEMINI.md不存在则写入[Modular Rules](https://link.gitcode.com/i/dd53d496a5288969d769d49657658d62)。两个脚本殊途同归一个生成实体文件一个生成符号链接但最终都确保GEMINI.md指向同一个模板入口。这也印证了模板机制与安装流程的深度耦合模板不仅是给模型看的文本还是自动化脚本的配置输入。六、实战建议与贡献指南6.1 推荐的启用流程综合上述机制在 V8 仓库中启用完整 prompt 体系的标准流程是运行vpython3 agents/scripts/install_for_gemini_cli.pyGemini CLI或vpython3 agents/scripts/install_for_jetski.pyJetski自动生成子 Agent 配置并创建默认GEMINI.md若希望叠加公共 prompt编辑根目录GEMINI.md在模板导入行之外追加agents/prompts/common.md在 gemini-cli 中运行/memory show验证所有导入均已生效按需让 Agent 通过模板索引加载 skills 与 rules如调试时加载 workflow-debugging提交时加载 git-cl。6.2 新增模板的注意事项agents/prompts/README.md 对贡献者给出了两条明确约束谨慎修改common.md它被广泛使用任何改动都影响所有依赖它的 prompt因此必须格外小心新模板放入template/目录想分享新 prompt 时应添加到agents/prompts/templates/即本指南所讲的模板目录而不是直接改动公共文件。同时结合已知的导入作用域限制新增模板时务必保证它能被目标GEMINI.md所在目录合法引用即模板与导入方处于同一目录子树内。七、小结V8 仓库以agents/prompts/templates/为枢纽构建了一套层次分明的 Gemini prompt 工程体系path语法负责按需导入modular.md模板充当模块化规则的默认入口四个专门化子 Agent 承接编排执行安装脚本则把这份设计自动落盘为GEMINI.md与.gemini/agents/。理解这套机制不仅能让你在 V8 开发中更高效地驾驭 Gemini CLI也为设计自己的 Agent prompt 组织方案提供了可复用的范本。进一步阅读模板机制的总入口见 agents/prompts/README.md公共基础 prompt 见 agents/prompts/common.md模板示例见 agents/prompts/templates/modular.md四个子 Agent 定义见 agents/agents/ 目录。赞分享语言运行时编译器JIT编译解释器内存管理【免费下载链接】v8The official mirror of the V8 Git repository项目地址https://gitcode.com/gh_mirrors/v81/v8点击查看免费下载相关推荐FanControl 实战指南Windows 智能风扇调节三步搞定风扇噪音FanControl 实战指南Windows 智能风扇调节三步搞定风扇噪音 渲染跑到凌晨两点CPU 温度往上顶风扇突然咆哮到全速几分钟后因过热降频。这桌面应用智能硬件gitignore.io模板仓库结构dataDirectory组织与优化gitignore.io模板仓库结构dataDirectory组织与优化 概述 gitignore.io是一个帮助开发者生成.gitignore文件的工具其开发工具后端CLISheeeeeeeeet核心组件详解从Menu到ActionSheet的完整实现Sheeeeeeeeet核心组件详解从Menu到ActionSheet的完整实现 Sheeeeeeeeet是一个强大的Swift库专门用于创建自定义菜单、操创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考