术语统一审校记录

本文件记录本次“统一全书术语”的执行结果，后续每轮全书精修时可继续补充。

1. 已建立统一术语表

文件：

references/glossary.md

术语表已覆盖：

  • Agent / Workflow；
  • Prompt Engineering / Context Engineering；
  • Context Window / Context Budget / ContextChunk；
  • Tool / ToolRegistry / Tool Orchestration；
  • Skill / Agent Skills / Progressive Disclosure；
  • Harness / Checkpoint / Verification / Recovery；
  • Memory / Memory Governance；
  • MCP；
  • Multi-Agent / Subagent / Shared Workspace；
  • Agent Runtime / Session / Event Log；
  • Managed Agents / Brain / Hands / Worker。

2. 已补充前言术语说明

文件：

book/00-preface.md

新增“术语说明”小节，说明本书保留 Agent、Workflow、Context、Tool、Skill、Harness、Runtime、MCP 等英文术语的原因，并指向术语表。

3. 已执行的全书替换

已对 book/*.md 执行以下安全替换：

原写法 统一写法 说明
长时间运行 Agent Long-running Agent 与章节标题和术语表一致
长期运行 Agent Long-running Agent 预防性统一
多智能体 Multi-Agent 预防性统一
子智能体 Subagent 预防性统一
大语言模型应用开发 LLM 应用开发 与全书技术语境一致

实际改动文件：

book/00-preface.md
book/01-why-agent.md
book/13-harness-engineering.md

4. 已更新目录与入口

已更新：

SUMMARY.md
README.md

新增以下入口：

references/glossary.md
references/case-study-ci-failure-agent.md
diagrams/diagram-plan.md
docs/book-refinement-plan.md

5. 当前保留的中英并用术语

以下术语允许中英并用，不强制替换为单一写法：

术语 保留原因
Workflow / 工作流 技术语境保留 Workflow，传统软件工程语境可用工作流
Context / 上下文 中文表达自然，章节标题保留英文
Tool / 工具 正文中“工具”可读性更好，工程接口用 Tool
Memory / 记忆 章节标题用 Memory，解释性文字可用记忆
Checkpoint / 检查点 首次解释后可中英并用
Session / 会话 需要根据语境区分普通会话与 Agent Session
Event Log / 事件日志 架构图和接口用 Event Log，正文可用事件日志
Runtime / 运行时 Agent Runtime 保留英文，泛指机制时可用运行时

6. 后续全书精修时重点检查

后续语言统一阶段需重点检查以下易混概念：

  1. Session vs Context Window

    Session 是持久化事件流，Context Window 是模型单次调用可见内容。

  2. Memory vs Conversation History

    Memory 是结构化长期上下文资产，不等于完整聊天历史。

  3. Tool vs MCP

    Tool 是动作，MCP 是外部能力和资源接入协议。

  4. Skill vs Prompt

    Skill 是可复用能力包，Prompt 是当前任务指令。

  5. Harness vs Runtime

    Harness 负责 Agent 执行循环，Runtime 负责平台级任务、会话、状态和治理。

  6. Workflow vs Agent

    Workflow 控制流主要由程序定义，Agent 根据环境反馈动态决策。

  7. Checkpoint vs Summary

    Checkpoint 是可恢复状态协议，Summary 只是文本摘要。

  8. Project Knowledge vs Project Memory

    Project Knowledge 来自显式项目文档；Project Memory 来自历史任务沉淀。

  9. Scratchpad vs Private Context

    Scratchpad 是一种临时私有上下文，但 Private Context 范围更广。

  10. Shared Workspace vs Memory Store

    Shared Workspace 服务当前多 Agent 任务协作；Memory Store 服务跨任务长期记忆。

7. 建议后续自动检查规则

后续可以增加一个简单脚本，检查以下不推荐写法：

多智能体
子智能体
大模型代理
智能代理
长期运行 Agent
长时间运行 Agent
上下文工程化
工具函数调用协议（用于 MCP 时）
聊天历史记忆（直接等同 Memory 时）

如果出现，应人工判断是否替换为术语表中的推荐写法。

results matching ""

    No results matching ""