Skip to content

docs(agents): 8 份领域 sub-agent 文档 + CLAUDE.md 路由表 - #196

Merged
zeweihan merged 1 commit into
masterfrom
claude/sub-agent-docs-structure-a008ec
Jul 26, 2026
Merged

docs(agents): 8 份领域 sub-agent 文档 + CLAUDE.md 路由表#196
zeweihan merged 1 commit into
masterfrom
claude/sub-agent-docs-structure-a008ec

Conversation

@zeweihan

Copy link
Copy Markdown
Owner

目的

项目成熟后,每次布置任务都要全量扫描代码库,效率低。本 PR 按代码结构与用户体验逻辑把代码库划成 8 个领域,为每个领域建一份 sub-agent 文档(.claude/agents/,Claude Code 原生 sub-agent 格式,自动注册为可派遣 agent 类型),并在根目录 CLAUDE.md 建路由表:接任务先读对应领域文档,不再全量扫描。

8 个领域

文档 领域
ai-chat AI 对话编排(编排器/ToolRegistry/SSE 事件清单/记忆/评测)
ai-doc-bridge AI↔文档桥接(doc_* 原语全集/editor_command 双轨/修订/检查点)
doc-editor LOWA 编辑器(引擎构建/启动链路/zetajs 编组硬规则/自动保存守卫/保活 LRU)
utility-tools 辅助小工具(浏览器/截图/剪贴板/收藏/语音/OCR + preload IPC 通道清单 + 订阅守卫模式)
sidebar-shell 侧边栏与工作台外壳(project-overview.vue 万行文件内部行号地图/面板切换状态机/页面栈守卫)
plugin-system 插件系统(三类插件形态/skill 注入链路/启停过滤位置)
plugin-marketplace 插件市场(广场页/官网 registry 契约/安装卸载链路)
eng-infra 工程基建(CI workflow/发版链路/签名公证顺序/测试总表/本地启动配方)

每份统一模板:职责边界 → 关键文件地图(含大文件行号区间)→ 核心契约与数据流 → 已知地雷(历次 PR 沉淀)→ 验证命令。

制作方式

8 个并行 Explore agent 各自深读一个领域生成事实地图,再逐份与历史 PR 教训(zetajs 编组、IPC 重复订阅、EvalHarness 同步、CI 步骤顺序等)合并校订。

维护规则(已写进 CLAUDE.md)

相关 PR 若改变领域的文件布局/契约或新增地雷,同一 PR 顺手更新对应领域文档。

🤖 Generated with Claude Code

按代码结构与用户体验逻辑把代码库划成 8 个领域,每份文档含:
职责边界 / 关键文件地图(含大文件行号区间)/ 核心契约与数据流 /
历次 PR 沉淀的已知地雷 / 改动后必跑的验证命令。

- ai-chat: AI 对话编排(编排器/ToolRegistry/SSE/记忆/评测)
- ai-doc-bridge: AI↔文档桥接(doc_* 原语/editor_command/修订/检查点)
- doc-editor: LOWA 编辑器(引擎构建/boot/zetajs 编组/自动保存/保活)
- utility-tools: 辅助小工具(浏览器/截图/剪贴板/收藏/语音/OCR/IPC 模式)
- sidebar-shell: 侧边栏与工作台外壳(四列布局/面板切换/页面栈守卫)
- plugin-system: 插件系统(面板型/Skill 型/动态 JAR/注入链路/启停)
- plugin-marketplace: 插件市场(广场页/registry 契约/安装卸载)
- eng-infra: 工程基建(CI/发版/签名公证/测试总表/本地启动)

CLAUDE.md 提供任务→领域文档路由表与维护规则,接任务先读对应
文档、不再全量扫描代码库。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@zeweihan
zeweihan merged commit d0ec74f into master Jul 26, 2026
3 checks passed
zeweihan added a commit that referenced this pull request Jul 28, 2026
自 v0.8.0 累积 19 个 PR(#196#216)。升 minor 而非 patch 的理由:
在线插件分发链路本版首次真正可用(#202 安全模型 + #203 生产签名公钥),
插件广场提级到左栏并引入 Skill 三档生效方式(#198),属新增用户可见能力。

发版前回归(本 worktree 冷启动):
- backend mvn -B test:318 通过 / 0 失败 / 2 跳过(JDK 21)
- desktop npm test:14/14
- frontend check:emits:通过
- app-e2e:30/30(基线 29,#216 新增剪贴板面板一步)
- lowa-e2e:38/38(持平 v0.8.0 基线)

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
zeweihan added a commit that referenced this pull request Aug 27, 2026
- 未登录空态改品牌欢迎卡,替代一句红字(#192)
- 语言切换改地球 SVG 图标 + 目标语言缩写(#193)
- 账户菜单展示身份与 AI 额度,删「连接与高级设置」入口(#194)
- 历史与模型改常驻 pill,不再收进 + 二级菜单(#195)
- 项目下拉支持新建项目(POST /api/projects,BLANK 类型)(#196)
- 助手气泡轻量 Markdown 渲染 + 段间空行折叠 + 前导空白裁剪
  + 吸底守卫(距底 48px 内才跟随流式滚动)(#197)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant