SuperAPI AI 工具集

agentic-harness-patterns

智能体与模型

查看项目

更新于 10-15 23:45

技能介绍

用途:面向构建或扩展编码智能体运行时、自定义智能体及高级多智能体工作流的工程师,讲解智能体“harness”(记忆、技能、安全、上下文控制、委派、扩展性)的生产级设计模式。不适用于提示工程、模型选型、通用软件架构或 LLM API 基础。

主要能力与要点: 记忆:区分指令记忆(人工编写、按组织→用户→项目→本地优先级注入)、自动记忆(智能体写入,含类型分类与上限索引,两步保存:先写主题文件再更新索引)、会话提取(会话结束时后台写入,与主智能体写入互斥)与跨层审查提升(需用户批准)。 技能:懒加载指令集,发现阶段仅加载元数据(每条有字符上限,总量约上下文窗口 1%),激活时才加载正文;可内联或隔离执行,来源可打包、用户安装或插件动态加载,按规范路径去重。 工具与安全:默认失败关闭,工具默认非并发、非只读;并发按调用而非按工具分类;权限管线按严格优先级评估多来源规则,评估器有状态;处理分发分交互、自动、异步三种。 上下文工程:把上下文当预算,通过选择(渐进披露三层)、写入(回写持久存储)、压缩(反应式压缩旧轮次)、隔离(协调者零继承、fork 单层、worktree 隔离)四种操作管理。 多智能体协作:协调者、fork、swarm 三种委派模式;fork 仅单层,swarm 成员不可再生成成员;结果异步返回。 生命周期与扩展:钩子在生命周期节点注入副作用,信任为全有或全无;长任务用类型化状态机跟踪,两阶段驱逐;启动按依赖顺序记忆化分阶段,信任边界前不得激活安全敏感子系统。

使用方式:按问题选择对应章节阅读,先读 Gotchas 了解非显而易见的失败模式;在 Claude Code 中可用 /remember 审查提升自动记忆,用 /update-config 配置权限规则与钩子。

限制:资料未提供安装命令、价格、平台支持或效果数据;内容为设计原则,非可直接运行的代码库。