Carbon 仓库的 AI 助手工具规范禁用传统 Shell 命令、改用语义化 API 工具【免费下载链接】carbon-langCarbon Languages main repository: documents, design, implementation, and related tools. (NOTE: Carbon Language is experimental; see README)项目地址: https://gitcode.com/GitHub_Trending/ca/carbon-lang导读本文聚焦 Carbon Language 主仓库中为 AI 助手LLM Agent制定的 Agent 工具使用技能文档系统解读其在文件查看、搜索、修改上的工具约束禁用cat/grep/sed等传统命令、推荐的语义化 API 工具映射以及临时文件的tmp/管理规则。读者读完可以掌握在 Carbon 仓库中什么样的命令与操作方式是合规的、为什么要如此约束以及如何把这一规范套用到自己的 Agent 工作流中从而保证 git 工作区整洁、操作可追踪。背景Carbon 仓库为何要为 AI 助手单独立规范Carbon 是一个高度依赖工具链、测试与自动化流程的编译器项目仓库中既有 C 实现的编译器toolchain/、Carbon 标准库core/也有大量测试数据与提案文档。为了让接入仓库的 AI 助手行为可预期、可审计项目在根目录的 AGENTS.md 中明确声明该文件为 contributing to the Carbon Language project 的 AI 助手提供高密度技术上下文并要求沟通简洁专业、修改后务必运行相关测试。在此基础上仓库在 .agents/skills/ 目录下按主题维护了一组技能Skill文档例如agent_tools命令行与文件操作工具的使用限制本文主题bazelBazel/Bazelisk 的构建、测试与调试规范toolchain_testsfile_test测试的编写与运行toolchain_development工具链架构、命令与调试proposals、diagnostics、jj、prek 等。这套 skills 结构的设计意图是把项目特有的操作约定打包成可供 AI 助手检索和遵循的规范而不是依赖助手对项目惯例的猜测。agent_tools技能正是其中约束最底层、适用范围最广的一则——它不限定于某个模块而是约束所有文件操作行为本身。核心规则MUST NOT 使用传统 UNIX 命令行工具技能文档的第一条硬性规则原文以MUST NOT强调AI assistants working on the Carbon repositoryMUST NOTuse legacy or generic UNIX shell search/edit commands when specialized environment tools exist.即在存在专用环境工具语义化 API的前提下一律禁止退回到通用 Shell 命令。具体被点名的禁用项包括类别禁用命令/做法官方给出的原因取向文件查看cat、less及其他用于查看文件的 Shell 工具应改用高保真语义化 API文件搜索grep、find及其他搜索工具应改用语义化搜索 API文件修改sed及其他修改类 Shell 工具应改用语义化修改 API补丁应用patch编写并应用补丁文件应改用语义化修改 API规避手段编写其他语言的临时脚本绕开上述限制明确禁止值得注意最后一条Writing custom scripts in other languages to circumvent this limitation编写其他语言的脚本绕过限制同样被禁止。这意味着规范针对的是行为方式而非具体命令名——即使换用 Python 脚本去执行原本grep/sed的活只要目的是绕开语义化工具就依然违规。应使用的语义化 API 工具DO USE 映射与禁用清单对应技能文档给出了一张DO USE工具映射表覆盖查看、搜索、修改三类操作查看Viewing用view_file替代cat/less搜索Searching用grep_search/find_by_name替代grep/find修改Modifying用replace_file_content、multi_replace_file_content或write_to_file替代sed/patch/ Python 编辑。文档强调这些是高保真high-fidelity的语义 API 工具。所谓语义化体现在操作对象是文件/符号/上下文级别的概念而不是文本流级别的字节处理。例如语义化搜索可以按文件类型、正则、上下文前后若干行组合检索并返回带行号的结构化结果便于 Agent 精确引用与定位语义化修改是整段内容的原子替换而不是逐行正则流式改写从而降低误替换风险也让变更更容易在 diff 中被审查语义化写入以完整文件内容为目标替代python脚本式的补丁拼装。这一约定的深层目的从仓库工程实践可以印证Carbon 的编译与测试产出严重依赖精确的内容匹配——例如 testing/file_test 体系靠// CHECK、// CHECK:STDERR等标注行比对期望输出CHECK行的任何文本级误改动都会导致测试语义失真参见 summarize_testdata_changes 技能 中对CHECK行每一个改动都必须归组说明的强调。因此文件操作越语义化、越不依赖脆弱的文本流假设仓库状态就越可控。例外条款何时允许编写临时程序规范并非绝对封死所有脚本使用而是给出一个明确的例外窗口You may only write and run temporary programs to modify source code if no semantic tool is applicable or when performing complex, systematic transforms across many codebase directories simultaneously.即满足以下任一情形时才允许编写并运行临时程序修改源码不存在适用的语义化工具语义 API 无法表达该操作跨大量目录的复杂、系统性变换例如对全仓库某类文件做统一结构迁移逐个文件用语义化工具反而低效且易遗漏。这个例外的边界值得仔细体会它把灵活性压缩到了工具能力之外的场景而不是给日常编辑开绿灯同时它暗示对于一次改一处的普通编辑Agent 不应使用脚本。临时文件管理统一归入tmp/并定期清理技能文档最后一部分规范了 Agent 在分析、实验、调试过程中产生的临时文件与草稿脚本必须放在工作区根目录下的tmp/子目录中MUST reside within thetmp/subdirectory under the workspace root必须在结束一轮任务前定期清理删除MUST be periodically cleaned out and deleted before ending your turn以保持 git 工作区干净。这一条与仓库根目录 .gitignore 中体现的保持工作区整洁工程纪律一脉相承.gitignore用大量条目屏蔽 Bazel 生成的bazel-*符号链接与输出目录、Python 的__pycache__/、clangd 缓存、编译数据库、编辑器临时文件等避免噪音进入版本控制。tmp/规则正是把AI 助手产生的中间产物纳入同一纪律集中放置便于统一清理结束前删除则确保交付的工作区状态与变更集干净、可审查不会把草稿误提交进 PR。在 Carbon 仓库中的落地实践综合 agent_tools 技能 与仓库内其他技能文档一名合规的 Agent 在 Carbon 仓库中的典型操作流程是了解环境约束先阅读根目录 AGENTS.md 与 .agents/skills/ 下的相关技能确认该仓库特有的规则例如 Bazel 必须经由bazelisk调用参见 Bazel 使用技能必要时使用 scripts/run_bazelisk.py。文件操作走语义化 API查看用view_file检索用grep_search/find_by_name修改用replace_file_content/multi_replace_file_content/write_to_file全程不触碰cat/less/grep/sed/patch。涉及测试变更时遵循测试技能改动工具链或测试数据后按 toolchain_tests 技能 运行file_test相关测试并用 summarize_testdata_changes 的规范归纳testdata变化。临时产物归位与清理任何调试脚本、中间文件一律放tmp/任务结束前删除交付前确认 git 工作区无残留。总结Carbon 仓库的 Agent 工具技能 虽篇幅精炼却定义了一条清晰的 Agent 行为边界优先语义化 API、禁止通用 Shell 文本工具、禁止脚本绕过、临时文件集中管理并限期清理。这套规范的价值在于它把对文件做正确的事从依赖 Agent 自觉转化为可检索、可执行、可审查的工程约定配合仓库已有的测试纪律与 .gitignore 工作区卫生策略共同保证 AI 助手在 Carbon 这种对内容精确性要求极高的编译器仓库中产生的是低噪音、高可控、易审查的变更。【免费下载链接】carbon-langCarbon Languages main repository: documents, design, implementation, and related tools. (NOTE: Carbon Language is experimental; see README)项目地址: https://gitcode.com/GitHub_Trending/ca/carbon-lang创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考