写作规范
基本原则
- 用中文解释架构,用英文保留通用技术术语。
- 中英文之间加空格,例如 Agent、Tool、Message、Session。
- 文件路径和代码标识符使用反引号。
- 每章先讲问题,再讲源码,最后讲如何自己实现。
- 避免把源码逐行翻译成中文。
章节模板
每个正式小节建议采用这个结构:
markdown
# 小节标题
## 这一节解决什么问题
## Claude Code 里怎么看
## 可以抽象出的设计
## 自己实现时怎么做
## 小结1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
术语约定
Agent:能围绕目标多轮调用模型和工具的程序。AgentLoop:负责模型调用、工具调用和下一轮追问的循环。Tool:模型可请求执行的外部能力。ToolUse:模型输出的工具调用请求。ToolResult:工具执行结果,通常以用户消息形式返回模型。Session:一次持续对话及其状态。Context:发送给模型的可见消息、系统提示和附件。