用途:创建一个由 Hindsight 提供长期记忆支持的子代理,适合需要跨会话学习与记忆的专用代理场景。
主要能力:支持两种调用模式。模式 A 为自驱动代理:当用户从某个目录执行 /hindsight-memory:create-agent <name> 时,该目录由 npx @vectorize-io/self-driving-agents install 准备,包含 .md、.txt、.html、.json、.csv、.xml 等种子内容文件,以及可选的 bank-template.json。此模式下会读取 bank-template.json(若存在)并记录 mental_models 数组,用 agent_knowledge_ingest_file 逐个摄取内容文件(不含 bank-template.json),再创建知识页面:若存在 bank-template.json 则严格按其 mental_models 数组中的 id、name、source_query 创建;否则基于摄取内容创建 3 个合理页面,最后按模板写入子代理文件。模式 B 为交互式空代理:未提供目录路径时,询问代理名称(小写加连字符)、代理用途(一句话)以及可选的种子文件或文本,然后创建子代理文件。
使用方式:子代理文件写入 ~/.claude/agents/<name>.md,模板包含 name、description、mcpServers: [hindsight] 以及启动步骤和工具说明。启动时调用 agent_knowledge_list_pages 查看知识页面,再对每个页面调用 agent_knowledge_get_page(page_id) 加载知识;若返回超出 token 限制的错误,可用 Read 读取保存的 JSON 文件并解析 result 内的 content 字段,无法解析则跳过并依赖 agent_knowledge_recall。创建页面用 agent_knowledge_create_page(page_id, name, source_query),搜索记忆用 agent_knowledge_recall(query),摄取文档用 agent_knowledge_ingest(title, content),更新与删除用 agent_knowledge_update_page 和 agent_knowledge_delete_page。
限制与规则:必须包含 mcpServers: [hindsight];启动步骤和工具说明需原样保留;任何工具调用都不要传 bank_id,插件会从项目上下文自动解析;创建前需调用 agent_knowledge_get_current_bank 并告知用户代理将绑定到该 bank。页面自动更新,不要直接编辑内容;创建页面应静默进行,不向用户宣告;优先使用少量宽泛页面而非大量狭窄页面。创建后确认文件已写入,告知用户可用 @<agent-name> 调用或由 Claude 根据描述自动委派,并建议运行 /agents 或重启 Claude Code 加载新代理。