用途：为代码库生成持久化的 .claude/codegraph.md 索引，形成模块级地图，便于后续任务快速定位文件。
主要能力：脚本负责结构性提取，包括文件发现、导出与导入关系、入口点和被引用计数；智能体只补充一句话用途摘要。支持全量与增量扫描。
使用方式：
- 先检查新鲜度：
bash <skill-dir>/scripts/check-stale.sh，退出 0 表示最新，直接读 .claude/codegraph.md；退出 1 表示过期或缺失。 - 运行扫描器：
node <skill-dir>/scripts/scan.js > .claude/codegraph.draft.md。增量更新用node <skill-dir>/scripts/scan.js --since <recorded-commit> > .claude/codegraph.draft.md。 - 智能体阅读草稿，为每个
Purpose: ???填写一句话摘要，不重复提取导出与导入，结果写入 .claude/codegraph.md。必要时可用 grep 辅助判断文件角色。 - 使用索引前先读 .claude/codegraph.md，只读取相关文件，再用 grep 在文件内导航。
- 变更后重新扫描并只重标注变化节点。
限制：脚本优先，不让智能体手动发现文件或提取导出；图中不存行号；图须保持在 300 行以内，超出则改用文件夹级摘要；该图仅为导航辅助，编辑前仍须读取实际文件。