领域笔记（Field Notes）

领域笔记（Field Notes）承载具有时效性的实现细节，避免协议修订、产品格式和供应商变化影响本手册核心结构的稳定性。每篇笔记都应记录适用的版本和观察日期，并链接到核心章节中对应的长期工程问题。

持续维护的笔记

• 模型 API、工具调用与结构化输出 — 当前工具使用、按 schema 约束输出、会话状态接口，以及仍然需要的控制。
• Agent Skill 格式与扩展机制 — SKILL.md、Agent Skills、产品特定扩展机制，以及为什么打包格式不会自动产生权限。
• MCP、A2A 与智能体互操作性 — 协议能力、安全边界，以及语法兼容与运行兼容的区别。
• 框架与供应商比较 — 面向工作负载比较当前智能体框架和供应商运行框架的方法。
• 研究、基准测试与行业动态 — 如何阅读当前智能体基准测试，而不是把分数转化为产品主张。