Guía de lectura localizada
writing-plansFinalidad, uso y origen
Úselo cuando tenga una especificación o requisitos para una tarea de varios pasos, antes de tocar el código.
Fuente recuperada:
- Repositorio de origen
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- Estrellas del repositorio
- 309,479
- Actualización del repositorio
- 2026-10-30
- Clasificación de habilidades
- Flujo de trabajo del agente
- Última recopilación
Licencia: MIT
Los extractos del flujo de trabajo son guías de lectura, no instrucciones ejecutables de Codez. No se utilizó ninguna habilidad de terceros para generar esta página.
Los siguientes fragmentos sobre el propósito y el flujo de trabajo son material preliminar, organizado y traducido para su lectura. Son distintos del análisis editorial de Codez, que se presenta por separado.
Lo que hace esta habilidad
Úselo cuando tenga una especificación o requisitos para una tarea de varios pasos, antes de tocar el código.
Cómo funciona el flujo de trabajo ascendente
Descripción general
Escriba planes de implementación para un ingeniero que no haya visto este código fuente ni esta especificación. Suponga que escribirá código idiomático en el lenguaje del proyecto una vez que conozca la interfaz exacta y la prueba exacta, y que tomará una decisión razonable dondequiera que el plan deje una abierta. Lo que no puede saber es lo que usted decidió: qué archivos, qué nombres y firmas, qué valores de la especificación, qué pruebas demuestran cada tarea. Documente eso. Déle todo el plan como tareas pequeñas y manejables. DRY. YAGNI. TDD. Commits frecuentes. Anuncie al inicio: "Estoy usando la habilidad de escribir planes para crear el plan de implementación". Contexto: Si trabaja en un árbol de trabajo aislado, debería haberse creado a través desuperpowers:using-git-worktreesHabilidad en el momento de la ejecución. Guardar planes en:docs/superpowers/plans/YYYY-MM-DD-.md
Granularidad de paso
Cada paso es una acción con un resultado verificable: "Escribir la prueba que falla" - paso "Ejecutarla para asegurarse de que falla" - paso "Implementar el código mínimo para que la prueba pase" - paso
Paso río arriba · L43 ↗Qué contiene un paso
Un paso se completa cuando el implementador puede escribir exactamente una cosa razonable a partir de él. Ese es todo el requisito: inequívoco, no completo. Cada tipo de paso lleva lo que lo hace inequívoco y nada más: Un paso de prueba: el nombre de la prueba y sus aserciones, como código, con los valores exactos de la especificación en ellos. Un paso de código: la firma exacta (nombre, parámetros, tipo de retorno), el archivo en el que se encuentra y los valores específicos que la especificación fija. El implementador escribe el cuerpo. Un cuerpo aparece solo para un algoritmo que la firma y las pruebas no determinan, o para una copia exacta que la especificación corrige. Un paso de verificación: el comando a ejecutar y la salida que significa que pasó.
Paso río arriba · L140 ↗Requisitos y configuración
No se seleccionó ningún fragmento de requisitos breves de este archivo. Esto no significa que la habilidad no tenga dependencias. Consulte las instrucciones de configuración del repositorio y los archivos de referencia.
Límites y controles de calidad
No se seleccionó ningún pasaje con límites específicos en este archivo. Esto no significa que la habilidad sea segura para cualquier entrada o entorno. Revise el código fuente completo y valide su propio resultado.
Comience con una prueba segura.
- Verifique el host compatible y las instrucciones de instalación del repositorio. Mantenga juntos el directorio Skill y sus scripts, recursos y documentación a los que hace referencia;SKILL.mdsolo puede omitir dependencias.
- Proporcione al agente sus datos reales, el resultado deseado y los criterios de aceptación. La sintaxis de invocación y las herramientas disponibles dependen del sistema anfitrión; este sitio no presupone un comando de instalación universal.
- Pruebe el flujo de trabajo original en un proyecto desechable o en una copia. Revise las operaciones que modifican archivos, servicios remotos o recursos facturables antes de autorizarlas.
- Valide el resultado comparándolo con los controles de calidad de origen y sus propios requisitos. Un activador exitoso o un alto número de estrellas en el repositorio no garantizan un resultado correcto.
Lea más en la fuente
Habilidades relacionadas
Traducción y alcance
Esta guía de lectura selecciona pasajes de la sección fijada en la parte superior.SKILL.mdLa traducción es asistida. No se trata de un manual completo ni garantiza la compatibilidad. Lea el original y los archivos a los que hace referencia antes de usarlo.
Esta introducción hace referencia a la versión fijada a continuación; la actividad actual del repositorio y la hora de recopilación se muestran por separado.
- Fuente fijada
- Lee el original ↗
- Fuente recuperada
- Confirmación de origen
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- Fuente SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a