From 536f406b733baac3c8480959590e22792143d723 Mon Sep 17 00:00:00 2001
From: WangDL <wangdl2900@163.com>
Date: Wed, 20 May 2026 10:58:19 +0800
Subject: [PATCH] docs: add AI Backend workspace template and For AI Agents
 section to README

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 AI_BACKEND_WORKSPACE.md | 75 +++++++++++++++++++++++++++++++++++++++++
 README.md               | 25 +++++++++++++-
 2 files changed, 99 insertions(+), 1 deletion(-)
 create mode 100644 AI_BACKEND_WORKSPACE.md

diff --git a/AI_BACKEND_WORKSPACE.md b/AI_BACKEND_WORKSPACE.md
new file mode 100644
index 0000000..e067108
--- /dev/null
+++ b/AI_BACKEND_WORKSPACE.md
@@ -0,0 +1,75 @@
+# AI Backend 工作台
+
+> Backend Agent 维护。仅中/大任务填写，小任务在对话中直接反馈。提交后清空。
+
+---
+
+## 当前任务
+
+（待填写）
+
+---
+
+## 已确认范围
+
+（待填写）
+
+---
+
+## 本次修改
+
+（待填写）
+
+---
+
+## 修改文件
+
+| 文件 | 变更 | 说明 |
+|------|------|------|
+| — | — | — |
+
+---
+
+## 接口变更记录
+
+| 方法 | 路径 | 说明 | 请求体 | 响应体 |
+|------|------|------|--------|--------|
+| — | — | — | — | — |
+
+---
+
+## 本地测试方式
+
+```
+（测试命令、预期结果）
+```
+
+---
+
+## 阻塞项
+
+（待填写）
+
+---
+
+## 需要 Global Agent 决策
+
+（待填写）
+
+---
+
+## 需要其他 Agent 支持
+
+- 需要前端适配：xxx
+- 需要 iOS 适配：xxx
+
+---
+
+## 是否建议进入 Review
+
+- [ ] 是
+- [ ] 否，有阻塞
+
+---
+
+## 提交后清空
diff --git a/README.md b/README.md
index 14de2d4..5a86bdf 100644
--- a/README.md
+++ b/README.md
@@ -205,4 +205,27 @@ src/
 - [ ] 更多 AI Workflow（知识导入、费曼分析、复习卡片生成）
 - [ ] AI 联调 + Prompt 调优
 - [ ] 添加 Redis 缓存
-- [ ] iOS 集成
\ No newline at end of file
+- [ ] iOS 集成
+
+---
+
+## For AI Agents
+
+### 负责 Agent
+
+Backend Agent（`@backend-agent`），配置在 `.claude/agents/backend-agent.md`。
+
+### 关键规则
+
+- 接口变更必须更新 Swagger 装饰器
+- 不能私自新增未确认的接口/字段/数据库表
+- 数据库变更必须经 Global Agent + 用户确认
+
+### 工作台
+
+`api-server/AI_BACKEND_WORKSPACE.md` — 仅跨模块多 Agent 任务时填写，小任务跳过。
+
+### 禁止
+
+- 不能修改 ios-projects、web-projects
+- 不能修改服务器 Nginx/Docker 配置（DevOps Agent 职责）
\ No newline at end of file