context-anchor

⚓ Agent 记忆断点快速恢复专家

纯bash实现的上下文恢复工具,通过扫描本地memory文件帮助Agent在压缩后快速定位任务状态,零依赖、只读操作、跨平台兼容。

收藏
4.1k
安装
1.5k
版本
v1.0.0
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

核心用法

Context Anchor 是一个专为 Agent 设计的上下文恢复工具,解决上下文压缩后"失忆"的痛点。它通过扫描工作空间内的结构化记忆文件,生成一份清晰的"当前状态简报"。使用时只需运行 ./scripts/anchor.sh,即可获取包含当前任务、活跃上下文文件、近期决策和待办事项的综合报告。支持多种过滤模式::--task 仅显示当前任务,,--decisions 聚焦近期决策,,--loops 列出待办阻塞项,,--days N 自定义扫描天数。

显著优点

零依赖设计是该 Skill 的最大亮点。纯 Bash 实现,仅使用 find、、grep、、head、、tail` 等 POSIX 标准工具,无需 npm、pip 或任何外部包管理器,在 macOS 和 Linux 上开箱即用。只读安全模型确保不会对用户数据造成任何修改风险,适合在敏感环境中运行。输出格式经过精心设计,使用 Unicode 框线和 emoji 视觉分层,信息密度高且可读性强。与 AGENTS.md 工作流的深度整合,使其成为"每次会话启动"的标准动作,大幅降低 Agent 上下文的切换成本。

潜在缺点与局限性

功能边界较为狭窄,仅支持特定目录结构(memory// 和 context/active//),若用户采用其他笔记组织方式则无法兼容。缺乏增量更新机制,每次运行都全量扫描,当日志文件积累较多时可能存在性能瓶颈(尽管纯文本 grep 通常很快)。输出为终端纯文本,不支持 JSON 或结构化数据导出,难以被其他自动化工具链消费。此外,对非技术用户而言,Bash 脚本的调试和定制门槛较高。

适合的目标群体

主要面向长期运行的 AI Agent 系统开发者,特别是采用上下文压缩策略控制 Token 消耗的场景。适合需要多 Agent 协作交接的团队——一个 Agent 结束时运行 anchor 生成简报,下一个 Agent 启动时读取即可无缝衔接。个人知识管理重度用户若遵循 PARA 或类似方法论,也可将其作为每日回顾工具。不适合一次性脚本任务或无需持久化上下文的简单对话场景。

使用风险

性能风险:默认扫描最近 2 天的日志,若单日日志超过数 MB,频繁调用可能产生 I/O 延迟。路径解析风险:WORKSPACE 默认通过 dirname "$0" 推导,若脚本被符号链接或意外移动,可能指向错误目录——建议始终显式设置 WORKSPACE 环境变量。隐私暴露风险:简报输出包含近期决策和待办事项,若在共享屏幕或日志系统中泄露,可能暴露敏感工作信息。可维护性风险:作为早期版本(1.0.0),未来若目录结构变更,脚本可能需同步更新。

安全解读

核心用法

context-anchor 是一个极简的上下文恢复 Skill,专为解决 AI 会话中的"失忆"问题设计。当系统发生 context compaction(上下文压缩)或会话重启后,用户可通过运行 ./scripts/anchor.sh 快速生成结构化简报,内容包括:当前任务状态、活跃上下文文件列表、近期决策记录以及未关闭的待办事项。

该工具提供多种查询模式:--task 仅显示当前任务,--active 列出活跃文件,--decisions 提取近期决策,--loops 识别开放问题,--days N 自定义扫描天数。所有功能通过标准 Unix 工具(find、grep、date、stat 等)实现,无需额外安装。

显著优点

  • 零依赖设计:纯 Bash 编写,不依赖 npm/pip 等包管理器,彻底规避供应链攻击风险
  • 离线安全:无网络请求,所有操作局限于用户指定的本地工作目录
  • 极速启动:无运行时加载开销,毫秒级响应
  • 结构化输出:采用视觉清晰的分区设计(CURRENT TASK / ACTIVE CONTEXT / DECISIONS / OPEN LOOPS),便于快速扫描
  • 高度可定制:支持通过环境变量修改工作目录,通过参数调整扫描深度
  • AGENTS.md 原生集成:设计之初即考虑与代理工作流的深度整合

潜在缺点与局限性

  • 功能边界明确:仅为"阅读器"而非"管理器",无法自动归档或修改记忆文件
  • T3 来源等级:作者为个人开发者(boscoeuk),无顶级组织背书,需持续关注更新动态
  • 无版本控制感知:不追踪文件历史,仅反映最新状态
  • 依赖文件命名规范:若用户未按 memory/YYYY-MM-DD.md 或 context/active/*.md 约定组织文件,提取效果将受限
  • 跨平台细节差异:macOS 与 Linux 的 stat 命令参数存在差异,脚本虽兼容但日期显示格式可能略有不同

适合人群

  • 高频使用 AI 辅助开发的程序员与知识工作者
  • 运行长周期任务、需要跨会话维持上下文的自动化工作流
  • 对工具安全性有极高要求、拒绝引入外部依赖的谨慎用户
  • 团队协作场景中需要快速同步项目状态的多代理环境

常规风险

  • 路径遍历风险极低:WORKSPACE 参数虽可自定义,但脚本仅执行 cd 后的文件读取,无写操作。建议用户避免将敏感目录设为工作区
  • 符号链接攻击可能:当前未对路径进行 realpath 规范化,若工作区含恶意符号链接理论上可能读取预期外文件,但实际攻击场景极为牵强
  • 信息泄露边界:简报内容完全源自用户自身的记忆文件,不会向外部泄露,但需注意若在多用户环境运行,其他用户可能读取终端输出

综合来看,这是一款设计精良、安全可信的辅助工具,特别适合作为 AI 工作流的"每日启动例程"。

context-anchor 内容

scripts文件夹
手动下载zip · 4.8 kB
anchor.shtext/x-shellscript
请选择文件