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

codex-issue-coordinator — скилл для Claude Code

Скилл codex-issue-coordinator запускает отдельных AI-воркеров на каждую задачу из списка или вехи GitHub, следит за их PR и тестами, и сам мержит, когда всё готово. Подходит, когда нужно обработать пачку задач в одном потоке Codex.

MIT 241 установок ★ 438 обновлён 2026-10-24

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

Что делает codex-issue-coordinator

codex-issue-coordinator берёт родительскую задачу или список issues и создаёт для каждой отдельный воркер — свой файловый контекст, ветку и pull request. Координатор остаётся в основном потоке, ждёт результатов и решает, мержить ли. Воркер сам пишет код, добавляет тесты и отправляет на ревью; после прохождения всех проверок может замержить PR, если ему дали права — или оставить на ручное согласование.

Это даёт контекст каждой задаче отдельно, вместо того чтобы пихать всё в один запрос. GitHub служит единым источником состояния: координатор читает граф зависимостей, не создаёт второй трекер. Воркеры не могут развёртывать, пубиковать релизы или менять код вне списка — только коммитить в свою ветку. Требует Codex или Claude Code с поддержкой многопоточности и worktrees.

По умолчанию работает максимум с двумя воркерами одновременно. Скилл читает требования прямо из файлов SKILL.md в каждом инструменте, а не через команды, которые могут быть заблокированы.

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

  • обработать несколько GitHub issues одним AI-потоком с отдельным контекстом для каждой
  • запустить параллельные PR с автоматическими тестами и ревью для пачки задач
  • координировать зависимости между задачами и мержить PR в правильном порядке
  • отследить граф зависимостей и остановиться, если возникла циклическая зависимость

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

  • Обработай все open issues из вехи v2.0 в GitHub, каждую в отдельном PR
  • Координируй три связанные задачи: #42, #43, #44, дай каждой воркера и мержь PR после ревью
  • Запусти воркеры на issues из проекта, но не мержь сам — оставь PR на ручное согласование

Как установить codex-issue-coordinator

1Через Skills CLI (Vercel)

npx skills add owainlewis/blueprint --skill codex-issue-coordinator -a claude-code

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

~/.claude/skills/codex-issue-coordinator/SKILL.md

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

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

Вопросы о codex-issue-coordinator

Как установить codex-issue-coordinator в Claude Code?

Запусти npx skills add owainlewis/blueprint --skill codex-issue-coordinator -a claude-code, потом открой ~/.claude/skills/codex-issue-coordinator/SKILL.md. Для Codex команда другая: npx skills add owainlewis/blueprint --skill codex-issue-coordinator -a codex, затем .agents/skills/codex-issue-coordinator/SKILL.md.

Что делает codex-issue-coordinator?

Создаёт отдельного воркера для каждой задачи GitHub, чтобы каждый писал код в своей ветке, прогонял тесты и отправлял PR на ревью. Координатор следит за зависимостями и при необходимости мержит PR сам или оставляет на ручное согласование.

Нужны ли воркерам права на мёрж PR?

Нет, по умолчанию воркеры оставляют PR на ревью. Права на мёрж дают явно, если пользователь в промпте разрешает координатору мержить или упоминает /codex-issue-coordinator по имени. Без явного разрешения скилл работает в режиме «без мёржа».

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

SKILL.md · MIT
---
name: codex-issue-coordinator
description: "Coordinates a large batch of GitHub issues through separate Codex worker threads, tested pull requests, review loops, and gated merges. Use when the user asks one Codex thread to manage several coding sessions or complete a parent issue, milestone, or issue batch."
user-invocable: true
argument-hint: "<parent issue, milestone, or issue list>"
disable-model-invocation: true
---

# Codex issue coordinator

Use one Codex thread to coordinate a GitHub issue batch. Give each active issue
its own worker thread, worktree, branch, and pull request. Workers hold
implementation context. GitHub holds dependency state.

Explicitly naming `/codex-issue-coordinator`, or explicitly telling the
coordinator that agents may merge, authorizes in-scope workers to merge their
own pull requests after every merge gate below passes. An implicit skill match
does not grant merge authority: run in no-merge mode unless the user's words
grant it.
Neither mode authorizes deployment, release publication, destructive
operations, branch-protection bypasses, or changes outside the supplied batch.

Read required skills directly from their `SKILL.md` files as instructions for this workflow. Do not invoke them through a skill command that the client blocks.

## Preconditions

1. Read the repository instructions, parent issue, native sub-issues, declared
   dependencies, project board, issue state, and linked open or merged pull
   requests. A merged pull request is only evidence of completion when it
   closes or explicitly references the issue and its final change and proof
   satisfy the issue scope. Reconcile that issue and project state instead of
   dispatching it again. Do not infer completion from a link alone.
2. Use Codex thread tools. If visible Codex threads and Codex-managed worktrees
   are unavailable, stop. Do not replace workers with hidden subagents.
3. Make every issue a complete task before dispatch. If a missing product or
   technical decision could change behavior, data, security, compatibility,
   operations, cost, or proof, mark that issue as needing human input.
