该技能用于在不熟悉或含义模糊的代码区域开始实现前进行定向。它先用 indexion agent orient 生成增量式定向地图,再输出简短、有证据支撑的简报,可粘贴到 AGENTS.md、CLAUDE.md、Claude 斜杠命令、Codex 技能或子智能体提示中。
主要能力与流程:先运行 indexion agent orient --help 确认 CLI 含此工作流,缺失需更新或重建 indexion。生成简报可用:indexion agent orient --task-file task.md --output=.indexion/cache/agent/orient.md .;短任务用 --task,例如 indexion agent orient --task "add a name/content drift audit" .。首次运行写入 .indexion/cache/agent/orient-map.json,后续仅刷新变更文件和相关所有者档案;用 --no-update 可只查询已保存地图。若任务措辞未出现在仓库标识符和 README 中,应保留原任务到笔记,只向 --task 传入用代码库词汇写的目标,不要传入基础设施约束或猜测的包名。
编辑前需阅读简报中的:Likely Implementation Owners、Knowledge Sources、Consumer Surfaces、Do Not Implement Here、Required Preflight、Orientation Map。勿将仅有文档的路径当作领域实现位置。
确认归属可用 indexion doc graph --format=text <likely-owner>、indexion grep --semantic=name:<term> .、indexion search "<task concept>" .。若拟改路径落入 Do Not Implement Here,应停止并说明冲突;若预期所有者不在 Likely Implementation Owners 中,应补充证据。CLI 代码应保持轻薄。
用于零知识委派时,只给子智能体任务和定向简报,并先测验其能否指出核心实现归属、一个知识来源、一个不安全编辑位置和一个预检证据路径。Claude Code 将稳定指引放 CLAUDE.md,项目命令放 .claude/commands/,子智能体放 .claude/agents/;Codex 将稳定指引放 AGENTS.md 或 skills。限制:--limit 仅控制显示,归属推断必须基于完整预建地图;宽泛的多源根 wiki 页只能作背景,不能作为归属证明。