用途:为代码库维护一份持续更新的心智模型文档 mental-model.md,帮助在改动代码前快速理解系统。
主要能力:若项目根目录已存在 mental-model.md,则先阅读它,了解架构、模式、约定与模块间关系,适用于修改代码、探索陌生代码、调试失败测试或异常行为时。发现新信息(如运行测试所得、遇到意外行为、探索陌生代码)时更新该文档。
使用方式:若文件不存在,先询问用户是否创建;确认后在仓库根目录新建 mental-model.md,扫描整个代码库,端到端记录系统如何运作,包括架构、关键模块、数据流、关系、测试方式、Docker/环境搭建等。将其视为活文档,持续更新。
适用场景:接手陌生项目、跨模块改动、排查测试失败与异常行为。
限制:资料未提供具体安装命令、平台支持、收费方式或效果保证;文档内容与更新时机依赖使用者判断。