4. Build a dependency graph. Treat GitHub as the durable source of issue, pull
   request, review, and merge state. Stop for human correction if the graph
   contains a dependency cycle. Do not create a second local tracker.
5. Default to two active workers. Use another limit only when the user asks or
   the repository gives a stricter limit.

## Coordinator workflow

1. Keep the calling thread as coordinator. Name it `#<parent> Coordinator` when
   the batch has a parent issue. Use `set_thread_pinned` to pin it at the start
   of every new or resumed coordinator run, before inspecting or dispatching
   workers.
2. Reuse an existing active worker for the same issue. Inspect an unclear or
   interrupted worker before creating another. If the issue already has an
   open pull request, create or resume its worker on that pull request's exact
   head branch and include the branch and pull request URL in its prompt.
   Otherwise create a Codex project thread in a managed worktree from the
   latest remote default branch and include the required new branch name.
3. Name every worker `#<issue-number> <short title>`.
4. Start only issues whose prerequisites are merged. Independent issues may
   run together up to the worker limit. Do not stack dependent branches in
   this workflow.
5. Give the worker the full issue URL, dependency state, repository location,
   resolved branch and pull request state, and the worker contract below. Tell
   it to use `/task-to-pr` and pass the coordinator's explicit merge or
   no-merge mode. Merge mode grants authority only for that worker's issue.
6. Monitor workers with compact `wait_threads` snapshots. Use `read_thread`
   only when a worker needs help. Send decisions or corrected scope back with
   `send_message_to_thread`; do not edit the worker's files from the
   coordinator.
7. Continue independent work when one issue is blocked. After three failed
   attempts at the same check or review finding, pause that issue, record the
   evidence on GitHub, and request human input.
8. In merge mode, when a worker reports completion, verify GitHub says the pull
   request is merged, the issue contains final proof, and the issue is closed.
   Close it explicitly if the merged pull request did not close it. Then mark
   the issue Done when the project supports it and archive the worker thread.
   In no-merge mode, stop that worker after its pull request passes all
   agent-completable gates, leave the issue in Review, record any pending human
   approval or merge as its blocker, and leave the thread available.
9. Refresh the dependency graph after every merge and dispatch newly ready
   issues from the updated remote default branch. In no-merge mode, when a
   dependent issue is waiting only for a passing prerequisite pull request to
   be merged, record that human-merge dependency as its blocker. Do not wait
   indefinitely or dispatch the dependent from an unmerged branch.
10. In merge mode, finish only when every in-scope issue is merged, closed, and
    Done when the project supports that state, or every unfinished issue has a
    recorded blocker that needs human action. In no-merge mode, finish when
    every in-scope issue has a ready pull request with all agent-completable
    gates passing or a recorded human blocker.

## Worker contract

Each worker owns one issue and follows this order:

1. Read the issue, repository instructions, relevant spec, code, tests, and
   dependency pull requests. Move the issue to In Progress when possible.
2. Use the Codex-managed worktree. If the issue has an open pull request, reuse
   its exact head branch and pull request. Otherwise create the repository's
   required issue-linked branch from the updated default branch.
3. Implement only the issue. Add or update tests for every acceptance
   criterion, affected failure path, regression risk, and named edge case.
4. Use `/test`. Browser-facing work requires a real browser check of the
   affected success and failure flows, responsive widths, keyboard behavior,
   console errors, and failed requests when relevant.
5. Commit and push the tested change. Open a draft pull request if one is not
   already open. Include a short summary and current proof.
6. Mark the pull request ready for review and move the issue to Review. Do this
   before requesting independent review or waiting for GitHub review.
7. Use `/review` with a fresh subagent that did not implement the change. Wait
   for required CI and automated review. In merge mode, also wait for every
   repository-required approval. In no-merge mode, do not wait indefinitely
   for human feedback; record a pending required approval as a human blocker.
8. Address every valid in-scope finding. Reply to review threads with the fix
   or evidence for making no change. Resolve a thread only when it is fully
   addressed.
9. After any code change, repeat affected `/test` proof and fresh `/review`,
   commit and push, update the pull request evidence, and wait for CI and
   automated review again. Iterate until the mode's gates pass; do not
   manufacture extra rounds or wait indefinitely for optional human feedback.
10. In merge mode, merge the pull request using the repository's preferred
    method after every merge gate passes. Never use an admin bypass. Wait until
    GitHub reports the pull request as merged, record final proof, and verify
    the issue is closed. Close it explicitly if the pull request did not. In
    no-merge mode, leave the passing pull request open for a human to merge.
    Report the final state to the coordinator.

## Merge gates

A worker may merge only when all of these are true:

- The pull request is ready for review, not draft.
- The complete issue scope and acceptance criteria have recorded proof.
- Focused and required wider tests pass on the final commit.
- A fresh `/review` verdict is `Approve` on the final code.
- Every required GitHub check passes.
- Every actionable automated or human review thread is resolved.
- Every repository-required approval is present.
- The pull request is mergeable and current with its required base.
- No security, data-loss, compatibility, operational, or product decision is
  unresolved.
