Agentflow v8.4.15 是一个用于管理 AI 编程会话与开发工作流的技能框架。其核心是在一个配置好的笔记本（notebook）中维护所有者（owner）对话和实时恢复信息，高级规则仅在需要时加载。
用途与定位
Agentflow 旨在为宿主（host）提供结构化的会话启动、输入捕获、进度跟踪和关闭流程。它支持通过分支/工作树（branch/worktree）作为所有者/会话的功能工作区，也允许仅使用笔记本文件进行非代码请求，即使启用了 Git 也可不创建分支。普通笔记本支持无 Git 文件夹，但新功能开发需要 Git。外部工作者使用一次性无远程克隆，内部/宿主工作使用实际工具并记录所有权。
主要能力
- 启动与配置：通过
node <active-agentflow-skill-dir>/scripts/agf.js start --repo <repo> --host <safe-id> [--host-family <known-family>] --message-stdin --json启动，携带精确的所有者消息。启动幂等，返回配置、Git 状态、Ask 等信息。 - 输入捕获：每条消息需保存到当前 Ask，使用
notebook-write.js append-input --notebook <target-doc> --input-stdin。Codex 通过钩子自动捕获，Claude 需手动捕获并指定--host claude --session <startup session_id>。 - 答案恢复门：启动后必须运行强制答案恢复门，检查先前问题中的非空答案和所有者内联请求，并将其带入当前 Ask 一并处理。
- 路由选择：支持 direct、selected_advisors、full_pipeline 或 blocked 四种路由。宿主负责规划、决策、编排、审查、验证和交付，并可委托有界、可独立验证的执行片段给经济型工作者，但保留规划、架构、安全边界和最终审查。
- 压缩与归档：当笔记本达到 750 行或 768 KiB 时自动压缩符合条件的已完成轮次；返回 compaction.blocked 时需在答案恢复门后跟进，使用
node <active-agentflow-skill-dir>/scripts/agf.js compact --notebook <target-doc> --include-answered true压缩已处理项。 - 所有权与流：可配置 notebook-ownership 来强制单一会话所有权；流决策需要时加载
references/streams.md。 - 快速通道与跳过：支持
skip-ag [task]和/fast-lane [task]等控制指令，改变当前 Ask 的路由或绕过协议。
使用方式
宿主需提供完整的 Agentflow 技能目录路径 <active-agentflow-skill-dir>。启动后根据返回的本地时间戳、运行 ID、配置、Git、Ask 和变更路径进行操作，仅检查当前 Ask 所需的文件。消息捕获、进度更新和关闭均通过 agf.js 和 notebook-write.js 脚本完成，需遵循特定的标准输入和参数格式。
适用场景
适用于需要结构化会话管理、所有者对话恢复、Git 证据记录和可选开发工作流的 AI 编程协作场景，尤其适合宿主与工作者之间的任务委托、审查和交付流程。
限制
- 宿主必须提供完整的技能目录路径，否则应停止并给出明确消息。
- 启动时不得进行空探测调用，不得使用伪终端。
- 通用宿主需显式提供安全 ID 和唯一会话 ID，不接收 Codex/Claude 钩子、转录身份、模型等推断信息。
- 笔记本及其相邻归档是唯一权威对话历史，已完成跨度不可重写，仅允许经字节保留验证的压缩移动。
- 某些配置无效值会阻止启动，需所有者批准后修正。
- 详细规则仅在触发时加载，需遵循按需加载原则。