特工

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

成本模型——为什么每条生产线都很重要

AGENTS.md 在每次交互时都会自动注入到代理的上下文窗口中。与按需加载的文档或技能不同,AGENTS.md 永久占用代理在该存储库中处理的每个任务的上下文。臃肿的 AGENTS.md 会直接降低代理在所有方面的性能——减少代码、对话和推理的空间。这意味着:按频率 × 影响确定优先级。每行都必须获得其永久上下文成本。

第一阶段:调查项目

在编写任何内容之前,请先了解代码库。使用有针对性的调查——不要猜测。强制检查: 语言和框架 — ls 根,读取 package.json、pyproject.toml、Cargo.toml、go.mod、Gemfile、build.gradle、pom.xml 或等效的构建和开发命令 — 查找 Makefile、 justfile、Taskfile、CI 配置(.github/workflows/、.gitlab-ci.yml)、scripts/ 目录

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
Docker
运行环境要求
Python · Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段:调查项目

在编写任何内容之前,请先了解代码库。使用有针对性的调查——不要猜测。强制检查:语言和框架 - `ls`根,阅读`package.json`、`pyproject.toml`、`Cargo.toml`、`go.mod`、`Gemfile`、`build.gradle`、`pom.xml`或等效的构建和开发命令 - 查找`Makefile`、`justfile`、`Taskfile`、CI 配置(`.github/workflows/`、`.gitlab-ci.yml`)、`scripts/` 目录

02
第 2 阶段:起草 AGENTS.md

用命令性的、代理人主导的散文来写作。每条指令都应该是可操作的。有关 Rust、Python、TypeScript、Go 和 Java 项目的完整示例,请参阅`references/examples.md`。核心原则:具体、可操作。不要说“运行测试”——说`pnpm test --filter <package>`。不要说“遵循风格指南”,而要说“使用单引号,无分号,2 个空格缩进”。要包含的部分

03
第 3 阶段:验证命令

在提交草稿之前,请验证命令是否确实有效。这可以捕获过时的指令、错误的标志和丢失的设置步骤。对于 AGENTS.md 中的每个命令:尝试在项目目录中运行它(或空运行等效命令)如果失败,请调查原因 - 工具版本错误?缺少依赖?工作目录错误?修复命令或添加先决条件注释

04
第四阶段:审查和完善

验证后,根据以下条件检查文件: 每个命令都是可复制粘贴的。除非明确标记(如`<package-name>`),否则没有占位符。无明显间隙。如果项目有测试,就会有一个测试部分。如果它有 linter,就会有 lint 命令。没有绒毛。删除代理已经知道的任何内容(TypeScript 是什么,`npm install` 如何工作)。仅特定于项目的上下文。架构边界是明确的。如果模块有导入限制,请说明。

05
第 5 阶段:改进现有 AGENTS.md

当改进而不是从头开始创建时:首先读取现有文件。在更改任何内容之前先了解已有的内容。无论如何都要进行调查阶段。现有的 AGENTS.md 可能已经过时 - 将其内容与实际配置文件、CI 配置和项目结构进行比较。检查是否陈旧。查找:引用不再存在的工具或脚本的命令

06
第 6 阶段:Monorepos 的嵌套 AGENTS.md

嵌套文件对于上下文效率很重要 - 代理将最近的 AGENTS.md 加载到正在编辑的文件中。在包含 10 个包的 monorepo 中,单个根文件强制每个代理交互加载所有 10 个包的指令。嵌套文件将上下文范围限定为相关内容。根 — 工作区级命令、共享代码风格、跨包规则。保持它适用于任何地方。 Package——特定于包的构建/测试/lint,该包特有的约定。代理编辑`packages/web/`获取root + web,而不是api或共享的指令。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。