SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场inject

inject

智能体与模型

查看项目

更新于 10-14 11:10

技能介绍

用途

inject 技能用于将相关的既往知识按需加载到当前会话中，是一个只读的知识检索适配器。它只读取知识用于注入，从不写入 .agents/。资料明确指出，该技能对应的 ao inject CLI 命令已在 memory-moat removal 第 1b 阶段被移除，cm/cass + ao lookup 现在负责检索。该技能仅作为手动检索/知识激活适配器保留，路由到 ao lookup + ao knowledge 系列，不是规范上下文路径，也不会被默认钩子或其他技能调用。内置的 Lease 表将其标记为「retire-candidate」（退役候选），替代端口为 retrieve_context / assemble_context，替代适配器为 ao lookup、knowledge brief artifacts；当前允许用途仅限「manual compatibility lookup only」（手动兼容性查询），不允许用于默认启动注入、隐藏钩子投递、任务规划。

主要能力

按需检索（ao lookup）：资料给出以下命令形式：

  • ao lookup --query "<topic>" --limit 5 —— 按相关性返回 top 匹配
  • ao lookup --bead <bead-id> —— 从某个 bead 的血统中返回 learnings
  • ao lookup <artifact-id> —— 按 ID 获取单个 artifact

ao lookup 会在 learnings / patterns / sessions 语料中搜索，返回有界的、按时效加权的摘要。

知识激活（合并自 knowledge-activation）：将成熟的 .agents 语料提升为持久的操作界面（信念、剧本、简报、缺口）。资料用一句话概括：inject 读取，activation 提升，二者是同一飞轮「读」与「写到界面」的两半。激活是全局语料工作流的第四步。

人工执行步骤（给定 /inject [topic]）：

  1. 搜索相关知识。有 ao CLI 时运行 ao lookup --query "<topic>" --limit 5；无 ao CLI 时手动搜索，资料给出多条命令，包括查看 ~/.agents/MEMORY.md、列出 .agents/learnings/、.agents/patterns/、.agents/research/、全局 learnings/patterns，以及只读回退的旧模式 ~/.claude/patterns/。
  2. 用 Read 工具读取最相关的 artifact。
  3. 总结注入的知识：适用的全局原则或约束、与当前工作相关的关键 learnings、可能适用的 patterns、相关主题的近期研究。
  4. 记录引用（反馈循环）：资料给出 mkdir 与逐条写入 citations.jsonl 的 shell 片段，用于记录每个被注入的学习文件。资料说明：频繁被引用的 learnings 会在 /post-mortem 中获得置信度提升，未被引用的则衰减更快。

使用方式

默认无钩子启动路径：不进行启动注入。先运行 ao session bootstrap 获取标准导向报告，再用 ao lookup 按需拉取上下文。/inject 触发器是旧别名，路由到 ao lookup。

安装与刷新：要更新已安装技能，重新运行安装单行命令：bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh)。资料说明没有 update 技能，技能刷新属于安装脚本的职责。

手动运行（无 ao CLI 时）：按资料给出的 sed 与 ls 命令手动检索知识来源。

知识激活命令契约（稳定的产品界面是 ao knowledge 命令族）：

  • ao knowledge activate --goal "turn agents into usable information" —— 完整外层循环
  • ao knowledge beliefs —— 仅刷新信念手册
  • ao knowledge playbooks —— 刷新候选剧本
  • ao knowledge brief --goal "fix auth startup" —— 目标时刻简报
  • ao knowledge gaps —— 稀薄主题、提升缺口、弱声明、后续工作

资料指出 ao 直接拥有 belief/playbook/brief/gap 产品界面；技能负责路由、排序、解释与下一步建议。当检索到的简报、信念或剧本改变了某条建议时，用 ao metrics cite "<path>" --type applied 2>/dev/null || true 记录（加载但未使用的上下文用 --type retrieved）。

