mirror of
https://github.com/tvytlx/ai-agent-deep-dive.git
synced 2026-04-03 07:34:50 +08:00
Rename PDF asset and further neutralize README wording
This commit is contained in:
35
README.md
35
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。
|
||||
|
||||
Reference in New Issue
Block a user