codebase-memory-mcp 是一个用于操作 DeusData/codebase-memory-mcp 的技能条目;后者被描述为本地代码图谱与 MCP 服务器。资料说明该技能适用于处理这一具名的本地代码图谱/MCP 项目,并应阅读上游锁定的事实,以了解包装器的下载行为、配置写入及限制。
用途与路由:该技能将请求分类为代码图谱/索引、CLI/守护进程设置、发布包装器或 MCP 客户端集成。对于一般性的代码搜索问题,应改走 codebase-search。
预检方式:技能提供预检脚本,用于核对仓库/提交是否与 references/source.json 一致。在检出目录中,从仓库根目录运行 python3 .agent-skills/codebase-memory-mcp/scripts/preflight.py --repo /absolute/nonsymlink/checkout --json;--repo 必须是明确的绝对非符号链接目录。若检查已安装的技能根目录清单,则在该技能目录运行 python3 scripts/preflight.py --json。该独立标准库辅助工具要求 POSIX 环境下的 Python 3.10+(macOS/Linux;Windows 需使用 WSL2,因为原生 Windows 会失败关闭),不进行子进程/网络调用、写入或读取密钥。它比较所选锁定文件的 SHA-256,并仅检查 PATH 中命令名称是否存在(不检查版本);从不比较 Git HEAD/整个修订版,也不验证运行时。退出码 0 表示输入有效且所选文件检查通过(命令存在性仅作信息性提示);1 表示所选文件缺失或不匹配;2 表示输入错误。未提供 --repo 时,报告未经验证的清单。
安装与操作限制:在推荐安装前,应检查实际分发/版本。锁定版本的 Go 包装器在首次运行时会下载发布二进制文件;不要把包装器安装视为离线操作。应另行检查确切的包管理器、发布或源码路径。下载/安装、注册 MCP 配置、启动守护进程/监视器、索引项目、写入配置/索引/日志/ADR、更新或删除缓存/索引前,均需获得明确批准。删除时需确定确切路径,除非用户明确授权,否则保留索引。
报告要求:报告观察到的提交与包路径、确切的配置/索引/客户端影响,以及是否实际运行了守护进程或 MCP 客户端。不要将固定版本检查称为功能测试。
示例场景包括:在不安装的情况下检查检出目录中 MCP 工具的启动路径;检查 Go 安装路径是否会下载内容,并解释首次运行下载行为;卸载并删除索引时,先确认确切的项目/缓存范围与显式破坏性授权。
最佳实践:将本地 C 后端、Go 引导包装器与 MCP 客户端设置区分开;使用源码级设置和当前进程状态,而不是文档页面的默认假设;保护项目源码、配置值、日志和凭据的私密性,报告名称/路径而非秘密;预检仅对所选文件做哈希,不证明 Git HEAD 或应用健康状态。