用途:在接触陌生代码库、会话上下文丢失、检测到尚无记忆,或用户要求“了解这个项目”时调用,帮助智能体快速建立项目认知。
主要能力:先检查 .claude/context/memory/ 下是否已有 project-structure.md、build-commands.md、test-commands.md,有则读取并跳到验证步骤。随后做项目发现,区分绿地与棕地项目,尊重 .gitignore 与 .claudeignore,用 git ls-files 列出受跟踪文件,跳过二进制、node_modules 与构建产物,大文件只读首尾。识别包管理器与语言(package.json、pyproject.toml、Cargo.toml、go.mod、pom.xml、composer.json 等)、项目类型与框架。再分析构建系统,读取 package.json scripts、Makefile、pyproject.toml 中的命令,映射目录结构,识别入口点、组件目录、API 路由与数据模型。最后把结果写入持久记忆文件并输出摘要。
使用方式:按七步流程执行——检查已有知识、项目发现、构建系统分析、目录结构映射、创建记忆、验证、报告摘要。示例命令包括 git ls-files --exclude-standard -co | head -100,以及 find 配合 -not -path 排除目录。验证阶段可运行 npm --version 或 npm run --silent 确认脚本,未经用户许可不得运行构建或测试。
适用场景:新代码库上手、新会话恢复上下文、项目结构发生重大变化后更新记忆。
限制与原则:始终先查已有记忆,避免重复上手产生矛盾知识;不得假设标准约定,需实际验证;命令与路径必须写入持久记忆;文档化前用安全方式验证命令;项目演进后需回访记忆。记忆协议要求开始前读 learnings.md,完成后按新发现、问题、决策分别写入对应文件。具体项目命令与路径因项目而异,资料未提供通用固定值。