humanize-rlcr

Par polyarch · humanize

Démarre RLCR (Ralph-Loop with Codex Review) sur Codex en utilisant le hook Stop natif.

npx skills add https://github.com/polyarch/humanize --skill humanize-rlcr

Boucle RLCR Humanize

Utilisez ce flux comme point d'entrée Codex pour RLCR. Les installations Codex de Humanize nécessitent le support des hooks natifs et installent automatiquement les hooks Stop de Humanize.

Racine Runtime

L'installateur hydrate cette skill avec un chemin racine runtime absolu :

{{HUMANIZE_RUNTIME_ROOT}}

Toutes les commandes ci-dessous supposent {{HUMANIZE_RUNTIME_ROOT}}.

Séquence Requise

1. Configuration

Lancez la boucle avec le script de configuration :

"{{HUMANIZE_RUNTIME_ROOT}}/scripts/setup-rlcr-loop.sh" $ARGUMENTS

Si la configuration quitte avec un code non-zéro, arrêtez et signalez l'erreur.

2. Tour de travail

Pour chaque tour :

  1. Lisez le prompt de boucle actuel depuis .humanize/rlcr/<timestamp>/round-<N>-prompt.md (ou les fichiers prompt finalize pendant la phase finalize).
  2. Implémentez les modifications requises.
  3. Committez les modifications.
  4. Écrivez le fichier résumé requis :
    • Phase normale : .humanize/rlcr/<timestamp>/round-<N>-summary.md
    • Phase finalize : .humanize/rlcr/<timestamp>/finalize-summary.md
  5. Arrêtez ou quittez normalement.
  6. Laissez le hook Stop natif de Humanize s'exécuter automatiquement.
  7. Si le hook bloque la sortie, suivez exactement les instructions retournées et continuez le tour suivant.

Ce que cela impose

Le chemin du hook Stop natif impose :

  • validation d'état/schéma (current_round, max_iterations, review_started, base_branch, etc.)
  • vérifications de cohérence des branches
  • vérifications d'intégrité des fichiers de plan (le cas échéant)
  • blocage des Task/Todo incomplets
  • condition git-clean avant sortie
  • blocage des commits non poussés avec --push-every-round
  • vérifications de présence de résumé
  • gestion des itérations maximales
  • tours d'alignement complet (--full-review-round)
  • gestion stricte des marqueurs COMPLETE/STOP
  • protection de transition de phase de revue (marqueur .review-phase-started)
  • gating de code-review sur marqueurs [P0-9]
  • blocage dur en cas d'échec de revue codex ou sortie vide
  • gestion des questions ouvertes quand ask_codex_question=true

Règles Critiques

  1. Ne modifiez jamais manuellement state.md ou finalize-state.md.
  2. Ne contournez jamais un résultat de hook bloqué en déclarant l'achèvement manuellement.
  3. Ne lancez jamais codex exec / codex review ad-hoc à la place des transitions de phase gérées par le hook.
  4. Utilisez toujours les fichiers générés par la boucle (round-*-prompt.md, round-*-review-result.md) comme source de vérité.

Options

Passez celles-ci via setup-rlcr-loop.sh :

Option Description Défaut
path/to/plan.md Chemin du fichier de plan Requis sauf --skip-impl
--plan-file <path> Chemin de plan explicite -
--track-plan-file Appliquer l'immuabilité du plan suivi false
--max N Itérations maximales 42
--codex-model MODEL:EFFORT Modèle Codex et effort pour codex exec gpt-5.5:high
--codex-timeout SECONDS Timeout Codex 5400
--base-branch BRANCH Base pour la phase de revue auto-détecté
--full-review-round N Intervalle d'alignement complet 5
--skip-impl Démarrer directement en mode revue false
--push-every-round Exiger un push chaque tour false
--claude-answer-codex Laisser Claude répondre directement aux questions ouvertes false
--agent-teams Activer le mode agent teams false
--yolo Sauter le quiz et activer --claude-answer-codex false
--skip-quiz Sauter le Plan Understanding Quiz (implicite en mode skill) false

La phase de revue codex review s'exécute avec gpt-5.5:high.

Utilisation

# Démarrer avec le fichier de plan
/flow:humanize-rlcr path/to/plan.md

# Mode revue uniquement
/flow:humanize-rlcr --skip-impl

Annuler

"{{HUMANIZE_RUNTIME_ROOT}}/scripts/cancel-rlcr-loop.sh"

Skills similaires