---
title: "仓库 AGENTS.md"
filename: "AGENTS.md"
canonical: /templates/agents-md/
---

# 仓库 AGENTS.md

短、可验证、带禁止事项。按你们真实的命令改，不要直接提交脚手架。

```
# AGENTS.md

## 仓库地图
- `src/` 应用代码
- `tests/` 集成测试；单测挨着实现文件
- `infra/` 不要在功能任务里改

## 命令
- 安装：`pnpm install`
- 类型检查：`pnpm typecheck`
- 单测：`pnpm test`
- lint：`pnpm lint`

## 约定
- 公共 API 变更必须更新 `docs/` 和调用方
- 优先最小 diff；不要顺手重构
- 包管理器只用 pnpm

## 禁止
- 不要改生成的迁移，除非任务就是迁移
- 不要提交密钥、`.env`、`auth.json`
- 实现任务中不要改测试来迁就实现

## 完成定义
- 相关测试通过
- typecheck 与 lint 干净
- 用中文写清为什么这样改

```