map

用途

$map 是 CocoPlus 技能，用于为项目中的全部 Cortex AI 函数构建并提交知识图谱，生成 .cocoplus/map/coco-map.json，包含结构依赖数据和领域意图映射。

主要能力

• 扫描发现使用 AI_COMPLETE、AI_CLASSIFY、AI_EXTRACT、AI_FILTER、AI_SENTIMENT、AI_TRANSLATE、AI_EMBED、AI_SIMILARITY、AI_REDACT、AI_PARSE_DOCUMENT、AI_TRANSCRIBE、AI_AGG、AI_COUNT_TOKENS 的 SQL UDF，以及 Cortex Search 服务定义和语义模型文件。
• 并行运行 5 个分析代理：函数扫描、依赖映射、领域分析、评估映射、缺口检测，结果写入中间文件。
• 默认对依赖图应用传递归约；可通过 --reduce 显式启用，--reduce off 跳过归约并存储完整传递闭包。
• 将中间结果合并为 coco-map.json，包含 meta、structural（函数、依赖、归约、仓库、评估集）、domain（能力、词汇）、gaps。
• 归档旧图谱、清理中间目录、更新 AGENTS.md 并创建 git 提交。
• 输出摘要，提示后续 $map diff 和 $map explain 命令。

使用方式

1. 确保 .cocoplus/ 已初始化。
2. 项目中至少存在 2 个 Cortex AI 函数。
3. 运行 $map，可选 --reduce 或 --reduce off。
4. 脚本按步骤执行：校验初始化、计数函数、创建目录、归档旧图谱、启动代理、归约依赖、合并写入、清理、更新文档、提交、显示摘要。

适用场景

适用于需要梳理项目中 Cortex AI 函数之间结构依赖、业务领域意图、评估覆盖及潜在隔离风险的场景。

限制与错误处理

• 函数少于 2 个时仅提示，不生成图谱，不提交。
• 分析代理超时则使用部分结果，并在元数据中注明缺失分析。
• 依赖归约失败时回退到完整闭包并警告，不中止。
• coco-map.json 合并冲突时保留旧版本并请求开发者审查。
• 无法写入 coco-map.json 时输出文件系统错误，不删除中间文件。
• 不生成可视化，可视化由 $sketch deps 处理。
• 不将完整分析结果返回编排器上下文，代理仅写入中间文件。