mcpField
I
indexion-agent-orient

indexion-agent-orient

github.com/trkbt10Agent 工作流24.9k 次安装5 周前更新
代码仓库

关于 indexion-agent-orient

供编码 Agent 使用的工作流技能，可梳理陌生代码库中的代码归属，并在实现前生成有证据支持的导览简报。

主要功能

  1. 01增量构建代码库导览图
  2. 02提供有证据的归属建议
  3. 03生成 Agent 交接简报
  4. 04指导确认代码归属
  5. 05实现前检查编辑风险

适用场景

  1. 01修改陌生代码前熟悉项目
  2. 02向独立 Agent 委派任务
  3. 03选择编辑路径前核实归属

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/trkbt10/indexion-skills --skill indexion-agent-orient

安装后在 Claude Code 中输入/indexion-agent-orient确认已加载。

详细介绍

Agent 代码库认知工作流

在陌生或职责边界不明确的代码库部分开始实现前，请先使用此技能。

原因

编码 Agent 往往会根据用户提示中的路径或名词形成先入之见，并在了解代码库的所有权结构之前就开始编辑。indexion agent orient 会为选定的代码库逐步构建认知地图，然后生成一份简短且有依据的说明，可粘贴到 AGENTS.md、CLAUDE.md、Claude 斜杠命令、Codex 技能或子 Agent 提示词中。

渲染后的 --limit 仅限制显示内容。所有者推断必须基于完整的预构建地图，包括代码结构、软件包 README，以及由 wiki pages update、wiki pages ingest 和 plan reconcile 维护来源信息的 Wiki 页面。

所有者档案使用软件包文档和所有者专属 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。当零知识 Agent 需要 根据最新的预构建映射立即猜测所有者时，应使用此模式。

    对于简短任务：

    indexion agent orient --task "add a name/content drift audit" .

    如果用户任务所用的语言或措辞未出现在仓库的标识符和 README 文案中， 请在笔记中保留原始任务，并向 --task 传入简短的代码库词汇释义。 释义应描述目标，而不是猜测的所有者。例如，可以说 “检测名称与实现内容之间的偏差”，而不要提及尚未确认的包名。

    不要将支持性基础设施约束放入用于推断所有者的 --task 释义中。 请将原始请求、必需工具和实现约束保留在笔记或子 Agent 提示词中。 释义仅用于提供查询预构建映射的目标词汇，例如：

    indexion agent orient --no-update --task "name/content drift scoring and remediation planning" .

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

    • Likely Implementation Owners：应负责领域行为的核心包。 除非后续证据与之矛盾，否则将第一项视为初始所有者假设。
    • Knowledge Sources：与任务匹配的发行说明、Wiki 页面、README 或其他 文档。请将这些内容用作背景信息；不要将仅包含文档的路径视为实现领域行为的位置。
    • Consumer Surfaces：可能调用核心的 CLI、技能、文档或适配器。
    • Do Not Implement Here：应避免用作领域实现目标的文件。
    • Required Preflight：Agent 应在修补前阅读的文件。
    • Orientation Map：确认显示内容截断前使用的文件、所有者和文档语料总量。

  4. 使用有针对性的工具确认所有者：

    indexion doc graph --format=text <likely-owner>
indexion grep --semantic=name:<term> .
indexion search "<task concept>" .

    使用简报和用户任务中的区分性术语，而不仅是宽泛的基础设施词汇。 如果搜索结果偏向支持系统，而不是可能的所有者，那么在更改所有者之前， 请使用实际定义任务的名称／内容、偏差或领域专用术语细化查询。

  5. 把关实现：

    • 如果预期的编辑路径出现在 Do Not Implement Here 中，请停止并 说明冲突。
    • 如果预期所有者不在 Likely Implementation Owners 中，请通过 doc graph、grep、search 或 explore 收集 更多证据。
    • 除非简报和后续证据表明 CLI 负责该行为，否则应保持 CLI 代码精简。

  6. 用于零知识委派：

    只向子 Agent 提供任务和生成的方向简报，然后在分配实现工作前对其进行提问。 它应能立即说出核心实现所有者、一个知识来源、一个不安全的编辑位置以及一个预检证据路径。 通过这项问答即可表明预构建映射已传递正确的所有权假设。

外部 Agent 映射

  • Claude Code：将稳定指南存放在 CLAUDE.md，将项目命令存放在 .claude/commands/，将项目子 Agent 存放在 .claude/agents/。
  • Codex：将稳定指南存放在 AGENTS.md 或技能中，并将方向简报粘贴到委派任务的上下文中。
  • 多 Agent 工作流：将简报用作结构化交接内容，以便每个相互隔离的 Agent 都基于相同的仓库特定假设开始工作。

评论

支持 Markdown