用途:按照 AGENTS.md 的运营规则,向 memory MCP(server-memory,保存位置 memory.jsonl)初始创建架构知识图谱,记录代码库的模块结构与依赖关系。适用于「初始化知识图谱」「创建 memory 图谱」「注册架构图」等请求,或项目初期构建完成后的收尾。
主要流程:一、用 read_graph 确认既有图谱;若已存在实体则不覆盖,仅补充缺失部分(必要时向用户确认)。二、调查代码库,按项目结构确定粒度,梳理仓库整体(单体仓库视为 1 个实体,子目录构成写入 observations)、构建与包定义单位(如 Xcode target、npm workspace、Gradle 模块,框架与外部依赖写入 observations)、源码目录的主要模块(按分层结构如公共基础、领域层、功能单位)、入口点(main 函数、App 结构体、服务器启动脚本等)、基础设施与运维(IaC、CI/CD、部署配置、发布自动化等)。三、用 create_entities 注册实体,用 create_relations 注册依赖关系;entityType 示例有 monorepo、build target、entry point、core module、feature、infra,relation 示例有 depends on、contains、injects、configures、deploys;observations 需包含「做什么」以及结构上的注意点(构建配置例外、环境与 mock 切换机制等)和调查日期。四、用 read_graph 验证结果,与代码目录列表比对,确认主要模块无遗漏。五、若 AGENTS.md(或 CLAUDE.md)中没有相应章节,则追加架构知识图谱的运营规则;已有同等规则时不重复添加。
使用方式:后续实现与调查前先用 search_nodes 或 open_nodes 参照相关模块的 entities / relations(需要全貌时用 read_graph);模块增删或依赖变更后用 create_entities、create_relations、add_observations 等更新图谱。
限制与注意:图谱仅记录可从代码导出的「结构与依赖关系」,不写任务管理或 TODO。资料未提供安装命令、收费与价格、支持的平台等信息。