docs(AGENTS): 新增 §9.5 学习成熟开源实现/禁止闭门造车铁律
已成熟能力/模块必须优先学习并复用现有开源项目业务逻辑(OpenClaw/Claude Code/MCP SDK/ Swarm/CrewAI/OneBot/Miuix 等),严禁凭空推演。每个 design 主题实现前先查开源对照清单 (DevDocs/开源对照清单.md),未对照不得开工。上下文压缩后本铁律强制生效。
This commit is contained in:
1 parent
eddb9b9891
commit
54f0b75646
1 file changed
+13
@@ -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}`;敏感信息打日志。
|
||||
|
||||
Reference in new issue
Block a user