Rename PDF asset and further neutralize README wording

This commit is contained in:
Shawn Bot
2026-04-01 05:42:42 +00:00
parent edea5d1424
commit 614d52be62
2 changed files with 12 additions and 23 deletions

View File

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