AGENTS.md项目指令实战让Tau Coding Agent秒懂你的代码库的完整指南【免费下载链接】tauA Python port of Pi’s minimalist coding agent.项目地址: https://gitcode.com/gh_mirrors/tau16/tau你是否受够了每次打开会话都要重复解释项目规范Tau是一款运行在终端里的 Python 编码 AgentCoding Agent它有一个杀手级特性只要你在项目里放一个AGENTS.md文件Agent 就会自动读懂你的代码库约定——测试怎么跑、代码风格是什么、哪些坑绝对不能踩从此每轮对话都默认生效。一、AGENTS.md 是什么为什么 Coding Agent 离不开它简单说AGENTS.md 就是你写给 AI 编程助手的项目说明书。它解决一个真实痛点AI Agent 每次新会话都是失忆的。你上周告诉它的这个项目用 uv 管理依赖、测试必须跑uv run pytest下次它又忘了。AGENTS.md 把这些长期有效的指令沉淀成文件Tau 会自动发现它并在每一轮对话时注入系统提示词——相当于 Agent 随身携带一本项目手册。适合写进 AGENTS.md 的内容 如何运行测试、lint、构建、格式化 项目约定代码风格、提交信息格式、分支命名️ 架构说明和坑点备注 永远要做的 X / 永远不要做的 Y 规则关键原则保持精简。AGENTS.md 的每一行都会占用每一轮对话的提示词预算写得越少越准效果越好。二、Tau 从哪里找 AGENTS.md自动发现规则详解Tau 会按固定顺序扫描指令文件找到就自动加载零配置优先级位置适用场景1️⃣~/.tau/AGENTS.md、~/.agents/AGENTS.md个人全局指令所有项目通用2️⃣项目根目录的AGENTS.md团队共享的项目规则提交到仓库3️⃣根目录到当前目录之间各层的AGENTS.md大型仓库按模块划分规则4️⃣当前目录的.tau/AGENTS.md、.agents/AGENTS.md只对当前工作区生效的窄范围规则项目根目录怎么判定Tau 会从当前目录向上找直到遇到.git、pyproject.toml、uv.lock、setup.py或package.json这类标记文件为止。这种分层设计非常灵活个人偏好放~/.tau/团队规范放仓库根目录某个子模块的特殊要求就放在该子目录里——各管一段互不干扰。安全提示出于安全考虑Tau 加载项目内的受保护文件前会先做一次项目信任判定首次打开项目时会询问你是否信任该目录决策记录在~/.tau/trust.json。详见项目信任指南。三、实战示范Tau 自己用的 AGENTS.md 长什么样最好的教材就是 Tau 仓库根目录的 AGENTS.md——它本身就是一个教科书级的范例结构清晰、重点突出项目定位一句话说明 Tau 是 Pi 极简编码 Agent 架构的 Python 实现架构原则明确三层分包边界——tau_ai模型流式层、tau_agent可移植的 Agent 核心、tau_codingCLI 应用层并要求核心包不依赖 UI 层开发工作流小步文档化推进、改动前先写测试、统一用uv运行命令、提交保持原子性Python 规范核心消息/事件用带类型的数据类、异步边界显式化、测试使用 fake provider 保证确定性文档要求每个重要阶段都必须在dev-notes/留下对新手友好的说明这套写法值得照抄不写废话只写 Agent 不猜出来的东西。四、一键重载改完 AGENTS.md 后如何生效如果你在 TUI 会话打开期间修改了 AGENTS.md输入一条斜杠命令即可让新规则对后续轮次生效/reload它会在不破坏会话历史的前提下刷新 skills、提示词模板和项目上下文文件。配合/context命令还能随时查看当前会话实际加载了哪些指令文件。相关实现位于上下文发现模块和系统提示词组装逻辑。五、总结三步让 Coding Agent 融入你的代码库✅第一步在项目根目录新建AGENTS.md写下测试命令、代码规范和红线规则保持一页以内✅第二步个人通用习惯放到~/.tau/AGENTS.md子目录特殊要求就近放置✅第三步修改后执行/reload用/context确认加载成功从此以后Tau 每次接手任务都自带项目记忆你的编码体验会直接提升一个档次。延伸阅读项目指令官方指南、上下文发现阶段设计文档【免费下载链接】tauA Python port of Pi’s minimalist coding agent.项目地址: https://gitcode.com/gh_mirrors/tau16/tau创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考