用途：为任意规模代码库生成架构地图与文档，适合新项目上手或理解既有代码。触发词包括 map this codebase、cartographer、/cartographer、create codebase map、document the architecture、understand this codebase。
主要能力：生成 docs/CODEBASE_MAP.md，含系统概览、Mermaid 架构图、目录结构、模块指南、数据流、约定、注意事项与导航指南；同时更新 CLAUDE.md（若存在 AGENTS.md 也一并更新）。支持更新模式，仅对变更模块重新分析。
使用方式：核心原则是 Opus 编排、Sonnet 读取，不让 Opus 直接读代码。先检查是否已有地图，读取 last_mapped 时间戳并用 git log --oneline --since="<last_mapped>" 检测变更。扫描代码库可运行：uv run ~/.claude/skills/cartographer/scripts/scan-codebase.py . --format json，或直接执行该脚本，或 python3 执行。缺少 tiktoken 时安装：pip install tiktoken 或 uv pip install tiktoken。按约 150,000 token 预算分组，用 Task 工具以 subagent_type: "Explore"、model: "sonnet" 在单条消息中并行派发子代理，再汇总去重、构建架构图。架构图可调用 /beautiful-mermaid 渲染为 SVG/PNG。
限制：需 Claude 环境与相应技能脚本；扫描依赖 Python 与 tiktoken；变更检测依赖 git，无 git 时退化为文件数量/路径比较；超大代码库需增加子代理、聚焦 src/ 或使用 --max-tokens 跳过巨大文件。资料未提供收费、价格与平台支持信息。