From 54f0b75646c903e498a9b59156430d85a5d141b8 Mon Sep 17 00:00:00 2001
From: Aska <Aska@cyrene.local>
Date: Sun, 6 Sep 2026 16:07:11 +0800
Subject: [PATCH] =?UTF-8?q?docs(AGENTS):=20=E6=96=B0=E5=A2=9E=20=C2=A79.5?=
 =?UTF-8?q?=20=E5=AD=A6=E4=B9=A0=E6=88=90=E7=86=9F=E5=BC=80=E6=BA=90?=
 =?UTF-8?q?=E5=AE=9E=E7=8E=B0/=E7=A6=81=E6=AD=A2=E9=97=AD=E9=97=A8?=
 =?UTF-8?q?=E9=80=A0=E8=BD=A6=E9=93=81=E5=BE=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

已成熟能力/模块必须优先学习并复用现有开源项目业务逻辑（OpenClaw/Claude Code/MCP SDK/
Swarm/CrewAI/OneBot/Miuix 等），严禁凭空推演。每个 design 主题实现前先查开源对照清单
(DevDocs/开源对照清单.md)，未对照不得开工。上下文压缩后本铁律强制生效。
---
 AGENTS.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 9807a6a..58d3233 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -47,6 +47,19 @@
 - **敏感操作主代理代审 + 审计日志 + 前端小字**（「xxx 想要干什么，我审查后批准了」）。
 - **模型**：per-role 路由 + 接口报错自动降级（主→备→本地）；多模态/流式。
 
+## 9.5 学习成熟开源实现，禁止闭门造车（⚠️ 用户强制红线）
+- **已成熟的能力/模块，必须优先学习并复用现有开源项目的业务逻辑与交互范式**，**严禁闭门造车/按设计文档凭空推演**。对照基准（按 design 主题）：
+  - **agent 工具循环 / 工具分发** → Claude Code、OpenClaw、Cursor（工具 schema、循环上限、权限门、流式输出）
+  - **子代理编排 / 隔离上下文 / 审计代审** → Claude Code 的 subagent、OpenAI Swarm、CrewAI
+  - **MCP** → **官方 Model Context Protocol SDK**（Go/Python/TS 客户端接入、工具自动发现）
+  - **WS 实时协议 / 流式 token** → OpenAI/Anthropic 官方 SDK 的流式惯例、Claude Code 的实时事件
+  - **checkpoint 恢复 / 长任务持久化** → Claude Code 的 resume / Cursor 的会话恢复
+  - **跨平台渠道接入（QQ/微信/Telegram）** → OneBot v11、Telegram Bot API、微信 iLink 既有客户端
+  - **管理面板 / 前端交互** → Miuix Console（本项目设计基准）、以及成熟 admin 面板范式
+- **实现前**：先在该主题的 design 文档下**补一行「开源对照」**——列出参考项目 + 借鉴点（模板：`## 开源对照（实现前必读）`）。实现时逐点对齐其成熟逻辑。
+- 若某个能力**已有成熟开源实现**而项目选择了自研，必须**写明理由**（如协议差异、单二进制约束），不得默认自研。
+- 上下文压缩后：**本铁律强制生效**；每个模块补全前**先查 `DevDocs/开源对照清单.md`**（集中记录各主题的参考项目与已完成对照），未对照不得开工。
+
 ## 10. 代码与流程硬性规范（压缩后仍需遵守）
 - 🔴 **文件 ≤500 行、函数 ≤80 行**；**模块按职责拆成多个源文件，严禁把整个模块塞进一个超大文件**；**三次复制必须抽取**共享。
 - 🔴 禁 `interface{}`（用 `any`）、禁包级全局变量（除 `var ErrXxx`）、禁裸 `return err`、禁魔法数字；错误一律 `%w` wrap；SQL 全参数化、表名单数、主键 `id`、时间戳 `created_at/updated_at`、索引 `idx_{table}_{col}`；敏感信息打日志。