AI Skills
indexion-agent-orient

indexion-agent-orient

生成并使用预编辑结构简报，使编码代理在实施前了解可能的负责人、消费界面和不安全的编辑位置。

1Star
2Fork
更新于 2026/7/11
获取 Skill源代码

相关 Skills

apple-hig8.4万i18n8.1万paperclip-create-agent7.5万
SKILL.md
readonly只读
name
indexion-agent-orient
description

生成并使用预编辑结构简报，使编码代理在实施前了解可能的负责人、消费界面和不安全的编辑位置。

代理定向工作流

在代码库中不熟悉或模糊的部分开始实施之前，使用此技能。

为什么

编码代理通常会锚定用户提示中的路径或名词，并在了解仓库的所有权结构之前就开始编辑。indexion agent orient 在选定的代码库中构建增量定向地图，然后生成一个简短的、基于证据的简报，可以粘贴到 AGENTS.md、CLAUDE.md、Claude 斜杠命令、Codex 技能或子代理提示中。

渲染的 --limit 仅是显示限制。负责人推断必须来自完整的预建地图，包括代码结构、包 README 和 wiki 页面，这些页面的来源由 wiki pages update、wiki pages ingest 和 plan reconcile 维护。

负责人档案使用包文档和特定负责人的 wiki 页面。具有多个源根的宽泛 wiki 页面是有用的背景，但不应被视为每个引用的包都拥有该任务的证据。

流程

  1. 验证已安装的 CLI 具有此工作流：

    indexion agent orient --help

    如果缺少此命令，请在继续之前更新或重建 indexion。在 PATH 中有较旧的 indexion 二进制文件不足以使用此技能。

  2. 生成简报：

    indexion agent orient --task-file task.md --output=.indexion/cache/agent/orient.md .

    首次运行会写入 .indexion/cache/agent/orient-map.json。后续运行仅刷新更改的文件和受影响的负责人档案。当你故意想查询保存的地图而不刷新时，使用 --no-update。当零知识代理需要从最新的预建地图中立即获得负责人猜测时，应使用此模式。

    对于简短任务：

    indexion agent orient --task "添加名称/内容漂移审计" .

    如果用户任务的语言或措辞未出现在仓库的标识符和 README 散文中，请在笔记中保留原始任务，并将简短的代码库词汇注释传递给 --task。该注释应描述目标，而不是怀疑的负责人。例如，说“检测名称与实现内容之间的漂移”，而不是命名一个你尚未确认的包。

    不要将支持基础设施约束放入负责人推断的 --task 注释中。将原始请求、所需工具和实施约束保留在你的笔记或子代理提示中。注释仅用于查询预建地图的目标词汇，例如：

    indexion agent orient --no-update --task "名称/内容漂移评分和修复规划" .

  3. 在编辑前阅读以下部分：

    • Likely Implementation Owners：应拥有领域行为的核心包。
      将第一个条目视为初始负责人假设，除非后续证据与之矛盾。
    • Knowledge Sources：与任务匹配的发布说明、wiki 页面、README 或其他文档。将这些作为上下文；不要将仅文档路径视为实现领域行为的地方。
    • Consumer Surfaces：可能调用核心的 CLI、技能、文档或适配器。
    • Do Not Implement Here：应避免作为领域实现目标的文件。
    • Required Preflight：代理在修补前应读取的文件。
    • Orientation Map：确认显示截断前使用的总文件/负责人/文档语料库。

  4. 使用聚焦工具确认负责人：

    indexion doc graph --format=text <likely-owner>
indexion grep --semantic=name:<term> .
indexion search "<任务概念>" .

    使用简报和用户任务中的区分性术语，而不仅仅是宽泛的基础设施词汇。如果搜索结果偏向支持系统而不是可能的负责人，请使用实际定义任务的名称/内容、漂移、差异或领域特定术语来优化查询，然后再更改负责人。

  5. 把关实施：

    • 如果预期的编辑路径出现在 Do Not Implement Here 中，停止并解释冲突。
    • 如果预期的负责人不在 Likely Implementation Owners 中，使用 doc graph、grep、search 或 explore 收集更多证据。
    • 保持 CLI 代码精简，除非简报和后续证据显示它拥有该行为。

  6. 用于零知识委派：

    仅给子代理任务和生成的定向简报，然后在分配实施工作前对其进行测验。它应立即命名核心实施负责人、一个知识来源、一个不安全的编辑位置和一个预检证据路径。通过该测验表明预建地图已传递了正确的所有权假设。

外部代理映射

  • Claude Code：将稳定指导存储在 CLAUDE.md 中，项目命令存储在 .claude/commands/ 中，项目子代理存储在 .claude/agents/ 中。
  • Codex：将稳定指导存储在 AGENTS.md 或技能中，并将定向简报粘贴到委派任务上下文中。
  • 多代理工作流：使用简报作为结构化交接负载，以便每个隔离代理从相同的仓库特定假设开始。