convez.ai
SkillAutomaçãoAvançado
xuiltul

Claude Skill Codex

xuiltul/claude-skill-codex

Delegue implementação ao Codex com Claude supervisionando

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que delega tarefas de implementação ao OpenAI Codex CLI em modo autônomo. Claude atua como Product Manager (planejamento e revisão) enquanto Codex executa a engenharia, com loop de retentativas até completar critérios verificáveis.

Instalação

$npx convez-ai xuiltul/claude-skill-codex

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Refatoração de código em larga escala com supervisão
  • Implementação autônoma de features com planos verificáveis
  • CI/CD e automação de testes durante desenvolvimento

Veredito

Integração sofisticada que transforma Claude Code em orquestrador de Codex CLI. Requer Codex autenticado e planos bem estruturados — ideal para equipes que já usam ambos, mas a curva de aprendizado é íngreme.

README

A tradução para o português deste README ainda está na fila.

claude-skill-codex

日本語 README

A Claude Code skill that delegates implementation tasks to OpenAI Codex CLI as an autonomous sub-engineer.

Claude acts as the PdM (planning, progress monitoring, deliverable review) while Codex acts as the implementation engineer, running unattended in goal mode until verifiable completion criteria are met.

How it works

You: "/codex docs/plans/20260612_refactor.md"
          │
          ▼
Claude (PdM)
  1. Validates the plan: tasks, verifiable completion criteria,
     build/test commands, constraints
  2. Launches scripts/run_codex.sh in the background
          │
          ▼
Codex CLI (engineer, goal mode)
  - Creates a goal via the create_goal tool
  - Implements, builds, tests, fixes — loops autonomously
  - Auto-resumed up to 5 times until the final message
    contains the GOAL_COMPLETE marker
          │
          ▼
Claude (PdM review)
  - Cross-checks git diff against the plan (no out-of-scope changes)
  - Re-runs build/test commands itself (never trusts self-reports)
  - Sends fixes back via `codex exec resume`, or reports to you

Key design points:

  • Plan-file driven: goals have a 4,000-char limit, so the goal points to a plan file — the officially recommended pattern
  • Marker-based completion detection (GOAL_COMPLETE in the final message) instead of relying on the goal tool, which has known issues in non-interactive mode
  • Quality gate: plans without verifiable completion criteria are never submitted (they break Codex's stopping condition)
  • Session policy: once triggered, all subsequent implementation work in the session is also delegated to Codex

Requirements

Install

git clone https://github.com/xuiltul/claude-skill-codex ~/.claude/skills/codex

That's it. Trigger it in Claude Code with /codex <plan-file> or phrases like "codexで実装" / "implement this with codex".

The default SKILL.md is in Japanese. For an English skill body, swap in the translation:

cd ~/.claude/skills/codex && cp SKILL.en.md SKILL.md

Usage

# With an existing plan file
/codex docs/plans/20260612_add-auth.md

# Without a plan — Claude writes one first, then delegates
codexで実装して: ユーザー認証をJWTベースに移行

The runner script can also be used standalone:

~/.claude/skills/codex/scripts/run_codex.sh \
  -C /path/to/repo \
  -p /absolute/path/to/plan.md \
  [-r 5] [-m gpt-5.5] [-e xhigh] [-L /tmp/codex-runs/...]

Exit codes: 0 = completed, 2 = resume limit reached (incomplete), 3 = codex execution error. Logs go to /tmp/codex-runs/<timestamp>/.

Files

FilePurpose
SKILL.mdSkill definition (Japanese) — workflow, plan template, review checklist
SKILL.en.mdEnglish translation of the skill definition
scripts/run_codex.shGoal-mode runner with auto-resume loop
references/codex-cli.mdCodex CLI reference: exec options, goals spec, resume constraints, troubleshooting (Japanese)
references/codex-cli.en.mdEnglish translation of the reference

License

MIT

Ver o original no GitHub

Bom para

Relacionados