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}`;敏感信息打日志。