用途:回顾当前对话与本次会话读写过的文件,提取可复用的项目知识,写入项目记忆文件。默认目标为项目根目录 CLAUDE.md(提交、团队共享),用于架构、约定、集成模式等全团队有用知识。仅当项目已存在 CLAUDE.local.md(已采用三级记忆约定)且该发现确实只对当前开发者/检出有意义时,才写入 CLAUDE.local.md(被 gitignore)。例如依赖本机解释器/运行时的工具加载变通、个人别名、按检出的环境覆盖。反例:提到 ~/.aws/credentials 这类主目录路径但属于团队约定,应写入项目 CLAUDE.md。歧义时默认项目 CLAUDE.md;绝不写入用户全局 ~/.claude/CLAUDE.md,只读取以避免重复跨项目知识。
主要能力与收录范围:纳入架构模式、项目结构洞察、跨文件约定、集成与配置方式、测试策略、构建/部署流程、性能优化、安全实现,以及运维知识(各环境数据库位置与连接、调试中发现的查询、测试与验证步骤、部署工作流与命令、日志位置与监控端点、环境特有的坑)。排除本次会话的战术性内容:修的具体 bug、实现的具体功能、临时变通、一次性改动、遇到的 TODO、变更历史。判断标准包括:是否有助于半年后理解项目、是否为多次出现的模式、是否为项目级约定、是否加速后续开发或节省调试时间。
使用方式(工作流):1) 先扫描项目根 CLAUDE.md、.claude/rules/.md、用户全局 ~/.claude/CLAUDE.md 及 ~/.claude/rules/.md,若存在记忆放置指引则优先遵循,不使用本技能默认规则;2) 读取现有 CLAUDE.md、CLAUDE.local.md 与用户全局 CLAUDE.md 避免重复;3) 若未发现新的战略性知识,报告“no new strategic knowledge to capture”并提前结束,且不使用 AskUserQuestion;4) 对每条发现按目标规则分类;5) 按目标文件格式化展示待添加知识;6) 必须使用 AskUserQuestion 工具做细粒度确认,选项包含“全部/逐项/None”,用户可用 Other 自定义选择,但 Other 不改变目标路径。
限制:只记录本次会话中真正新的发现,不重复已有内容;关注模式而非具体代码;描述需简洁可执行;对已有项目或用户级放置约定不得用本技能默认值覆盖。