dsh-feature-map

在真实项目里定位一块功能，往往要先搜目录、连开好几个文件，再猜哪些片段才值得读。dsh-feature-map 用「一页一功能」的地图把文件、类型、测试和常见坑集中写清楚，并把这份地图放进智能体的提示里，让它按问题粒度去读索引、主题、整页或某一节，而不是一上来就扎进源码。

插件提供五类能力：读取地图、检查索引与页面是否漂移、过大章节是否难一次读完；为新项目搭好 AGENTS.md、HANDOFF.md、docs/SPEC.md 与地图索引；对已有文档做只读诊断并只补缺失文件；对结构老化的地图做标题、Status 行、分节与索引对齐的重整。另有提示词说明阅读顺序，并在项目已有地图时，对本会话的第一次源码类查找（read/grep/glob）做一次拦截并说明应先查地图——已读过地图则不再拦，无地图的项目也不拦。

地图本身是普通 Markdown，强调用符号名而非行号、单节控制在可读体量内。适合希望智能体「先读文档再动代码」的团队，以及要从零建立文档工作流，或把零散 docs 收拢成可维护功能地图的存量项目。需要整仓机械重构、暂时不想被提醒时，可通过配置把守卫改为仅提示或关闭。