Aitishiku.com📌 Skill基础信息
Skill名称：agent-recall
简称：AgentRecall
来源：社区第三方 (Goldentrii)
运行宿主：Claude Code CLI、Cursor、VS Code/GitHub Copilot、Windsurf、Codex、Hermes Agent、Roo Code 等所有兼容 MCP 协议的 Agent 工具
核心定位：为 AI Agent 提供持久化复合记忆系统，支持跨会话、跨项目的知识沉淀和智能召回，适合需要长期记忆和上下文持续性的开发场景。
🧩 内部核心组成
子Agent集合
- 默认提供 5 个核心工具
- 完整模式提供 18 个工具（需启动时加
--full参数）
MCP工具列表
| 工具名称 | 功能简述 |
|---|---|
| session_start | 会话开始时加载历史上下文和项目信息 |
| session_end | 会话结束时保存和整合记忆内容 |
| remember | 自动分类并存储重要信息到相应知识库 |
| recall | 智能搜索所有记忆存储，支持反馈评分 |
| check | 任务执行前验证理解，支持决策追踪和校准 |
| project_board | 扫描所有项目状态面板（完整模式） |
| project_status | 查看特定项目健康状态（完整模式） |
| bootstrap_scan | 首次使用时扫描现有项目（完整模式） |
| bootstrap_import | 导入扫描到的项目到记忆系统（完整模式） |
目录结构
- 本地存储路径：
~/.agent-recall/ - Obsidian 兼容的 markdown 格式存储
- 可选 Supabase 后端支持语义搜索
🛠 安装与启用方式
关键步骤：
- 通过对应平台的 MCP 配置添加服务
- 命令行工具：
npx -y agent-recall-mcp - 可选完整模式：启动时添加
--full参数
平台特定配置：
- Claude Code:
claude mcp add --scope user agent-recall -- npx -y agent-recall-mcp - Cursor/VS Code: 在对应 mcp.json 文件中配置命令参数
- 所有 MCP 兼容工具均支持 stdio 传输协议
前置依赖：
- Node.js 环境（运行 npx 命令）
- 本地文件系统读写权限（仅限 ~/.agent-recall/ 目录）
📋 标准工作流
- 会话开始：调用
session_start加载项目上下文、身份信息、历史洞察和预警提示 - 工作过程中：使用
remember记录重要决策和发现，自动分类存储 - 信息检索：通过
recall搜索历史知识，支持反馈评分优化搜索结果 - 任务验证：执行复杂任务前使用
check验证理解，减少误解风险 - 会话结束：调用
session_end保存会话总结、整合洞察到知识库、更新宫殿房间 - 跨项目学习：系统自动识别跨项目模式，在相关场景中提示历史教训
⚠️ 关键限制、缺陷、注意事项
平台限制：
- 仅支持 MCP 兼容的 Agent 工具
- 本地模式依赖文件系统存储
Token 消耗：
- session_start 可能返回大量上下文信息，需注意 token 使用
- 完整模式工具会增加额外的 token 开销
适用项目：
- 中长期项目开发维护
- 需要持续上下文记忆的场景
- 跨多个相关项目的开发工作
不适用场景：
- 一次性简单任务
- 对隐私要求极高的项目（本地存储仍存在）
- 无法安装 Node.js 的环境
已知坑点：
- 首次配置需要手动设置 MCP 服务
- 本地搜索基于关键词匹配，语义理解需配置 Supabase 后端
- 洞察(insights)需要符合质量要求，否则会产生警告
生产环境：可用于生产环境，但建议先在测试环境验证稳定性
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景：
- 长期软件项目开发和维护
- 需要追踪技术决策和架构演化的团队
- 跨多个相关项目的全栈开发者
- 希望建立个人或团队知识库的开发者
- 需要减少重复解释和上下文丢失的项目
❌ 不适合场景：
- 简单的单次脚本任务
- 对存储安全性要求极高的敏感项目
- 无法使用 MCP 协议的封闭环境
- 只需要临时会话记忆的简单问答场景
- 资源极度受限的嵌入式开发环境
如何安装
skills install --user Goldentrii/AgentRecall-X通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
本 Skill 涉及读取隐私 / 敏感信息（如密钥、环境变量、凭据）。安装前请确认其用途是否必要。
检测到隐私/敏感信息读取（预设模式 #3） 检测到隐私/敏感信息读取（预设模式 #11）
命中检测项
- privacy_collect