docs(agents): 将 API 参考文档纳入开发规范

- AGENTS.md：新增 Controller/Service 前必读 API_REFERENCE.md
- AGENTS.md：接口规范补充「新增接口前查阅文档」和「废弃接口处理」
- cfc-backend/AGENTS.md：新增接口前三步检查流程（复用→修改→新增）
- 废弃接口统一标记 410 + @Deprecated

AGENTS.md

@@ -23,9 +23,10 @@
 
 ### 新增 Controller/Service 前必做
 
-1. `mvn clean compile` — 验证无编译冲突
-2. 检查路由重复：`grep -rn '@Mapping' cfc-backend/src/.../controller/ | grep -oP '@\w+Mapping\("\K[^"]*' | sort -u`
-3. 检查 Bean 命名冲突：Spring 默认 Bean Name 为类名首字母小写，不同包的同名类会冲突
+1. **查阅接口文档**：先看 `docs/superpowers/api/API_REFERENCE.md`，确认是否已有可复用或可修改的接口
+2. `mvn clean compile` — 验证无编译冲突
+3. 检查路由重复：`grep -rn '@Mapping' cfc-backend/src/.../controller/ | grep -oP '@\w+Mapping\("\K[^"]*' | sort -u`
+4. 检查 Bean 命名冲突：Spring 默认 Bean Name 为类名首字母小写，不同包的同名类会冲突
 
 ## 项目结构