用途:在调研某个代码领域(如 jobs、models、services、controllers)时,自动检查并更新该目录层级的 AGENTS.md,把研究所得沉淀为文件夹级上下文。
主要能力:研究前从目标目录向上查找最近的 AGENTS.md,提取已知模式、约定、坑点、文件组织规则与测试方式,避免重复发现;研究后评估每条发现是否值得记录,只保留可跨文件复用、非显而易见、曾造成困惑或涉及集成与测试的条目,跳过一次性细节、已记录内容和代码中显而易见的信息。
使用方式:触发条件包括调研特定领域、使用研究类 agent、在同一目录层级读取多个文件,或用户要求理解/调研某子系统。更新时按最近优先原则定位目标 AGENTS.md,将学习内容映射到 Patterns、Conventions、Gotchas、Structure、Testing、Integration 等章节,以单条要点加文件引用(如 path/to/example.rb:42)的形式追加而非替换。若层级中不存在 AGENTS.md,则在领域层创建,包含 Purpose、Patterns、Gotchas、Testing 等章节;仅当某子目录有 3 个以上文件且模式与父级明显不同时才单独创建。查找现有文件可用 find . -name "AGENTS.md" -type f | head -20。涉及外部最佳实践时,先明确技术与版本,用带版本的查询检索官方文档与开源示例,输出 Must Have、Recommended、Anti-patterns、Sources 结构,并标注版本适用范围与来源冲突。
适用场景:代码库调研、子系统理解、研究 agent 工作流中的知识沉淀。
限制:仅做研究与记录,不实现或编写代码;所有建议需有来源;不把全部发现倾倒进 AGENTS.md,也不为每个文件夹都创建;避免重复根级指引;更新在研究结束时批量进行。具体安装与调用方式暂未提供。