AGENTS.md 生成器

把一个普通项目改造成 AI agent 能稳定协作的项目，第一步不是写提示词，而是写清楚项目规则、任务边界和验收标准。

先生成，再放进项目根目录

生成结果包含三份材料：AGENTS.md、Codex 任务卡、验收清单。新手先复制到练习项目，不要直接放进生产仓库。

Agent Coding Kit

生成一份能直接放进项目的 AGENTS.md

所有内容只在当前浏览器里生成，不上传。先用默认值跑一遍，再按你的项目改。

项目名称项目类型教程网站前端应用后端服务Python 数据项目知识管理项目开源仓库其他项目

技术栈主要目标

允许 agent 优先处理

文档页面样式测试和 QA小范围代码依赖配置发布文案草稿

禁止触碰不要读取或提交密钥、Cookie、账号截图、付款信息、生产数据库、私人目录。 不要修改 DNS、域名、备案、支付、登录权限。 不要删除用户未确认的文件。

检查命令提交前提醒改代码前先说明计划可直接改低风险文件每次写文件前都确认

补充说明优先保持页面可读、移动端可用、链接可验证。所有外部事实需要标注来源和复核日期。

查看生成结果

AGENTS.md

# AGENTS.md ## Project Context Codex 小白上手指南 是一个教程网站。 技术栈：VitePress, Markdown, Node.js 主要目标：帮助新手完成第一个安全可验证的 Codex 任务 ## How The Agent Should Work - 先读项目结构、README、当前任务相关文件，再提出修改计划。 - 改代码前先说明计划。 - 一次只做一个小任务，避免顺手重构无关代码。 - 修改后说明改了哪些文件、为什么改、怎么验证。 ## Allowed Work - 文档 - 页面样式 - QA 脚本 ## Do Not Touch - 不要读取或提交密钥、Cookie、账号截图、付款信息、生产数据库、私人目录。 - 不要修改 DNS、域名、备案、支付、登录权限。 - 不要删除用户未确认的文件。 ## Verification - 默认检查命令：`npm run qa` - 如果检查命令失败，先报告失败原因和最小修复方案。 - 如果无法运行检查，说明原因，并给出人工验收步骤。 - 交付前必须列出剩余风险。 ## Task Card Template - 目标： - 范围： - 不做： - 输入材料： - 完成标准： - 验收命令： ## Notes - 优先保持页面可读、移动端可用、链接可验证。所有外部事实需要标注来源和复核日期。

任务卡

# Codex Task Card 目标：帮助新手完成第一个安全可验证的 Codex 任务 项目：Codex 小白上手指南 范围： - 文档 - 页面样式 - QA 脚本 不做： - 不要读取或提交密钥、Cookie、账号截图、付款信息、生产数据库、私人目录。 - 不要修改 DNS、域名、备案、支付、登录权限。 - 不要删除用户未确认的文件。 执行方式： - 先读相关文件并说明计划。 - 只做最小必要修改。 - 修改后运行 `npm run qa`。 完成标准： - 输出文件列表和变更摘要。 - 检查命令通过，或明确说明无法运行的原因。 - 给出人工验收步骤和剩余风险。

验收清单

# 验收清单 - [ ] 改动范围符合任务卡，没有顺手改无关文件。 - [ ] 没有提交密钥、Cookie、账号截图、付款信息或私人目录。 - [ ] 核心页面在桌面和手机尺寸可读。 - [ ] 内部链接可打开，锚点可跳转。 - [ ] 已运行 `npm run qa`，并记录结果。 - [ ] 如果检查失败，已经说明失败原因和下一步。 - [ ] 最终回复包含文件列表、验证结果、剩余风险。

生成后怎么交付

把生成结果按下面三步落地：

1. 在项目根目录新建 AGENTS.md，复制第一块内容。
2. 每次让 Codex 做事前，复制“任务卡”，把目标和范围补完整。
3. Codex 改完后，用“验收清单”逐项检查，再决定是否接受结果。

什么项目最适合先试

先选低风险项目：

• README、教程、个人博客、演示仓库。
• 没有密钥、客户资料、生产数据库的练习目录。
• 可以用 Git 或复制文件夹方式撤回。

暂时不要选：

• 线上生产系统。
• 包含 .env、私钥、客户数据、交易账户、支付后台的目录。
• 你自己还看不懂结构的大仓库。

完成标准

完成后，你应该拿到：

• 一份能放到项目根目录的 AGENTS.md。
• 一张能复制给 Codex 的任务卡。
• 一份改完后能照着验收的清单。
• 一个低风险练习项目，而不是直接让 agent 操作生产项目。

下一步

生成 AGENTS.md 后，继续读：

• AGENTS.md 写给 agent
• Agent Harness 是什么
• 哪些目录可以让 Codex 碰
• 怎么看 diff 和验证

来源与复核

• 本页是本站的产品化工具，不是 OpenAI 官方功能。
• AGENTS.md 的具体格式会随不同 agent 工具变化，本页采用“项目背景、允许范围、禁止范围、验收方式”的通用结构。
• 最后复核：2026-06-09。