第 50 卷

项目级 AGENTS.md + 用户级 AGENTS.md叠加生效个人习惯 + 当前项目规则

如何写 AGENTS.md

可以直接交给AI来写，让AI总结这个项目的核心内容制作成 AGENTS.md

# AGENTS.md

## 项目说明

这是一个前端网页项目，用于构建产品页面、工具页面或个人作品展示页面。

## 技术栈

• React
• Vite
• Tailwind CSS
• JavaScript / TypeScript

## 常用命令

• 安装依赖：`npm install`
• 启动项目：`npm run dev`
• 构建项目：`npm run build`

## 项目结构

• `src/`：主要源代码
• `src/components/`：通用组件
• `src/pages/`：页面文件
• `src/assets/`：图片、图标等静态资源
• `public/`：公开静态文件

## 代码规范

• 优先使用 React 函数组件
• 优先使用 Tailwind CSS 写样式
• 不要引入 Bootstrap
• 不要大范围重构无关代码
• 修改时保持文件结构清晰
• 中文文案要自然、简洁、适合普通用户阅读

## UI 规则

• 不要过度渐变、阴影和 AI 模板感
• 优先做真实产品感，而不是 Demo 感

## 禁止事项

• 不要修改 `.env`、`.env.local`
• 不要输出 API Key、token、密码
• 不要删除已有核心功能
• 不要随意新增大型依赖
• 不要直接改动和当前任务无关的文件

## 完成任务后

每次修改完成后，请输出：

1. 修改了哪些文件
2. 每个文件改了什么
3. 为什么这样改
4. 是否需要运行 `npm run build`
5. 提醒我检查 diff

好的 AGENTS.md 有什么特点

特点说明