术语与定义

Agent 协作控制回路

核心术语体系

• 作者：Key of the Door（GitHub：Key-of-door）
• 版本：v0.1
• 版本日期：2026-07-11
• 许可：CC BY-NC-SA 4.0
• 项目仓库：Key-of-door/code-risk-review-v0.1
• 项目 Release：v0.1（c5054ac）

Word 下载版：下载《Agent 协作控制回路核心术语》v0.1

本术语表用于统一博客正文、结构化方法材料和项目案例中的表达。除非特别说明，这些术语描述的是项目治理与 Agent 协作关系，不是法律概念或已经完成数学形式化的控制论模型。

1. Agent 语义漂移

定义：Agent 在实现过程中，对需求、边界、职责、字段含义或产品定义产生偏移；代码仍可能运行，测试和文档也可能保持表面一致。

边界：它不等同于普通语法错误或单个缺陷，也不表示所有 Agent 输出都会漂移。

作用：指出本框架试图更早暴露和控制的风险。

2. 产品定义权与解释权

定义：决定产品是什么、不是什么，以及关键行为、状态和承诺应如何被理解的项目治理权限。

边界：它由人保留。Agent 可以提出方案和暴露冲突，但不能默认获得最终决策权；这里也不是合同条款中的“最终解释权”。

作用：明确谁对产品含义作最终决定。

3. 语义边界

定义：不能由局部实现随意改写的意义边界，例如产品承诺、字段含义、错误状态、职责分层、隐私限制和能力范围。

边界：语义边界可以通过明确的产品级决策调整，但不能由 Agent 在实现细节中悄悄改变。

作用：限定哪些变化不可被当成普通实现选择。

4. 单一事实源

定义：某一类核心事实只有一个权威定义和生成来源，其他层级可以传递、裁剪、排序和展示，但不能重新定义。

边界：它不要求只有一个文件能够接触数据，也不排斥缓存、序列化或展示运算。

作用：避免前端、后端或不同模块形成相互竞争的产品判断。

5. 理解检查点

定义：在实现前或关键阶段，让 Agent 明确当前理解、已确认事实、待验证假设、修改范围、不应改变的边界和验证方式。

边界：检查点用于暴露理解，不把决策权交给 Agent，也不需要出现在每一次微小修改前。

作用：在代码产生之前发现歧义、越权和范围扩张。

6. 实现自由区

定义：在产品语义、架构职责和接口契约已经明确后，允许 Agent 自由选择具体实现路径的空间。

边界：自由区不包括重新定义产品、扩大授权范围或绕过验证；其边界会随项目阶段和风险变化。

作用：保留 Agent 的搜索与实现能力，避免用过细命令锁死实现。

7. 语义 diff 审查

定义：在代码、文档或配置发生变化后，检查本次差异是否改变产品语义、职责边界、事实来源、对外承诺或授权范围的人工审查。

边界：它不替代普通代码审查，也不保证发现所有语义变化；它仍依赖审查者对产品和上下文的理解。

作用：发现契约和测试尚未编码的新边界及未声明变化。

8. 语义边界变异测试

定义：从一条具体产品承诺出发，故意设计最小的背叛性修改，再验证现有测试能否阻止该语义退化。

边界：所有预设变异被杀死，只证明这些已设计退化没有漏网，不证明测试覆盖所有缺陷或所有语义漂移。

作用：验证测试是否真正守住已经识别的产品边界。

9. Agent 协作控制回路

定义：由人工决策、产品说明、接口契约、工程护栏、理解检查点、语义 diff、测试、变异测试、Git 和发布证据组成的持续校准机制。

边界：它不是自动生成正确判断的系统，也不是严格数学控制模型，更不能替代工程能力和真实环境验证。

作用：把以上机制连接成可观察、可校验、可追溯的协作过程。

九个术语之间的关系

关于“Agent 语义飞控”

“Agent 语义飞控”只作为帮助理解和传播的比喻，不作为与正式框架并列的独立术语。

人给出产品意图，Agent 在实现自由区内选择路径，契约、审查、测试和证据持续观测偏移，并在接近语义边界时触发重新校准。

这个比喻强调目标、授权、观测、偏移和重新校准之间的关系，但不表示本框架已经建立严格的数学控制模型。正式引用统一使用“Agent 协作控制回路”。

许可与引用

本文档采用 CC BY-NC-SA 4.0 协议发布。

允许非商业学习、研究、复现、分享和改编；使用时应按协议提供适当署名、许可链接并注明修改，改编内容应以相同协议共享。商业使用需要另行取得授权。