跳到内容
DevLab

AGENTS.md / CLAUDE.md 生成器 — 20+ 模板

从 20+ 个实用模板 (Next.js / React / Vue / Django / FastAPI / Rails / Laravel / Go / Rust 等) 一键生成 Claude Code / Codex / Cursor / Windsurf / Gemini / GitHub Copilot 的项目配置文件。支持全部 6 种格式：AGENTS.md / CLAUDE.md / .cursor/rules/main.mdc / .windsurfrules / GEMINI.md / copilot-instructions.md，支持批量 zip 下载。

完全免费 无需注册 浏览器内完成 即刻下载 5 种语言 深色模式
通用 Markdown: Markdown 文件创建 →
▶ 📦 选模板一键生成
▶ 🎛 运营规则包 0 / 28

添加AI代理的实务行为规则，例如「在接触生产环境前获得许可」「必须提示出处」「记录进展」等，通过ON/OFF开关进行配置。这些内容将被追加到输出文件的相应部分。

📚 模板目录

显示全部 24 个模板
Next.js 15 (App Router + TypeScript + Prisma)
Next.js + Pages Router (legacy)
React + Vite + TypeScript
Vue 3 + Vite + TypeScript
Nuxt 3 (full-stack)
SvelteKit + TypeScript
Astro (content-focused)
Express.js + TypeScript (REST API)
NestJS (modular API)
FastAPI (Python async API)
Django (Python full-stack)
Flask (Python micro)
Ruby on Rails 7
Laravel 11 (PHP)
Slim 4 + Twig (PHP, this site!)
Go + chi (HTTP API)
Rust + Axum (web)
Rust CLI + clap
React Native (Expo + TypeScript)
Flutter (Dart)
Browser Extension (MV3 + TypeScript)
npm Library (TS + tsup + vitest)
CLI Tool (Node + Commander)
Monorepo (Turborepo + pnpm)

📄 生成的文件

格式: | 语言:
⬇
AGENTS.md 

    


    

        
📍 放置位置

        
    
            
  • AGENTS.md / CLAUDE.md / GEMINI.md → 仓库根
    • 
            
  • Cursor → .cursor/rules/main.mdc
    • 
            
  • Windsurf → .windsurfrules (root)
    • 
            
  • Copilot → .github/copilot-instructions.md
    • 
        

    






    
