diff --git a/README.md b/README.md index d8a56df..31d111c 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ## Quick Links -- PDF 下载 / PDF Report: [claude-code-deep-dive-xelatex.pdf](./claude-code-deep-dive-xelatex.pdf) +- PDF 下载 / PDF Report: [ai-agent-deep-dive-report.pdf](./ai-agent-deep-dive-report.pdf) ## Notes @@ -21,10 +21,10 @@ 1. 研究范围与结论总览 2. 源码结构全景:它为什么更像 Agent Operating System -3. 系统提示词总装:`prompts.ts` 的真实地位 +3. 系统提示词总装:提示词系统的真实地位 4. Prompt 全量提取与模块级拆解 5. Agent Prompt 与 built-in agents 深挖 -6. Agent 调度链深挖:从 AgentTool 到 runAgent 再到 query +6. Agent 调度链深挖:从调度器到运行时主循环 7. Skills / Plugins / Hooks / MCP 生态深挖 8. 权限、Hook、工具执行链深挖 9. 为什么 Claude Code 这么强:从源码看它真正的护城河 @@ -51,22 +51,11 @@ 本次研究重点关注了以下核心文件和模块: -1. 主系统提示词核心文件: - - `src/constants/prompts.ts` -2. Agent Tool Prompt 核心文件: - - `src/tools/AgentTool/prompt.ts` -3. Skill Tool Prompt 核心文件: - - `src/tools/SkillTool/prompt.ts` -4. Agent 调度核心文件至少包括: - - `src/tools/AgentTool/AgentTool.tsx` - - `src/tools/AgentTool/runAgent.ts` -5. 工具执行链核心文件至少包括: - - `src/services/tools/toolExecution.ts` - - `src/services/tools/toolHooks.ts` +1. 主系统提示词、Agent 编排、Skill 调用、工具执行链与权限治理相关模块 ## 1.3 先给最重要的总判断 -Claude Code 的强,不是来自某个“神秘 system prompt”,而是来自一个完整的软件工程系统: +这类成熟 Coding Agent 产品的强,不是来自某个“神秘 system prompt”,而是来自一个完整的软件工程系统: - Prompt 不是静态文本,而是模块化 runtime assembly - Tool 不是直接裸调,而是走 permission / hook / analytics / MCP-aware execution pipeline @@ -77,7 +66,7 @@ Claude Code 的强,不是来自某个“神秘 system prompt”,而是来自 一句话总结: -> Claude Code 的价值,不是一段 prompt,而是一整套把 prompt、tool、permission、agent、skill、plugin、hook、MCP、cache 和产品体验统一起来的 Agent Operating System。 +> 这类成熟 Agent 产品的价值,不是一段 prompt,而是一整套把 prompt、tool、permission、agent、skill、plugin、hook、MCP、cache 和产品体验统一起来的 Agent Operating System。 --- @@ -85,7 +74,7 @@ Claude Code 的强,不是来自某个“神秘 system prompt”,而是来自 ## 2.1 顶层结构暴露出的系统复杂度 -从相关目录结构看,Claude Code 至少有这些重要模块: +从相关产品结构看,这类成熟 Coding Agent 至少会包含这些重要模块: - `src/entrypoints/`:入口层 - `src/constants/`:prompt、系统常量、风险提示、输出规范 @@ -165,7 +154,7 @@ Claude Code 的强,不是来自某个“神秘 system prompt”,而是来自 --- -# 3. 系统提示词总装:`prompts.ts` 的真实地位 +# 3. 系统提示词总装:提示词系统的真实地位 ## 3.1 真正的主入口:`src/constants/prompts.ts` @@ -183,7 +172,7 @@ Claude Code 的强,不是来自某个“神秘 system prompt”,而是来自 - function result clearing 提示注入 - brief / proactive / token budget 等 feature-gated section 注入 -Claude Code 的 prompt 不是静态字符串,而是一个 **system prompt assembly architecture**。 +这类成熟 Agent 产品的 prompt 往往不是静态字符串,而是一个 **system prompt assembly architecture**。 ## 3.2 `getSystemPrompt()` 不是文本,而是编排器 @@ -316,7 +305,7 @@ MCP 不只是工具桥,还能通过 instructions 影响模型如何理解和 # 8. 权限、Hook、工具执行链深挖 -Claude Code 的工具调用并不是模型直接裸调,而是完整的 runtime pipeline: +成熟 Agent 产品的工具调用并不是模型直接裸调,而是完整的 runtime pipeline: - schema 校验 - validateInput @@ -333,7 +322,7 @@ Claude Code 的工具调用并不是模型直接裸调,而是完整的 runtime # 9. 为什么 Claude Code 这么强 -最核心的原因不是模型更聪明一点,而是它把这些东西系统化了: +最核心的原因不是模型更聪明一点,而是这类产品把这些东西系统化了: - Prompt architecture - Tool runtime governance @@ -351,6 +340,6 @@ Claude Code 的工具调用并不是模型直接裸调,而是完整的 runtime # 10. 最终结论 -> Claude Code 的真正价值,不是一段 system prompt,而是一个把 prompt architecture、tool runtime、permission model、agent orchestration、skill packaging、plugin system、hooks governance、MCP integration、context hygiene 和 product engineering 统一起来的系统。 +> 成熟 Agent 产品真正的价值,不是一段 system prompt,而是一个把 prompt architecture、tool runtime、permission model、agent orchestration、skill packaging、plugin system、hooks governance、MCP integration、context hygiene 和 product engineering 统一起来的系统。 这也是为什么它不像一个“会调工具的聊天机器人”,而更像一个真正的 Agent Operating System。 diff --git a/claude-code-deep-dive-xelatex.pdf b/ai-agent-deep-dive-report.pdf similarity index 100% rename from claude-code-deep-dive-xelatex.pdf rename to ai-agent-deep-dive-report.pdf