Hooks 与扩展
自动捕获 session Activity，并保持宿主适配与 Skill 生命周期解耦。
将自动会话记录和宿主适配保持在边界内，不把 Skill 业务逻辑散落到集成层。
Hooks
Hooks 用于自动记录 session Activity。当前插件包含 Codex 与 CodeBuddy hook 配置，以及共享的 session-hook.mjs：
plugins/foundry/hooks/codex-hooks.json
Hook 的职责是把宿主会话上下文规范化为 Activity 输入，再调用 Usora MCP。它不负责 Candidate、Skill 或治理状态推进。
插件平台说明
plugins/foundry/plugin.json 是 canonical plugin entry；plugins/foundry/src 是 MCP runtime；scripts/usora-mcp.mjs 是薄入口。Codex 与 CodeBuddy adapter 各自维护宿主元数据：
plugins/foundry/.codex-plugin/
plugins/foundry/.codebuddy-plugin/设计边界
核心插件负责 storage、lifecycle、roles 和 state progression；AI-specific integrations 只负责把 sessions 归一化为 Activities。这样新增宿主时不用复制 Candidate/Skill 业务逻辑。
扩展前检查
新增工具前先确认是否属于 Hub 生命周期。更新 plugin.json 后运行：
bun run sync
bun run doctor如果只是新增宿主适配，优先复用 src/adapters 的现有模式，并保持 MCP tool schema 不变。