16. Executor / Patrones de indicación de generación de código
ywc-sequential-executor , ywc-parallel-executor y ywc-code-gen son las tres Habilidades cuyas muchas opciones te hacen consultar repetidamente la sintaxis exacta.
16. Executor / Patrones de indicación de generación de código
ywc-sequential-executor, ywc-parallel-executor y ywc-code-gen son las tres Habilidades cuyas muchas opciones te hacen consultar repetidamente la sintaxis exacta. Esta página organiza los ejemplos por "lo que estás tratando de hacer ahora", no por el nombre de Skill. Encuentra tu tarea y copia el comando tal como está.
Concepto compartido: agrupar múltiples Tasks en un PR (--aggregate-pr, --group-name)
--aggregate-pr y --group-name funcionan como el mismo concepto tanto en ywc-sequential-executor como en ywc-parallel-executor. Una vez que lo entiendas aquí, puedes aplicar todos los ejemplos en las dos secciones Skill a continuación.
Sin --aggregate-pr (comportamiento por defecto): cada Task obtiene su propia rama de características y PR. Si procesas 5 Tasks, obtienes 5 PRs.
Con --aggregate-pr: todos los Tasks se fusionan en una rama compartida, ya sea en secuencia (secuencial) o por oleada (paralela), y después de que termina todo el lote, se abre un PR desde esa rama compartida. Desde el punto de vista de un revisor, parece un "lote completo" en lugar de "varios cambios relacionados".
| Úsalo cuando | No lo use cuando |
|---|---|
| Quieres agrupar Tasks fuertemente relacionados en una unidad de despliegue lógica (por ejemplo, 5 Tasks para notificación API + UI + migración) | Cada Task necesita una revisión independiente; en ese caso, el comportamiento predeterminado (1 PR por Task) es correcto |
| Quieres reducir el recuento de PR y la fatiga por revisión | Quieres identificar qué Task falló directamente a nivel PR |
Establezca el nombre de la rama compartida directamente con --group-name. Si se omite, se genera automáticamente como <base-branch>-<timestamp>, pero eso hace que sea más difícil saber más tarde qué rama representaba qué trabajo. Se recomienda un nombre explícito y significativo.
| Skill | Formato de nombre de rama compartida |
|---|---|
ywc-sequential-executor --aggregate-pr --group-name <name> | work/<name> |
ywc-parallel-executor --aggregate-pr --group-name <name> | aggregate/<name> |
Solo difiere el prefijo del nombre de la rama (work/ vs aggregate/); el principio de funcionamiento es el mismo: cada Task se fusiona localmente en la rama compartida, y al final se crea automáticamente un PR a partir de esa rama hacia la base, incluyendo la gestión de revisión/fusión de CI/bot. Esta rama compartida no es la rama base real: la base permanece intacta hasta que se fusiona el PR final.
ywc-sequential-executor - cuando quieres ejecutar Tasks en orden
Nota:
ywc-sequential-executoren sí no tiene un flag--tddpropio. El paso de implementación de cada Task sigue internamente el mismo TDD gate por defecto queywc-code-gen(confirmar una prueba que falla antes de implementar). Si necesitas el ritual completo RED → GREEN → REFACTOR con checkpoint commits por etapa, usa el flag--tddde la secciónywc-code-genmás abajo e inclúyelo explícitamente en la solicitud de implementación de ese Task.
Ejecute un Task con valores predeterminados
ywc-sequential-executor 000020-010ywc-sequential-executor 000020-010El modo predeterminado normal-pr maneja automáticamente la creación de PR -> CI -> revisión por el bot -> fusión.
Ejecutar automáticamente la revisión de código antes de abrir el PR
ywc-sequential-executor 000020-010 --review --base-branch developywc-sequential-executor 000020-010 --review --base-branch developEjecute múltiples Tasks a la vez y reciba la descripción de PR en japonés
ywc-sequential-executor 000020-010..000025-010 --review --pr-lang jaywc-sequential-executor 000020-010..000025-010 --review --pr-lang jaTermina rápido con la fusión local, sin un PR
ywc-sequential-executor 000020-010..000025-010 --review --local-merge --run-tests-locallyywc-sequential-executor 000020-010..000025-010 --review --local-merge --run-tests-locallyEn el modo PR, CI ejecuta pruebas por ti. Con --local-merge, no hay CI remoto, por lo que es mejor requerir que pasen las pruebas locales antes de fusionar con --run-tests-locally.
Entregar múltiples Tasks como un PR (--aggregate-pr)
ywc-sequential-executor 000020-010..000025-010 --aggregate-pr --group-name project-health --reviewywc-sequential-executor 000020-010..000025-010 --aggregate-pr --group-name project-health --reviewTasks están apilados secuencialmente en una rama work/project-health y se entregan como uno PR. Consulte la sección "Concepto compartido" arriba para el modelo completo --aggregate-pr y --group-name.
Crea solo un PR y deja que un humano lo fusione más tarde
ywc-sequential-executor 000020-010 --draftywc-sequential-executor 000020-010 --draftNo sabes qué ejecutar; primero previsualiza el plan
ywc-sequential-executor --dry-runywc-sequential-executor --dry-runSi no se especifica Task, detecta automáticamente el siguiente objetivo ejecutable desde dependency-graph e imprime solo el plan de ejecución (no se ejecuta nada realmente).
Ejecutar de forma aislada para que no interfiera con otros trabajos en la verificación principal (--worktree)
ywc-sequential-executor 000020-010..000025-010 --worktree --reviewywc-sequential-executor 000020-010..000025-010 --worktree --review--worktree ejecuta todo el rango dentro de un único árbol de trabajo de git. El clon original se deja intacto para que puedas continuar con otros trabajos. El punto clave es que esto es aislamiento a nivel de ejecución: un árbol de trabajo abarca todo el rango, y Tasks dentro de él sigue ejecutándose secuencialmente. (En contraste, ywc-parallel-executor crea un árbol de trabajo separado por Task - ver la sección del ejecutor en paralelo más abajo.)
- Es una bandera independiente. No es mutuamente excluyente con los cuatro modos de entrega (
normal-pr/--local-merge/--draft/--aggregate-pr) ni con--review; puedes combinarla libremente. Activar o desactivar--worktreeno cambia el modo de entrega en sí. - El manejo posterior a la finalización depende del modo de entrega:
- Combinaciones
normal-pr/--local-merge/--draft-> cuando la ejecución termina (Estado de finalizaciónDONE), se elimina el árbol de trabajo, pero la rama de integración se conserva. El informe incluye una nota que dice "la rama de integración aún no se ha fusionado al tronco", por lo que debes abririntegration/run-<slug> -> trunkPR tú mismo conywc-create-pr- no se abre automáticamente. - Usado con
--aggregate-pr-> el paso manual anterior no es necesario. La ramawork/<name>se crea dentro del árbol de trabajo, y elwork -> basePR se abre automáticamente al final.
- Combinaciones
- Si falla a mitad de camino (
BLOCKED/DONE_WITH_CONCERNS), el árbol de trabajo no se elimina y permanece en su lugar. Más tarde, puedes ingresar la ruta que se muestra en el informe y reanudar. - Con
--dry-run, no se crea un worktree real; solo se previsualiza qué ruta y nombre se utilizarían:claude codeywc-sequential-executor 000020-010..000025-010 --worktree --dry-runcodexywc-sequential-executor 000020-010..000025-010 --worktree --dry-run
--worktree + --aggregate-pr - ejecución aislada y entrega de un solo PR al mismo tiempo
ywc-sequential-executor 000020-010..000025-010 --worktree --aggregate-pr --group-name project-health --reviewywc-sequential-executor 000020-010..000025-010 --worktree --aggregate-pr --group-name project-health --reviewEsta es la combinación más completa cuando quieres dejar el proceso de pago principal sin cambios mientras agrupas múltiples Tasks en un PR mediante la implementación.
Nota:
--local-merge/--draft/--skip-ci-wait/--aggregate-prson mutuamente exclusivos. Si usas dos o más juntos, la ejecución se detiene y solicita aclaración.--reviewy--worktreese pueden combinar con cualquiera de esos modos.
ywc-parallel-executor - cuando quieres ejecutar Tasks de manera independiente al mismo tiempo
Ejecuta Tasks de manera independiente en paralelo, creando y fusionando un PR por cada Task
ywc-parallel-executor 000020-010..000025-010 --per-task-pr --reviewywc-parallel-executor 000020-010..000025-010 --per-task-pr --reviewSe ejecutan concurrentemente por ola, y cada Task completa de forma independiente la creación de PR -> CI -> revisión por bot -> fusión.
Fusionar rápidamente local cada Task sin PRs
ywc-parallel-executor 000020-010..000025-010 --local-merge --reviewywc-parallel-executor 000020-010..000025-010 --local-merge --reviewEjecuta todos los Tasks en paralelo y entrégalos como un PR (--aggregate-pr)
ywc-parallel-executor --all --aggregate-pr --group-name payments --reviewywc-parallel-executor --all --aggregate-pr --group-name payments --reviewTasks se apilan por ola en una rama aggregate/payments y se entregan como uno PR. Consulte la sección "Concepto compartido" en la parte superior de esta página para el modelo completo --aggregate-pr y --group-name. Es exactamente el mismo concepto que ywc-sequential-executor, solo cambia el prefijo de rama compartida de work/ a aggregate/.
Después de que todo el trabajo se complete, deje que un humano revise y fusione todo de una vez
ywc-parallel-executor 000020-010..000025-010 --draftywc-parallel-executor 000020-010..000025-010 --draftDespués de que se completen todas las olas, se crea un borrador PR y la fusión es manual.
Nota: Si no se especifica ninguno de
--local-merge/--draft/--per-task-pr/--aggregate-pr, se pregunta cuál de los cuatro modos deseas en lugar de elegir silenciosamente un valor predeterminado.--reviewse puede combinar con cualquier modo. (Para referencia,ywc-parallel-executorno tiene una bandera--worktreeseparada porque el aislamiento de worktree por Task es el comportamiento predeterminado de este Skill.)
ywc-code-gen - cuando quieres generar código directamente sin la descomposición Task
Generar Backend + Frontend + QA a la vez
ywc-code-gen --spec docs/ywc-plans/ywc-improve-architecture-skill.md --feature "improve architecture skill docs"ywc-code-gen --spec docs/ywc-plans/ywc-improve-architecture-skill.md --feature "improve architecture skill docs"Construye cuidadosamente con TDD para funcionalidades sensibles como pago/autenticación
ywc-code-gen --spec docs/ywc-plans/ywc-toolkit-eval-hardening.md --feature "payment webhook hardening" --tddywc-code-gen --spec docs/ywc-plans/ywc-toolkit-eval-hardening.md --feature "payment webhook hardening" --tddPalabras clave como payment se clasifican automáticamente como critical, lo que prohíbe la delegación de caja gris (verificar solo las interfaces sin leer el código interno). --tdd aplica límites de commits RED -> GREEN -> REFACTOR.
Ya revisaste el código reutilizable y quieres omitir la detección de duplicados
ywc-code-gen --spec docs/ywc-plans/improve-evaluate-codex-skills-agents-skill.md --feature "notification settings UI" --skip-reuse-checkywc-code-gen --spec docs/ywc-plans/improve-evaluate-codex-skills-agents-skill.md --feature "notification settings UI" --skip-reuse-checkNota:
--specy--featureson ambos necesarios. Si alguno está vacío, se detiene conNEEDS_CONTEXT. Si el trabajo ya tiene un directoriotasks/, useywc-sequential-executor/ywc-parallel-executoren lugar de este Skill.
Previous: 14. Gestionar la infraestructura en la nube - Next: 17. Referencia completa Skill