📖 常见的坑


        
从 20 多套模板生成面向 Claude Code / Codex / Cursor / Windsurf / Gemini / GitHub Copilot 的项目配置文件，支持 AGENTS.md / CLAUDE.md / .cursor/rules/main.mdc / .windsurfrules / GEMINI.md / copilot-instructions.md 六种格式，可打包为 zip 一次下载。处理全部在浏览器内完成。但模板并不了解你的仓库——而一份写错了的指令文件，其结果比没有更糟。智能体会毫不怀疑地照做，于是与事实不符的描述会原样变成错误的实现返回给你。

    
        

        

            
                

                    情形
                    会发生什么
                    怎么处理
                

            
            
                                

                    原样保留模板，就等于在下达不实的指令
                    生成出来的骨架里，含有对你的项目而言并不正确的具体表述——写着用 npm test 跑测试，实际却在用 pnpm；写着并不存在的目录结构；罗列着你根本没用的库的约定。智能体会把指令文件看得比代码更可信——于是它反复尝试那条「写着却跑不通」的命令，把文件建到并不存在的位置。另一种浪费是「写下读代码就能知道的事」——所用框架、文件夹名称，智能体几秒钟就能自己查到。在这些地方花掉的字数越多，真正重要的信息就被冲得越淡。
                    该写的只有「读代码也看不出来的东西」。具体来说：真正能跑的命令（测试、构建、部署、lint 的精确那一行）、过去踩过的坑及其原因、不能碰的地方及其原因、在多种做法中本项目选择了哪一种方针。写清楚「为什么」价值最高——知道了理由，在你没写到的场合也能做出同样的判断。就做法而言，与其从模板出发，不如从空白文件写十行，成品反而更好。而最可靠的验证，是真的让智能体做一次活儿，看它是否照指令行事——每踩一次坑就补一行，这才是现实的养成方式。
                

                                

                    六种格式全都输出，然后全都各走各的
                    每种工具读取的文件不同，因此同时使用多种工具的团队，最终会把同样的内容放在好几个地方。问题在于这些副本必然会各走各的——有人只更新了 CLAUDE.md，而 .cursor/rules 还停留在三个月前，于是用哪种工具，智能体的行为就不一样。更糟的是，没有任何机制能告诉你它们已经分叉了——两边在语法上都正确，CI 也照样通过。加载方式的差异也需要了解：有的每次都读全文，有的按请求只取一部分，有的只看仓库根目录，有的连子目录里的也读，这种差异会以「不知为何只有这个工具无视指令」的形式浮现。
                    请确定唯一的正本。实务上比较好用的形态是以 AGENTS.md 为正本，其他格式只做成指向它的简短文件——把 CLAUDE.md 的内容缩成「请阅读 AGENTS.md」一行，双重维护就消失了（工具若支持，用符号链接也可以）。没必要把所有格式都输出——只放你实际在用的那些工具的。而且正本请放在仓库根目录，并务必纳入 Git 管理——放进个人配置目录，它对团队其他成员来说就是一条并不存在的规则。让它进入评审范围，别人才有可能核对其内容是否仍与事实相符。
                

                                

                    写得越长，反而越不起作用
                    指令文件会在每一次请求中消耗上下文——放五百行规则，就等于少了五百行读真实代码的余地。而且越长越容易自相矛盾：「优先最简单的实现」与「务必抽象」出现在同一个文件里，哪一条会被采纳是无法预测的。另一个常见毛病是把愿望写了进去——文件里写着「必须写测试」，仓库里却一个测试都没有，这种状态非常常见。这种矛盾会让智能体无所适从——因为它无法决定该照既有代码还是照规则。而一条明显没人遵守的规则，会连带拉低其他规则的可信度。
                    请写得短、写得具体、写成可核验的形式。作为参考，先从一屏能装下的长度开始，只有出了问题才补一行——一上来就想写全，必然堆出一堆用不上的行。优先写那些「能确认是否被遵守」的规则：「写可读的代码」无法核验，而「不要改动 src/legacy/」可以。并且请删掉仓库实际上并未遵守的规则——想写理想，就先把代码做到那个状态，再写下来。定期复查也不可少：构建命令变了而文件没变，智能体每一次都会卡在那里——改命令时，请在同一个提交里把这个文件也改掉。
                

                            
        

    

    
        
这类文件请按「可能被外部读到」来写。公开仓库谁都能读，即便是私有仓库，一旦交给智能体，它就已经被传送给模型提供方了——不要写内部系统的主机名、认证机制，以及尚未公开的计划。另外还有一条值得点明的安全性质：指令文件是「改变智能体行为的输入」——第三方通过 PR 往这个文件里加一行，就能左右此后智能体的行动。在会合并外部 PR 的仓库里，请务必把这六类文件的差分纳入评审——因为它们比代码改动更不显眼，影响面却更广。最后说一点运维：这个文件不是写完就完事，而是在智能体重复同一个错误时才去更新的东西。当你察觉「怎么老是在提同一条意见」时，那条意见就是该写进这个文件的一行。

    









    
📖 使用方法

    
    
                
  1. 
            1
            
    
                
    选模板
    
                
    从 20+ 预设中点击最相近的
    
            
    
        
    2. 
                
  2. 
            2
            
    
                
    需要时微调
    
                
    打开"自定义编辑"添加项目特定规则
    
            
    
        
    3. 
                
  3. 
            3
            
    
                
    选择格式并下载
    
                
    单独或 zip 打包
    
            
    
        
    4. 
            






    
❓ 常见问题

    

                

            
                AGENTS.md 与 CLAUDE.md 区别？
                
            
            
AGENTS.md 跨厂商标准；CLAUDE.md 专用 Claude Code

        

                

            
                Cursor MDC 是什么？
                
            
            
.mdc + glob 激活

        

                

            
                模板缺少？
                
            
            
选模板后打开"自定义编辑"覆盖

        

                

            
                安全？
                
            
            
完全在浏览器内运行

        

            







    

        
            🐛 此工具出现问题了吗？
            
        

        

            免费、无需注册。仅提供复现步骤也有帮助。报告将直接发送给运营者并用于改进。
        


        

                        

            

                
                
            


            

                
                
                

                    ※ 为复现问题,浏览器信息 (UA / 屏幕 / 语言 / URL) 将自动发送