不熟悉或含糊代码区域实现前，用 indexion…

在进入不熟悉或含糊的代码库区域开始实现前，生成并消费有证据支持的预编辑结构简报，以对齐负责人、知识来源、消费面和不安全编辑位置。

适用场景

解决思路

1. 运行 `indexion agent orient` 构建跨所选代码库的增量 orientation map，并渲染简短、有证据支持的 brief，以便粘贴到 AGENTS.md、CLAUDE.md、Claude 斜杠命令、Codex 技能或子代理提示词中。
2. 将渲染的 `--limit` 仅视为显示限制；owner 推断必须来自完整预构建 map，包括代码结构、package READMEs 和 wiki pages；这些 wiki pages 的来源由 `wiki pages update`、`wiki pages ingest` 和 `plan reconcile` 维护。
3. Owner profiles 使用 package 文档和 owner 专属 wiki pages；具有多个 source roots 的 broad wiki pages 是有用背景，但不应视为每个被引用 package 拥有任务的证据。
4. 验证已安装 CLI 是否有此 workflow：`indexion agent orient --help`。
5. 如果该命令缺失，先更新或重建 indexion 再继续；PATH 中有较旧 `indexion` binary 不足以支持此技能。
6. 生成 brief：`indexion agent orient --task-file task.md --output=.indexion/cache/agent/orient.md .`。
7. 首次运行写入 `.indexion/cache/agent/orient-map.json`；后续运行仅刷新已变更文件和受影响的 owner profiles。
8. 当有意查询已保存 map 而不刷新时，使用 `--no-update`；这是零知识代理需要从最新预构建 map 立即获得 owner 猜测时使用的模式。
9. 对短任务：`indexion agent orient --task "add a name/content drift audit" .`。
10. 如果用户任务的语言或措辞未出现在仓库的标识符和 README 文本中，将原始任务保留在笔记中，并向 `--task` 传入简短的代码库词汇 gloss；gloss 应描述目标，而不是怀疑的 owner。例如说 `"detect drift between names and implementation contents"`，而不是命名未确认的 package。
11. 不要将支撑基础设施约束放入用于 owner 推断的 `--task` gloss；将原始请求、所需工具和实现约束保留在笔记或子代理提示词中；gloss 仅用于查询预构建 map 的目标词汇，例如：`indexion agent orient --no-update --task "name/content drift scoring and remediation planning" .`。
12. 编辑前阅读 `Likely Implementation Owners`：应拥有领域行为的核心 packages；除非后续证据反驳，将第一个条目作为初始 owner 假设。
13. 阅读 `Knowledge Sources`：匹配任务的 release notes、wiki pages、READMEs 或其他文档；将其用作上下文；不要把仅文档路径当作实现领域行为的地方。
14. 阅读 `Consumer Surfaces`：可能调用核心的 CLI、skills、docs 或 adapters。
15. 阅读 `Do Not Implement Here`：避免作为领域实现目标的文件。
16. 阅读 `Required Preflight`：打补丁前应阅读的文件。
17. 阅读 `Orientation Map`：确认显示截断前使用的总 file/owner/documentation corpus。
18. 用聚焦工具确认 owner：`indexion doc graph --format=text <likely-owner>`、`indexion grep --semantic=name:<term> .`、`indexion search "<task concept>" .`。
19. 使用 brief 和用户任务中的区分性术语，而不仅是宽泛的基础设施词。
20. 如果搜索结果偏离到支撑系统而非 likely owner，在更换 owner 前，用 name/content、drift、divergence 或实际定义任务的领域特定术语细化查询。
21. 实施门禁：如果预期编辑路径出现在 `Do Not Implement Here`，停止并解释冲突。
22. 如果预期 owner 未出现在 `Likely Implementation Owners`，用 `doc graph`、`grep`、`search` 或 `explore` 收集更多证据。
23. 除非 brief 和后续证据表明 CLI 拥有该行为，保持 CLI 代码薄。
24. 用于零知识委派：只给子代理任务和生成的 orientation brief，然后在分配实现工作前对它进行测验。
25. 测验应要求子代理立即说出核心实现 owner、一个 knowledge source、一个不安全编辑位置和一个 preflight evidence path；通过该测验是预构建 map 已传递正确 ownership assumptions 的信号。
26. Claude Code 映射：将稳定指导存入 `CLAUDE.md`，将项目命令存入 `.claude/commands/`，将项目子代理存入 `.claude/agents/`。
27. Codex 映射：将稳定指导存入 `AGENTS.md` 或 skills，并将 orientation brief 粘贴到委派任务上下文中。
28. 多 agent workflows：将 brief 用作结构化 handoff payload，使每个隔离 agent 从相同的仓库特定假设开始。

适用边界 · 注意事项

• 已安装的 `indexion` CLI 缺少 `indexion agent orient`，且无法更新或重建时。
• 代码库和任务已经熟悉、明确，不需要推断 owner 或生成结构 brief 时。
• 任务不是代码实现或编辑，不需要仓库所有权结构预检时。