用途：skill-map 在本地文件中定位并交叉引用智能体技能的安装与引用情况，不扫描 macOS 受保护主目录路径，也排除明显的转录、缓存、依赖和备份噪声。它只负责定位和交叉引用，不负责校验技能。
主要能力：支持重复技能、依赖（声明或推断）、外部引用、未解析引用、重复安装等统计；每条边包含类型、来源、标识、源、目标、路径和行号；每个技能记录包含 skill_sha256 和 tree_sha256。支持按 --skill 过滤到某个技能名；同一名字可重复传入。
使用方式：需要 PATH 中存在 ai-skillet 0.1.0 或更高版本，然后运行： ai-skillet map "$ARGUMENTS" 常用参数：--root PATH（可重复，默认 ~）；--portfolio-root PATH（解析到 Git 根，并扫描 ~/.agents/skills 与 ~/.claude/skills，与 --root 互斥）；--skill NAME；--format text|json|dot（默认 text）；--include-catalog-sources；--include-self；--include-snippets；--show-skipped。当结果由其他命令或智能体消费时用 --format json；比较仓库技能与用户安装暴露时用 --portfolio-root <repo> --format json；需要图或依赖可视化时用 --format dot。
输出语义：schema 版本为 1。JSON 和 DOT 必须保持字节有效且无修饰。面向用户时应先给出标题行（含技能数、重复数、未解析数）和汇总表，并说明有效根与主要排除项；默认广泛扫描时明确说明标准智能体主目录和目录源检出已被排除。缺失的显式 --skill 过滤器应显示为可见的未找到警告，而不是看似干净的空结果。
限制与护栏：不要手动搜索已排除的转录或备份目录，除非用户明确要求历史分析；不要把主目录扫描扩大到 ~/Library、~/.Trash 等受保护路径；广泛机器扫描时应把本地技能目录源检出视为误报，审计目录内容时显式传 --root；在公开或第三方制品中使用输出前先做外部披露审查。相关技能：skill-doctor（校验元数据与文档链接）、skill-harmonization（评估冲突、漂移、整合或缺失工作流），需手动调用。忽略策略的说明、审计或修改应参考 references/ignore-policy.md。