llm-to-agent/docs/extension/hooks-extensions.md

Hooks、扩展与 Profile

状态：todo
期望阶段：P4

目标

让新能力在需要时能以 Tool、Hook、Behavior、Adapter 或 Profile 的形式优雅生长。

已确定

• 第一版只保留 beforeTool、afterTool、afterRun 三个轻量 Hook 点。
• Hook 用于观察、约束或响应生命周期；不承担 Run 状态、存储一致性或 Tool 实际执行。
• Tool、Hook、Behavior、Adapter 是不同扩展形态，不混为“插件”。
• Project、Task、System Evolution 的差异最终由 Profile 组合表达。
• 自动发现、manifest、依赖管理、调试台均后置，等出现真实的独立扩展需求再实现。

待细化

• Hook 的注册、顺序、异常隔离和启停。
• 扩展目录、加载方式和本地开发体验。
• Profile 的配置格式与覆盖规则。