激活步骤：

  1. 预检 —— 确认 .agents/ 存在。要运行 ao knowledge activate，至少存在一种证据基底：.agents/scripts/ 下的 packet builders（source_manifest_build.py、topic_packet_build.py、corpus_packet_promote.py、knowledge_chunk_build.py）；或 harvest 回退 .agents/harvest/latest.json；或原生操作界面（ao knowledge beliefs|playbooks|brief|gaps）。
  2. 整合证据 —— 按顺序运行 packet 层：source manifests → topic packets → promoted packets → historical chunk bundles。完整 DAG 与信任门见 references/knowledge-activation-dag.md。
  3. 提炼操作界面 —— ao knowledge beliefs 然后 ao knowledge playbooks，在 .agents/knowledge/ 与 .agents/playbooks/ 下物化消费者界面。
  4. 编译目标时刻简报 —— 有活跃目标时：ao knowledge brief --goal "..."。保持精简，引用来源界面，当所选主题稀薄时发出警告。
  5. 暴露缺口 —— ao knowledge gaps 报告稀薄主题、缺失的提升、需要审查的弱声明，以及下一步建议的挖掘工作。
  6. 完整外层循环 —— ao knowledge activate --goal "..." 在一次运行中编排证据整合、信念/剧本刷新、可选的简报编译与缺口摘要。

适用场景

  • 需要按需拉取与当前主题相关的既往知识，而不是启动时全量注入。
  • 作为旧版兼容适配器，在迁移到 ao lookup 之前保持手动查询能力。
  • 将已编译的知识提升为信念、剧本、目标时刻简报与缺口报告，作为操作界面供消费方使用。

知识来源与衰减模型

资料列出知识来源、位置、优先级与权重：全局记忆 ~/.agents/MEMORY.md（最高，1.0）；Learnings .agents/learnings/（高，1.0）；Patterns .agents/patterns/（高，1.0）；全局 Learnings ~/.agents/learnings/（高，0.8 可配置）；全局 Patterns ~/.agents/patterns/（高，0.8 可配置）；Research .agents/research/（中）；Retros .agents/learnings/（中）；旧 Patterns ~/.claude/patterns/（低，0.6，只读，不新增写入）。

衰减模型：知识相关性随时间衰减（约每周 17%），较新的 learnings 权重更高。

关键规则

  • 不自动运行 —— 默认上下文投递是显式的
  • 上下文感知 —— 按当前目录/主题过滤
  • Token 预算受限 —— 遵守 max-tokens 限制
  • 时效加权 —— 较新知识优先

激活信任规则

  • packetization 是基底，不是产品
  • beliefs、playbooks、briefings 是真正的操作界面
  • 稀薄主题在证据改善前保持仅发现状态
  • 每个生成的界面都应指明其消费者
  • 重复未变化的运行应保持结构确定性

激活输出界面

消费者界面输出：.agents/knowledge/book-of-beliefs.md、.agents/playbooks/index.md、.agents/playbooks/<topic>.md、.agents/briefings/YYYY-MM-DD-<goal>.md、.agents/retro/。基底界面：.agents/packets/、.agents/topics/、.agents/packets/chunks/catalog.jsonl。

限制与故障排查

该技能已被标记为退役候选，ao inject CLI 已移除，当前仅允许手动兼容性查询，不得用于默认启动注入、隐藏钩子投递或任务规划。

资料给出的故障排查表：

  • 未注入知识 —— 知识池为空或 ao CLI 不可用：运行 /post-mortem 播种知识池；确认 ao CLI 已安装
  • 知识无关 —— 主题不匹配或陈旧 artifact 占主导：用 ao lookup --query "<topic>" 过滤；修剪陈旧 artifact
  • 结果过多 —— 高相关 artifact 太多：减少 ao lookup --limit 或提高主题特异性
  • 衰减过于激进 —— 近期 learnings 未优先：检查 artifact 修改时间（时效加权评分自动应用）

参考文档

  • references/knowledge-activation.feature —— 可执行规范：整合证据、提炼信念/剧本、编译目标时刻简报、暴露缺口（soc-qk4b）
  • references/knowledge-activation-dag.md —— 证据整合的 DAG 与信任门
  • references/knowledge-activation-output-surfaces.md —— 规范激活输出界面与信任边界
  • references/knowledge-activation-script-contracts.md —— builder 清单与 ao knowledge 命令归属