AGENTS.md 交互式规则生成器
选择技术栈和项目边界,生成一份可编辑的
AGENTS.md草稿。复制到项目根目录前,请核对命令、路径和权限要求;文字规则仍需配合沙盒、代码审查与测试。
生成的 AGENTS.md 实时预览:
# 项目协作规则 (AGENTS.md)
## 📌 项目指纹
- **项目名称**:my-saas-mvp
- **目标架构**:Next.js (App Router) + TypeScript
- **使用前核对**:以下命令、路径和权限要求须按当前项目修改;文字规则不能代替沙盒与人工审查。
## 运行环境与权限建议
- 标准开发:先核对依赖安装、测试与构建命令;生产操作和凭据访问遵守实际权限配置。
## 工程协作规则
1. **🛑 防自旋死循环 (Anti-Loop)**:如果同一编译或测试错误在修改后重试 2 次仍未解决,停止修改并向开发者报告错误、尝试过的方法和下一步排查建议。
2. **🚫 防虚假伪造 (严禁占位符)**:严禁提交含有 `// TODO: 实现此逻辑`、`pass`、或虚构假数据的未完成函数,所有代码必须真实可编译。
3. **📦 防滥装依赖 (依赖守卫)**:常规逻辑优先使用原生标准库与内置 API,严禁未经确认私自安装体积庞大的未知第三方包。
4. **技术栈专有防御**: 所有组件默认优先为 React Server Component,仅在需要客户端交互时添加 "use client"
5. **技术栈专有防御**: 样式使用 Tailwind CSS,不得在组件中混入纯内联全局 style
6. **技术栈专有防御**: 环境变量严格区分 NEXT_PUBLIC_ 前缀,服务端敏感密钥严禁泄漏至客户端
## 🧪 验证标准 (Validation Specs)
智能体在每次阶段性修改完成后,先核对项目中是否存在下列命令,再执行适用的检查并记录退出状态:
```bash
# 1. 运行静态检查与单元测试
npm run lint && npm test
# 2. 验证生产构建
npm run build
```

