К основному содержанию
скилл CX Codex

indexion-agent-orient — скилл для Claude Code

Скилл indexion-agent-orient строит карту владельцев кода до начала правок, чтобы агент не трогал чужие пакеты и критичные файлы.

Apache-2.0 4 900 установок ★ 2 обновлён 2026-09-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add trkbt10/indexion-skills --skill indexion-agent-orient -a claude-code
Открыть на GitHub

Что делает indexion-agent-orient

Скилл запускает indexion agent orient — команду, которая сканирует кодовую базу, определяет, какие пакеты владеют запрошенной функцией, и выдаёт краткую справку с вероятными владельцами, файлами для чтения перед правкой и местами, куда нельзя лезть. Справка попадает в CLAUDE.md, .claude/commands/ или передаётся субагенту как контекст.

Внутри — инкрементальная карта .indexion/cache/agent/orient-map.json, которая обновляет только изменённые файлы и профили владельцев. Флаг --no-update даёт мгновенный ответ из готовой карты без пересканирования. Для работы нужна установленная CLI indexion со встроенной командой agent orient. Если indexion agent orient --help не отвечает, бинарник устарел и не подойдёт.

Какие задачи решает

  • Определить, кому принадлежит функция, до начала правок
  • Не править CLI или адаптеры вместо основного пакета
  • Передать субагенту контекст о структуре владельцев
  • Построить карту кода для нулевого агента без истории
  • Избежать правок в критичных файлах без проверки

Примеры запросов агенту

  • Построй карту владельцев для задачи из task.md командой indexion agent orient --task-file task.md --output=.indexion/cache/agent/orient.md .
  • Определи владельца функции аудита дрифта имён и содержимого через indexion agent orient --task "detect drift between names and implementation contents" .
  • Покажи краткую справку о владельцах из готовой карты командой indexion agent orient --no-update --task "name/content drift scoring" .

Как установить indexion-agent-orient

1Через Skills CLI (Vercel)

npx skills add trkbt10/indexion-skills --skill indexion-agent-orient -a claude-code

2Вручную: положить файлы

~/.claude/skills/indexion-agent-orient/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/indexion-agent-orient/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об indexion-agent-orient

Как установить indexion-agent-orient в Claude Code?

Запусти npx skills add trkbt10/indexion-skills --skill indexion-agent-orient -a claude-code, справка появится в ~/.claude/skills/indexion-agent-orient/SKILL.md.

Что делает indexion-agent-orient?

Строит карту владельцев кода, определяет вероятных владельцев функции, файлы для чтения перед правкой и места, куда агенту нельзя лезть. Справка попадает в CLAUDE.md или передаётся субагенту.

Что нужно для работы indexion-agent-orient?

Установленная CLI indexion со встроенной командой agent orient. Проверь через indexion agent orient --help — если команда не найдена, бинарник нужно обновить.

Исходный текст

SKILL.md · Apache-2.0
---
name: indexion-agent-orient
description: Generate and use a pre-edit structure brief so coding agents learn likely owners, consumer surfaces, and unsafe edit locations before implementing.
---

# Agent Orientation Workflow

Use this skill before starting implementation in an unfamiliar or ambiguous part
of a codebase.

## Why

