用途:aix-map 是一套面向 OpenCode 的省 token 仓库上下文工作流。核心思路是先读取已索引的 .aix 上下文,再只读取相关源文件,尽量避免整仓库扫描,从而降低 token 消耗。适用于编码、调试、重构、功能开发以及理解仓库结构等任务。
主要能力与工作流:开始编码前先读 .aix/AI_CONTEXT.md;从中只挑选 1 至 2 个相关的 .aix/maps/ 映射文件;只读取所选映射文件中列出的源文件。除非 .aix 缺失、.aix 过期,或任务无法从现有映射中理解,否则不扫描整个仓库。编码完成后,只更新相关的 .aix 文件,保持 .aix 文档简短、事实性、对 AI 友好。
过期判定与回退:当 AI_CONTEXT.md 与当前仓库结构矛盾、映射文件引用了缺失或已改名的文件、任务目标区域未出现在映射中,或 .aix/recent-changes.md 缺少近期重大工作的新条目时,视为 .aix 过期。过期时应做最小范围的定向扫描以恢复上下文,并只更新受影响的 .aix 文档。读取策略优先使用映射中列出的文件,而非探索式扫描;若映射使用 glob,只展开所需匹配;不要打开无关文件;无法避免更大范围扫描时需说明回退原因。
变更后的更新策略:涉及相关变更时始终做到两件事——在 .aix/recent-changes.md 追加一行简短记录;当文件列表或归属变化时更新受影响的映射文件。只有单个区域变化时,不要重写整个 .aix 集合。
映射文件规则:映射只能列出仓库中真实存在的文件,不得添加假设的路径、目录或文件。创建或编辑映射时应先对候选文件做 glob 搜索,只纳入 glob 实际返回的具体匹配;若某 glob 无匹配则不要写入。优先使用明确文件路径而非宽泛 glob;使用 glob 时展开并把匹配文件路径写入 files:。若项目映射会为空,则省略该映射文件,或将 files: 留空并说明原因。
文档风格与语言:.aix 文档写作应分节简短、使用具体文件路径、不写长篇叙述、不使用营销语言。所有映射文件和 .aix 文档必须用英语撰写,Description 与 why 字段使用简洁事实性英语。
配套与输出位置:该技能属于 AIX skill pack,用户侧别名为 aix-map,被调用时使用本技能。生成的工件写入 .aix/ 下;写入前用 mkdir -p .aix 确保目录存在;.aix/ 中生成的文件默认可被覆盖;除非明确要求,不要把生成文件写入项目根目录。
限制:资料未提供收费、价格、平台支持范围、性能数据或具体效果指标,暂未提供。