SuperAPI AI 工具集

nerd-context

智能体与模型

查看项目

更新于 10-15 20:31

技能介绍

用途:为当前活跃工作维护一份持久、以 ID 寻址的 Context,保存类型化事实记录,包括目标(goal)、边界(boundary)、决策(decision)、证据(evidence)、待解决问题(open_question)与检查点(checkpoint);修正通过显式取代(supersession)完成。

主要能力与身份规则:唯一公开身份是运行时生成的不透明 context_id,规范语法为 ^ctx_[a-z2-7]{38}[aiqy]$。调用方不能自选 ID。省略 context_id 调用 context_recall 会原子地创建全新的空 Context 并返回新 ID。当前激活中或子智能体交接中的精确 context_id 只会恢复该 Context。未知、遗忘或格式错误的 ID 返回 not_found,不应搜索、列举、猜测或替换其他 Context。ID 应视为敏感定位符,不应写入常规日志。

使用方式:按 Smart 的无记忆 Focus Record 与端点在 recall 前执行;先做传输预检,在可调用注册表搜索全部三个工具,优先 MCP,区分缺失/禁用/已注册未上线/未知状态;受保护的 CLI 回退需要用户对该恢复的显式授权。若 Focus 解析因需澄清而停止(仅 ID 的“继续”请求、权限不明、交接有歧义),则不进行 hydration。创建时打印 Nerd-context created: <context_id>,恢复时打印 Nerd-context resumed: <context_id>。返回包仅作参考,依赖前需重新验证锚定事实。在受约束的已验证决策、已验证证据、检查点或值得停止的待解决问题之后,调用 context_capture 提交最少的类型化记录,不得包含原始转录、隐藏推理、机密、工具参数、权限或未经审阅的子智能体文本。MCP 不可用、引擎弃权或 not_found 时不要静默重试,保持端点不变并以无 Context 方式继续。

数据边界与限制:仅存储 kind、结构化值、来源类别、source_ref、可选 supersedes_id、可选仓库相对锚点和修订时间戳;拒绝机密、原始转录、隐藏推理、可执行载荷、凭据、权限授予和不安全锚点。生产捕获每次调用上限 20 条记录,私有规范化捕获参数上限 256 KiB;hydration 每包上限 2,048 UTF-8 字节。Context 只存当前 ID 绑定的证据、检查点与开放问题;Memory 存可复用的长期行为与已验证工作流;两者互不读取、复制、确认或授权,升级永不自动,需目标工作流自身的有效权限与证据。context_inspect 仅为有界元数据,绝不返回记录值,不能作为替代 hydration 路径。遗忘仅限 CLI,需两步预览与 recall 和 capture 中的精确确认短语;若显式 inspect 或 forget 时 MCP 不可用,应报告并仅在该请求内使用 python3 <skill-root>/scripts/context.py。

不兼容与状态:除非请求明确要求,绝不与 Superpowers、Ponytail、Caveman 组合。技能钩子、提及和间接指令不构成授权。生产状态方面,有界词法(标识符-令牌)候选已实现,并在 48 个金标夹具案例上达到 100% 必需召回与模式一致;token 节省、质量差异、对抗、延迟、盈亏平衡、生成捕获和预注册实况运行门禁仍未满足,跟踪结论为不确定,typed-ledger-pass 仍以非零退出;不要声称已生产发布。修改该技能族后,运行聚焦 context 测试、python3 scripts/validate_skills.py 及完整仓库套件。