Skip to content

project-capability-atlas.mdx

Latest commit

 

History

History
142 lines (115 loc) · 7.6 KB

project-capability-atlas.mdx

File metadata and controls

142 lines (115 loc) · 7.6 KB
Raw
title Claude Code 能力图谱 - 当前仓库的真实热路径、扩展层与社区核验
description 面向逆向研究者的 Claude Code 能力图谱。基于当前仓库源码梳理真实执行热路径、工具/命令/skills/MCP 扩展结构、feature gate 分层和社区共识核验。
keywords
Claude Code
reverse engineering
能力图谱
skills
MCP
hooks
query loop

三条先给结论

  • 当前仓库的核心不是某个单独聊天循环，而是 启动装配 + query loop + 工具池 + 命令/skills + MCP + control plane 的组合平台。
  • 在 external build 里，feature() => false 是最重要的阅读前提；它决定了哪些分支只是“树上存在”，哪些才是“当前会跑”。
  • 社区对 Claude Code 的高频判断里，关于“组合能力”“MCP 复杂度”“hooks 粒度不足”“CLAUDE.md 是信任边界”的几条，在当前源码中都有直接旁证。
完整研究稿位于 `docs/analysis/2026-04-02-claude-code-capability-atlas.md`。这个页面保留同样的结论，但更偏图谱式阅读。

顶部摘要区

研究问题 回答
这是什么仓库？ 一个 Bun-first、反编译重建的 Claude Code CLI 平台工程，不是官方源码镜像。
真正的热路径是什么？ `cli.tsx -> main.tsx -> (REPL
最值得研究的地方在哪里？ 工具池、commands/skills、MCP、hooks、AppState 控制平面，而不只是单个 API client。

核心图谱区

图示：Claude Code 能力全景图（SVG）

flowchart LR
  cli["src/entrypoints/cli.tsx<br/>feature() => false"] --> main["src/main.tsx"]
  main -->|interactive| repl["REPL.tsx"]
  main -->|--print| headless["cli/print.ts"]
  repl --> query["query.ts"]
  headless --> engine["QueryEngine.ts"]
  engine --> query
  query --> tools["tools.ts"]
  tools --> mcp["mcp/client.ts"]
Loading

这张热路径图背后的源码锚点是：

  • src/entrypoints/cli.tsx:3-18
  • src/main.tsx:2584-2845
  • src/main.tsx:3134-3146
  • src/QueryEngine.ts:178-214
  • src/screens/REPL.tsx:2797-2805

模块地图区

图示：Claude Code 能力矩阵图（SVG）

flowchart TD
  Builtins["COMMANDS()"] --> Commands["getCommands()"]
  Bundled["bundled skills"] --> Commands
  Local[".claude/skills/"] --> Commands
  Plugins["plugins"] --> Commands
  MCPPrompts["MCP prompt commands"] --> Commands

  Base["getAllBaseTools()"] --> Pool["assembleToolPool()"]
  MCPTools["MCP tools"] --> Pool

  FileOps["file ops"] --> Dynamic["discover / activate dynamic skills"]
  Dynamic --> Commands
Loading

为什么说扩展层是主产品面

  • src/tools.ts 不只是列工具，而是同时处理 preset、deny rules、REPL mode、MCP 合并与排序稳定性。
  • src/commands.ts 不只是 slash commands，而是 built-ins、bundled skills、plugin skills、workflow commands、dynamic skills 的汇合点。
  • src/skills/loadSkillsDir.ts 把 Markdown prompt workflow 升格为一等命令对象，并支持 frontmatter、路径条件、动态发现与 fork 执行。
  • src/services/mcp/client.ts 展示了 MCP 并不是“接个 HTTP server”这么简单，而是 transport、auth、timeout、session ingress、能力截断、IDE 特例等一整层集成逻辑。

风险与偏差区

flowchart TD
  Tree["Source tree"] --> Gate["feature() => false"]
  Gate -->|hot path| Active["external build active path"]
  Gate -->|dormant| Hidden["dormant feature branches"]
  Active --> Runtime["runtime gates / permissions / env"]
  Runtime --> Surface["public surfaces"]
  Runtime --> Ant["ant-only branches"]
  Tree --> Stubs["stubs / removed modules"]
Loading
当前仓库最容易被误读的地方，是把树上存在的 `feature(...)` 分支、`USER_TYPE === 'ant'` 内部能力和 stub 包，直接当作当前 external build 的活跃能力。`src/entrypoints/cli.tsx` 里的 `feature() => false` 使这种误读尤其昂贵。 本地 `AGENTS.md` 仍把构建描述成单文件产物，并写着“没有 test runner / linter”。但 `build.ts` 已经使用 `splitting: true`，`package.json` 也定义了 `test`、`lint`、`format` 等脚本。对于当前工程现实，`build.ts + package.json + docs/` 的权威性已经高于本地 onboarding 文档。 `src/state/AppStateStore.ts` 把 task、MCP、plugin、fileHistory、attribution、sessionHooks、remote bridge、computer-use、REPL VM context 等状态收在一个会话级控制平面里。很多“UI 问题”或“工具问题”的根因，其实在共享状态同步上。

社区核验区

图示：Claude Code 社区观点核验图（SVG）

社区共识 Verdict 当前仓库里的证据
Claude Code 的壁垒来自组合能力而非单功能 源码证实 工具、命令、skills、MCP、hooks、state 全都不是配角。
hooks 很有用，但还不够细 部分成立 / 依赖上下文 仓库里 hooks 很深，社区 issue 仍在要更细 lifecycle。
MCP 是最强扩展面，也是最脆的一面 源码证实 mcp/client.ts 的复杂度与 issue 热点一致。
sub-agents 生产力高，但边界仍粗糙 部分成立 / 依赖上下文 官方公开支持，社区仍反馈 session/stop/identity 边缘行为。
CLAUDE.md 既提高效率，也构成信任边界 源码证实 trust、memory、settings、print mode 都把它视为强输入。

结语与延伸阅读

这个仓库最值得研究的不是“模型怎么回消息”，而是“会话如何组织能力”。 建议按 `cli.tsx -> main.tsx -> query.ts -> QueryEngine.ts -> tools.ts -> commands.ts -> loadSkillsDir.ts -> mcp/client.ts -> AppStateStore.ts -> REPL.tsx` 进入。 继续看 `query.ts` 的 agentic loop 状态机。 继续看 feature gate、GrowthBook 与 ant-only 的层次关系。

主要外部参考