用途:审查使用 Deep Agents 框架的代码,发现缺陷、反模式与可改进之处,适用于 create_deep_agent、后端(backend)、子智能体(subagent)、中间件(middleware)等代码的评审。
主要能力:提供一套证据约束的审查流程。先执行“反臆造”门禁:在给出任何发现前,必须回显本轮实际读取到的目标代码(文件:行号加引用),不得依据分支名、工作目录或记忆推断。随后按顺序执行定位、锚定、分类、运行时断言四步审查门禁,再对照编号问题清单逐项检查。
覆盖的问题类别包括:关键问题(interrupt_on 缺少 checkpointer、StoreBackend 缺少 store、使用 checkpointer 时缺少 thread_id、文件工具使用相对路径、虚拟文件系统使用 Windows 路径);后端问题(StateBackend 误期待跨线程持久化、FilesystemBackend 未限制 root_dir、CompositeBackend 路由前缀遮蔽、无 SandboxBackend 却期待 execute 工具);子智能体问题(缺少必填字段、名称冲突、简单任务滥用子智能体、CompiledSubAgent 状态不兼容);中间件问题(执行顺序误解、直接修改请求/响应、工具缺少描述);系统提示问题(重复内置工具说明、与内置指令冲突、缺少停止条件);性能问题(未并行化独立子智能体、大文件写入 State、生产环境使用 InMemorySaver、缺少递归意识)。
使用方式:按门禁与清单逐项核对,每个发现需附路径:行号与代码引用;无法定位文件或搜索时应停止并说明缺失,而非凭记忆推断。完整清单见 references/checklist.md。
限制:资料未提供安装命令、收费、平台支持或效果数据;该技能面向 Deep Agents 代码审查,不适用于其他框架。