- The pull request changes only the worker's issue.

If a gate cannot pass, do not merge. Record the blocker and continue other
independent work.

## Worker prompt

Use this shape and replace every placeholder:

```text
Use /task-to-pr to complete <issue URL> in this Codex-managed worktree.

Your thread owns only this issue, branch, worktree, and pull request.
Branch state: <reuse PR head branch and PR URL, or create new branch name>.
Delivery mode: <merge after all gates pass, or leave the passing PR open>.
Read the issue and repository instructions as the source of truth.
Implement the smallest complete change and prove acceptance criteria, edge
cases, failure paths, and regressions.

After local proof passes, commit, push, open or update the pull request, and
mark it ready for review. Only then run fresh independent /review and wait for
CI and GitHub review. Address valid findings and repeat test and review after
every code change.

<If merge mode: The user explicitly authorized this /codex-issue-coordinator run to
merge this issue's pull request after every merge gate passes. Wait until
GitHub reports the merge, update and close the issue, and return the result.>
<If no-merge mode: Leave the passing pull request open for human merge and
return its URL and proof.>
Do not deploy, publish a release, bypass repository rules, or change unrelated
work.
```

## Return

For each issue, report its worker, pull request, gate state, and blocker. State
which issues are complete and which need human action. Do not repeat worker
logs that do not change the result.

## Boundaries

- Use visible Codex threads for workers. Fresh subagents are only for the
  independent `/review` inside a worker.
- Never dispatch two workers for one issue or let two workers share a worktree.
- Never replace or duplicate an existing pull request for the issue. Resume it.
- Reconcile already-merged pull requests and closed issues before dispatch,
  but only after their change and proof satisfy the issue scope.
- Never start dependent work from an unmerged pull request in this workflow.
- Never merge an unrelated pull request merely because it blocks the batch.
- Never infer deployment or release authority from merge authority.
- Do not archive a worker until its merge and final issue state are verified.

© owainlewis · MIT · owainlewis/blueprint

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
fix-issue frappe Скилл fix-issue проводит агента от отчёта об ошибке до правки с тестом: субагент вытаскивает из issue только факты, догадки автора остаются в стороне. CX Codex +1 431установок resolve-issue sentimony Скилл resolve-issue для Claude Code и Codex ведёт задачу из GitHub через весь цикл разработки от анализа до приёмки. Запускается по номеру или ссылке на задачу для пошагового контроля или в режиме --auto. CX Codex +1 1 200установок issue-tracer ZaxbyHub Субагент issue-tracer, который доводит GitHub issue от репорта до плана исправления. Собирает доказательства, находит корневую причину и не трогает код, пока вы не подтвердите план. CX Codex +1 ★ 539звёзд репо issue-reporting manojbajaj95 Скилл issue-reporting для Claude Code собирает детали сбоя скилла из claude-gtm-plugin и готовит GitHub issue. Оформляет жалобы на неверный совет или несработавший скилл. CX Codex +1 118установок issue-tracer2 ZaxbyHub Субагент issue-tracer2 берёт GitHub Issue, ищет причину бага в коде по цепочке гипотез и доводит дело до фикса, тестов и PR. CX Codex +1 ★ 539звёзд репо post-issue-comment dyoshikawa Скилл post-issue-comment для Claude Code собирает контекст GitHub issue, пишет короткий ответ на английском и публикует его. Учитывает всю дискуссию в ответе. CX Codex +1 ★ 1 636звёзд репо

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

plan Скилл plan делит спецификацию на законченные вертикальные срезы, каждый из которых агент сдаёт в одном pull request. Срабатывает при планировании крупной задачи перед написанием кода. CX Codex +1 788установок review Скилл review для Claude Code и Codex запускает изолированное ревью изменений без права записи. Проверяет совпадение со спецификацией, безопасность и поведение кода на некорректных данных. CX Codex +1 787установок task-to-pr Скилл task-to-pr ведёт задачу от тикета до открытого pull request: ветка, тесты, Conventional Commit, проверка CI и независимое ревью. Мержит только по явной команде. CX Codex +1 452установок spec Скилл spec для Claude Code и Codex формирует спецификацию отдельной фичи перед написанием кода. Он описывает пользовательские сценарии и технический дизайн в виде готового тикета. CX Codex +1 440установок improve Скилл improve для Claude Code упрощает существующий код, сохраняя его поведение. Агент ищет дубли, мёртвый код, слабые имена и лишние абстракции. CX Codex +1 372установок architecture-review Скилл architecture-review для Claude Code и Codex анализирует RFC, ADR или технические спецификации до написания кода. Проверяет архитектурные решения, риски безопасности и сценарии сбоев. CX Codex +1 347установок architecture Создаёт или обновляет файл ARCHITECTURE.md в корне проекта по шаблону. Сверяет требования с кодовой базой и фиксирует системные границы. CX Codex +1 331установок html-doc Скилл html-doc превращает готовый Markdown PRD или технический дизайн в статическую HTML-страницу для чтения в браузере. Он также проверяет результат. CX Codex +1 288установок

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

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