用途:为智能体而非人类创建 CodeMap,节省上下文注意力,通过渐进式披露把智能体路由到正确的源码关联证据。不替代源码、测试、日志或当前 Spec。
主要能力:支持项目 CodeMap(广度优先的项目地形、能力索引、模块边界、依赖索引与下钻指针)和功能 CodeMap(从入口到效果的深度优先能力地形,含分支、依赖、风险与验证入口)。
使用方式:先复述请求范围并选择模式——feature(能力、业务功能、缺陷链、API 流程、函数/类调查)、project(仓库、服务、包、子系统或首次上手地图)、drift-check(对比当前 diff 或改动文件与已有 CodeMap)、update-existing(代码地形变化后刷新已有 CodeMap)。写持久化 CodeMap 前需说明用途、模式、范围与预期路径,未经当前任务批准不得静默写入。用搜索优先检查代码(rg、rg --files 等),优先源码事实。构建渐进式 Context Tree Nodes,从小的定位节点开始,仅在能路由未来上下文处添加能力、模块、入口、分支、效果、依赖、风险与验证节点,节点指向文件、函数、类、测试、配置、日志与相关地图,关系标记为 confirmed、inferred 或 unknown。持久化路径:feature 为 mydocs/codemap/YYYY-MM-DD_hh-mm_<feature>功能.md,project 为 mydocs/codemap/YYYY-MM-DD_hh-mm_<project>项目总图.md。
适用场景:项目首次上手、功能或缺陷链调查、API 流程梳理、代码地形变化后的地图更新与漂移检查。跨仓库任务时每个项目各建一份 Project CodeMap,另加接口或跨服务流程摘要。
限制:CodeMap 不是变更日志,只更新改变地形的事实;过期或冲突的 CodeMap 应视为需重新核对的索引而非真相;不要粘贴大段源码或写成叙述性系统文档。输出偏好路径链接、源码依据的要点,区分 Confirmed、Inferred、Unknown,包含 Next Drill-Down 与 Validation Entry。具体模板与原则见 references/principles.md、feature-template.md、project-template.md、drift-check.md、update-existing.md。