用途:丰富自动生成的 .cartographer/ 索引文件,把 index.md 中被截断的描述替换为从源文件 frontmatter 提取的完整描述。
主要能力:读取生态索引与各插件索引,对每个链接的 agents/.md、skills//SKILL.md 源文件提取 YAML frontmatter 中的完整描述,并写回 index.md。示例:将截断的 “Complete Eloquent ORM - models, relatio” 补全为包含 models、relationships、queries、casts、observers、factories 及使用场景的完整描述。
使用方式:在 SessionStart 已生成 cartography 结构后运行;先读取 ${CLAUDE_PLUGIN_ROOT}/../.cartographer/index.md,再逐个读取插件索引及链接文件,提取 frontmatter 后替换索引行中的截断描述并写回。
适用场景:索引描述被截断、新增插件或技能需要完整描述、SessionStart 重新生成地图后。
限制:不用于代码生成或调试;不直接编辑 .cartographer/ 之外的文件;不得修改源文件、不得删除或重构目录树;不得凭假设,必须读取实际 frontmatter。其他安装与运行细节暂未提供。