给AI编程代理的仓库操作手册:先看规则,再写代码
Reddit 上有人贴出一份 AGENTS.md 式的 Prompt,重点不在话术,而在把仓库导航、测试、PR 和验证规则写清楚。它适合当模板,不适合照抄。
Reddit 的 r/PromptEngineering 上,Ornery-Dark-5844 发了一份叫 Prompt Agente 的贴子。点开前以为是那种让模型“扮演资深工程师”的长提示词。看完发现,它更像一份给新加入项目的工程师看的操作手册,只是读者换成了 AI 编程代理。
全文分五块:开发环境、开发准则、测试、Pull Request、代理通用行为。技术栈指向很明确:pnpm workspace、Turbo、Vitest、GitHub Actions。比如找项目时先用 pnpm dlx turbo run where <project_name>,没有这个任务就按仓库已有方式导航;改 workspace 包之前看 package.json 的 name,不要拿根目录的名字去指代子包;装依赖用 pnpm install --filter <project_name>,新建 React + Vite 项目用 pnpm create vite@latest <project_name> -- --template react-ts。
这些命令本身不稀奇。有意思的是它反复强调的边界:先看仓库结构和配置,再动手;优先复用已有组件和工具;改动聚焦在任务本身;不要假设某个脚本、依赖、API 存在;不要编造命令;测试没跑成功,就不要说通过。测试部分还写了怎么从 .github/workflows 看 CI 要求,怎么用 pnpm turbo run test --filter=<project_name> 跑包级测试,怎么用 pnpm vitest run -t "<test name>" 跑单个用例。PR 标题要求写成 [<project_name>] <Title>,提交前跑 lint 和测试,最后说明改了什么、跑了哪些测试、还有什么没验证。
放在 Prompt Engineering 语境里,这份东西有点反常识。它没有角色设定,没有“你是一名顶级工程师”,也没有思维链表演。它把团队里那些默认规则写成了可执行约束。AI 代理犯的很多错,恰好来自这些默认规则没被写出来:猜包名、乱加依赖、改无关文件、把未执行的测试说成通过。
当然,这份 Prompt 不能直接复制到所有仓库。它绑定 pnpm、Turbo、Vitest 和特定 CI 流程,仓库没有对应任务时就得换成本地做法。它更像一个模板:把项目导航、包管理、测试入口、提交检查和失败汇报方式写清楚,让代理少靠猜。
原帖链接:https://www.reddit.com/r/PromptEngineering/comments/1y01xhx/prompt_agente/
如果团队已经在用编码代理,值得先做一件事:把仓库里那些口口相传的工程规则写下来。写清楚之后,提示词反而不用很花。
发布时间: 2026-11-19 13:54