Coding agents often anchor on the path or noun in the user prompt and start
editing before they have learned the repository's ownership structure. `indexion
agent orient` builds an incremental orientation map across the selected
codebase, then renders a short, evidence-backed brief that can be pasted into
AGENTS.md, CLAUDE.md, a Claude slash command, a Codex skill, or a subagent prompt.

The rendered `--limit` is only a display limit. Owner inference must come from
the full prebuilt map, including code structure, package READMEs, and wiki pages
whose provenance is maintained by `wiki pages update`, `wiki pages ingest`, and
`plan reconcile`.

Owner profiles use package documentation and owner-specific wiki pages. Broad
wiki pages with multiple source roots are useful background, but they should not
be treated as proof that every referenced package owns the task.

## Pipeline

0. Verify the installed CLI has this workflow:

   ```bash
   indexion agent orient --help
   ```

   If this command is missing, update or rebuild indexion before continuing.
   Having an older `indexion` binary in PATH is not enough for this skill.

1. Generate the brief:

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

   The first run writes `.indexion/cache/agent/orient-map.json`. Later runs
   refresh changed files and affected owner profiles only. Use `--no-update`
   when you intentionally want to query the saved map without refreshing it.
   This is the mode to use when a zero-knowledge agent needs an immediate
   owner guess from the latest prebuilt map.

   For short tasks:

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

   If the user task is in a language or wording that does not appear in the
   repository's identifiers and README prose, keep the original task in your
   notes and pass a short codebase-vocabulary gloss to `--task`. The gloss
   should describe the objective, not the suspected owner. For example, say
   "detect drift between names and implementation contents" instead of naming a
   package you have not confirmed.

   Do not put supporting infrastructure constraints into the owner-inference
   `--task` gloss. Keep the original request, required tools, and implementation
   constraints in your notes or subagent prompt. The gloss is only the objective
   vocabulary used to query the prebuilt map, for example:

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

2. Read these sections before editing:

   - `Likely Implementation Owners`: core packages that should own domain
     behavior.
     Treat the first entry as the initial owner hypothesis unless follow-up
     evidence contradicts it.
   - `Knowledge Sources`: release notes, wiki pages, READMEs, or other
     documentation that matched the task. Use these as context; do not treat a
     documentation-only path as the place to implement domain behavior.
   - `Consumer Surfaces`: CLI, skills, docs, or adapters likely to call the core.
   - `Do Not Implement Here`: files to avoid as domain implementation targets.
   - `Required Preflight`: files the agent should read before patching.
   - `Orientation Map`: confirms the total file/owner/documentation corpus used
     before display truncation.

3. Confirm the owner with focused tools:

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

   Use the distinguishing terms from the brief and the user task, not only the
   broad infrastructure words. If search results drift toward supporting
   systems instead of the likely owner, refine the query with the name/content,
   drift, divergence, or domain-specific terms that actually define the task
   before changing the owner.

4. Gate implementation:

   - If the intended edit path appears in `Do Not Implement Here`, stop and
     explain the conflict.
   - If the intended owner is absent from `Likely Implementation Owners`, gather
     more evidence with `doc graph`, `grep`, `search`, or `explore`.
   - Keep CLI code thin unless the brief and follow-up evidence show it owns the
     behavior.

5. Use for zero-knowledge delegation:

   Give a subagent only the task and the generated orientation brief, then quiz
   it before assigning implementation work. It should immediately name the core
   implementation owner, one knowledge source, one unsafe edit location, and one
   preflight evidence path. Passing that quiz is the signal that the prebuilt map
   has transferred the right ownership assumptions.

## External Agent Mapping

- Claude Code: store stable guidance in `CLAUDE.md`, project commands in
  `.claude/commands/`, and project subagents in `.claude/agents/`.
- Codex: store stable guidance in AGENTS.md or skills, and paste the orientation
  brief into delegated task context.
- Multi-agent workflows: use the brief as the structured handoff payload so each
  isolated agent starts with the same repository-specific assumptions.

© trkbt10 · Apache-2.0 · trkbt10/indexion-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
security-ownership-map официальный openai Скилл security-ownership-map строит карту «люди — файлы» из git-истории, считает bus factor и находит чувствительный код, за который отвечает слишком мало людей. CX Codex +1 4 200установок repo-audit zebbern Скилл repo-audit анализирует историю Git: находит частые изменения в файлах, распределение авторов и утечки секретов в коммитах. CX Codex +1 ★ 4 719звёзд репо codesight-ai-context reason-machines Скилл codesight-ai-context для Claude Code и других ИИ-инструментов: собирает карту кодовой базы, wiki и конфигурации в единый контекстный файл. Даёт агенту готовое описание структуры проекта. CX Codex +1 559установок orient wrg32786 Скилл orient для Claude Code помогает сориентироваться в структуре проекта, правилах и распределении задач. Запускается, когда нужно найти нужный раздел или понять, что делать дальше. CX Codex +1 ★ 26звёзд репо layers-orient jamiemill Скилл layers-orient в Claude Code проверяет решения по семи слоям продукта, находит узкое место и предлагает, с какого скилла продолжить. Определяет самый нижний нерешённый слой, который создаёт риск для остальных. CX Codex +1 2 000установок devmap itsflaid MCP-сервер devmap для Claude Code отвечает на вопросы о маршрутах, функциях, файлах и связях в проекте. Анализ строит карту кода, а агент получает её через инструменты. CX Codex +1 ★ 11звёзд репо

Из того же набора9

indexion-readme Скилл indexion-readme собирает README из шаблонов, doc-комментариев и статических файлов, а потом проверяет, что правки ничего не удалили. CX Codex +1 5 100установок indexion-refactor Скилл indexion-refactor находит текстовые, структурные и концептуальные дубли в кодовой базе через CLI-утилиту indexion. Помогает вынести общий код в пакеты и убрать лишние функции-обёртки. CX Codex +1 5 000установок indexion-documentation Скилл indexion-documentation оценивает покрытие документации, ищет расхождения между кодом и доками и рисует граф зависимостей. CX Codex +1 5 000установок indexion-sdd Скилл indexion-sdd для Claude Code превращает RFC или спецификацию в SDD-требования и количественно сверяет их с кодом. Удерживает реализацию в рамках документа. CX Codex +1 5 000установок indexion-identity Скилл indexion-identity проверяет, совпадают ли имена функций, файлов и папок с их содержимым, и планирует переименования. Пригодится при рефакторинге. CX Codex +1 4 900установок indexion-wiki Регламент для агента по ведению вики проекта в .indexion/wiki/: создание страниц, отслеживание устаревания по хешам кода и проверка связей. CX Codex +1 4 900установок indexion-kgf Скилл indexion-kgf показывает токены, события парсинга и извлечённые рёбра зависимостей из файлов, чтобы разобраться, как indexion обрабатывает исходники. CX Codex +1 4 900установок indexion-segment Скилл indexion-segment для Claude Code и Codex режет документы на смысловые куски для RAG и эмбеддингов. Делит текст по смене темы, а не по количеству символов. CX Codex +1 4 900установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой