CommunityRedacción y edicióngithub.com

Iterar Proyecto de Investigación

Habilidades de Codex para portafolio de investigación y flujos de trabajo de proyectos iterativos.

¿Qué es Iterar Proyecto de Investigación?

Este skill, 'Iterar Proyecto de Investigación', estructura el trabajo de un proyecto de investigación para mantenerlo honesto y organizado a medida que evoluciona. El hábito central es clasificar el trabajo, escribir en el lugar más específico y duradero, registrar la evidencia y luego sincronizar solo los resúmenes y el tablero que los colaboradores necesitan. Está diseñado para plataformas como Codex, Claude Code, Cursor, etc., y proporciona un sistema completo de carpetas, un tablero de proyecto (`PROJECT_BOARD.html`), y reglas claras para la iteración y la gestión de subproyectos. La utilidad principal radica en evitar la acumulación de desorden y la pérdida de contexto, fomentando una exploración basada en experimentos discretos (subproyectos) que mantienen un historial 'append-only' y comparable. El sistema separa la discusión de los intentos concretos, gestiona el conocimiento de trabajo en archivos `_ai/`, y escala la sincronización del tablero según el impacto del cambio, permitiendo su uso tanto de forma independiente como dentro de un portafolio de investigación más amplio.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add jiangjin1999/codex-research-project-skills

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Iterar Proyecto de Investigación?

Usa este skill para mantener un proyecto de investigación honesto a medida que cambia. El hábito central es: clasificar el trabajo, escribir en el lugar más específico y duradero, registrar la evidencia, y luego sincronizar solo los resúmenes y el tablero que los colaboradores necesitan.

Dos reglas lo gobiernan todo:

  1. Markdown primero, tablero después. Actualiza primero el markdown fuente o la nota _ai. Solo entonces sincroniza PROJECT_BOARD.html.
  2. El tablero es un mapa, no un registro. PROJECT_BOARD.html muestra el estado actual y apunta a la evidencia. Nunca almacena registros sin procesar, datos privados o rutas absolutas.

Y un hábito que impulsa la iteración: nueva idea → nuevo subproyecto. Los intentos de experimentación son el núcleo del trabajo. Cuando hay algo que probar, crea un nuevo 0-Project/<fecha>_<slug>/ e itera allí en lugar de sobrescribir o reiterar un intento sin fin. Mantén los subproyectos pequeños y de un solo propósito; no temas a la duplicación. Esto mantiene un historial de solo añadidura y comparable (ver references/project-iteration-system.md).

Los subproyectos también tienen carriles:

  • Línea principal — intentos actuales que definen la ruta activa.
  • Aparcados — ideas de intentos futuros capturadas temprano porque el pensamiento de investigación no es completamente serial, pero aún no ejecutadas. Nota por defecto: 0-Project/_parking-lot.md.
  • Archivados — intentos abandonados o reemplazados, mantenidos con una razón de parada y evidencia. Carpeta por defecto: 0-Project/_archive/.

Aparca de forma ligera. Una idea futura puede ser una entrada corta en _ai/task_plan.md, 1-Docs/ o 0-Project/_parking-lot.md; crea una carpeta de intento completa solo cuando la idea tenga suficientes entradas, criterios o valor de transferencia.

Enruta la discusión y los intentos por separado: la discusión, decisión, comparación y explicación del método van a 1-Docs/<fecha>_<tema>.md; las pruebas concretas con entradas, criterios, salidas o resultados van a 0-Project/<fecha>_<slug>/; la discusión local del intento va a 0-Project/<intento>/docs/<fecha>_<tema>.md.

Independiente o dentro de un portafolio. Este skill es autónomo: úsalo solo para un proyecto único en cualquier ruta — no se requiere portafolio. Todo lo que el proyecto necesita (carpetas, archivos de entrada, tablero, memoria de trabajo, política de git) vive dentro de la carpeta del proyecto. Opcionalmente, cuando el proyecto se encuentra dentro de un portafolio (<slug>-project/<project>/), sincroniza el estado, propietario, prioridad y estado público con el tablero del portafolio usando el skill manage-research-portfolio. Cuando se ejecuta de forma independiente, omite cada paso de "tablero de portafolio" y "registro" en este skill — son integraciones opcionales, nunca requisitos previos.

Contrato del Proyecto

Usa esta estructura a menos que el proyecto ya tenga nombres equivalentes. Es el esqueleto copiable de _PROJECT_TEMPLATE.

<project>/ 
├── README.md               entrada: objetivo de una frase, mapa de carpetas, inicio rápido, estado actual 
├── PROJECT_GUIDELINES.md   reglas de sincronización locales del proyecto, límites de carpetas, clasificación HTML
├── PROJECT_BOARD.html      el tablero: mapa del estado actual y navegación
├── GIT_WORKFLOW.md         identidad de git + política de confirmación por cambio para este proyecto
├── scripts/ 
│   └── init_project_git.sh   ayudante opcional para establecer identidad y primer commit
├── 0-Project/               intentos / experimentos concretos (un `0-Project/<fecha>_<slug>/` por intento) 
├── 1-Docs/ 
│   └── README.md            la entrada de Documentos fija única + índice de temas
├── 2-Data/ 
│   └── DATA.md              fuente, procedencia, permisos, versiones, esquema, QC, límites 
├── 3-Paper_Survey/ 
│   └── README.md            cola de lectura, notas de artículos, matriz de evidencia, fuentes de métodos
├── 4-Skills/ 
│   └── PROJECT_SKILLS.md    indicaciones locales del proyecto, reglas de IA, procedimientos reutilizables
└── _ai/ 
    ├── project_overview.md   objetivo, alcance, estado, propietario, prioridad, siguiente
    ├── project_board_spec.md cómo se genera/sincroniza PROJECT_BOARD.html desde las fuentes
    ├── task_plan.md          fase actual, plan, bloqueadores, siguiente
    ├── findings.md           hallazgos estables, preguntas abiertas
    └── progress.md           la sincronización significativa más reciente, acciones, validación, commit

Los archivos raíz son entrada + reglas + tablero + política de git. Todo lo concreto va a la carpeta numerada más adecuada; nunca apiles materiales en la raíz del proyecto, y nunca pongas la visión general del proyecto, las reglas del tablero o las pautas a largo plazo dentro de 0-Project/ (esa carpeta es solo para intentos concretos).

Clasificar Antes de Escribir

Cuando el usuario proporcione material nuevo, elige un lugar de aterrizaje, luego decide si el tablero cambia.

Intención del usuarioLugar de aterrizajeVista del tablero que puede tocar
"Esto es una discusión / método / decisión / comparación"1-Docs/<fecha>_<tema>.md + actualizar 1-Docs/README.mdMapa de Documentos
"Esto es un experimento / intento concreto"0-Project/<fecha>_<slug>/; coloca notas locales del intento bajo su docs/Tareas (intentos)
"Esto es una nota sobre un intento existente"0-Project/<intento>/docs/<fecha>_<tema>.mdusualmente Tareas, a veces Mapa de Documentos si cambia el índice a nivel de proyecto
"Esto es una idea de intento futuro"_ai/task_plan.md, 1-Docs/ o 0-Project/_parking-lot.md; carpeta de intento completa solo si es concretousualmente ninguno, o un carril de Tareas aparcadas
"Este intento está abandonado / reemplazado"mantén la carpeta del intento o muévela bajo 0-Project/_archive/; marca como archivado con razón de parada, evidencia y reemplazocarril de Tareas archivado/colapsado
"Esto es información de datos / benchmark"2-Data/DATA.mdMateriales (datos)
"Esto es un artículo / fuente externa / evidencia"3-Paper_Survey/README.md + matriz de evidenciaReferencias
"Esto es un flujo de trabajo reutilizable / indicación / regla de IA"4-Skills/PROJECT_SKILLS.md(usualmente ninguno)
"Esto cambia el estado / siguiente acción / bloqueador"_ai/project_overview.md, _ai/task_plan.mdResumen superior + Progreso del proyecto

Si la clasificación cambia el alcance del proyecto, los criterios de evaluación, el límite de datos, la exposición pública o si un intento pertenece al proyecto, pregunta antes de tratarlo como confirmado. Para nombres/formato de bajo riesgo, elige la opción conservadora y registra la suposición en _ai/progress.md.

El Tablero

PROJECT_BOARD.html es el tablero de un solo proyecto. Responde de un vistazo: qué es este proyecto, qué es actual, qué cambió, dónde está la evidencia y dónde continuar. Está coordinado con las carpetas — cada vista se alimenta de una carpeta o archivo _ai específico.

Elementos básicos:

  • Enlace de inicio / volver (persistente): un enlace al frente mismo de la página, en el área de la marca superior izquierda. Dentro de un portafolio, hazlo un enlace Volver al tablero que apunte a la raíz del sitio /; independiente, omítelo o apunta al README.md del propio proyecto. Conserva lo que elijas al crear, copiar, publicar o actualizar la página.

  • Estado de la versión: versión de la página YYYY-MM-DD-vN y marcador de última sincronización (opcionalmente un control de frescura/actualización).

  • Resumen superior (siempre visible, ligero): nombre del proyecto, descripción de una frase, estado, propietario, sincronización reciente, enfoque actual y como máximo una línea corta de progreso. Fuente: _ai/project_overview.md. No coloques listas de fases, tarjetas de versión, listas de intentos o rutas a largo plazo aquí.

  • Cinco vistas mutuamente excluyentes, cada una mapeada a una carpeta:

    VistaAlimentada porMuestra
    Progreso del proyecto_ai/progress.md, _ai/findings.md, 1-Docs/README.mdsolo cambios mayores a nivel de proyecto: objetivo, alcance, fase, resultado clave, juicio, estado público, resumen de versión compacto
    Mapa de Documentos1-Docs/README.md + estructura raízíndice de temas de docs + un árbol de estructura al estilo de VS Code Explorer (archivos/carpetas de nivel 1 raíz y nivel 2 mediante <details>/<summary>), solo nombres seguros para el público
    Tareas0-Project/<intento>/intentos de línea principal primero; intentos futuros aparcados y archivados/obsoletos solo en carriles colapsados separados
    Materiales2-Data/DATA.mdbloques de datos, publicidad, versión, calidad, límites de uso
    Referencias3-Paper_Survey/README.mdartículos, fuentes de métodos, estado de la evidencia, impacto; solo si hay contenido

Reglas del tablero: no inventes propietarios, estado, prioridad o fases futuras; no añadas una vista independiente de "próximo paso" (la siguiente acción vive en el resumen superior, _ai/task_plan.md o un intento); usa <details> colapsados para intentos y el árbol de estructura; mantenlo como un banco de trabajo de investigación silencioso, no una página de destino. Las ideas futuras y los intentos abandonados no deben competir visualmente con la ruta activa. Las reglas de generación viven en _ai/project_board_spec.md. Consulta references/project-board.md para el contrato completo.

Bucle de Iteración

  1. Restaura el contexto desde _ai/project_overview.md, _ai/project_board_spec.md, _ai/task_plan.md, _ai/findings.md, _ai/progress.md y el README de la carpeta relevante.
  2. Confirma la identidad de Git del operador antes de editar los archivos del proyecto; si falta, pide al usuario que configure la suya y haz una pausa.
  3. Nombra la iteración actual en una frase: pregunta, intento o decisión.
  4. Crea o actualiza primero el archivo fuente más específico.
  5. Registra los hallazgos que cambien la dirección en _ai/findings.md; registra acciones, validación y rutas fallidas en _ai/progress.md.
  6. Actualiza _ai/task_plan.md cuando la fase, el bloqueador o la siguiente acción cambien.
  7. Antes de la compresión de contexto, después de completar un pequeño paso, o antes de cambiar de tema/subproyecto, escribe una transferencia compacta en el archivo Markdown coincidente más específico.
  8. Aplica la Escala de Sincronización para decidir si tocar PROJECT_BOARD.html, luego confirma los archivos seguros cambiados con rutas explícitas.

Compresión de Contexto e Higiene de Transferencia

Escribe el contexto de forma proactiva antes de que la conversación se vuelva costosa de mantener. Haz esto cuando la ventana de contexto se esté haciendo grande, un pequeño paso termine, un subproyecto llegue a un punto de decisión, o la siguiente acción vaya a cambiar a otro tema, proyecto o intento.

Elige el hogar más específico:

SituaciónUbicación de la transferencia
Discusión, decisión o nota de método a nivel de proyecto1-Docs/<fecha>_<tema>.md
Paso, observación o discusión local a nivel de intento0-Project/<intento>/docs/<fecha>_<tema>.md
Estado del proyecto, bloqueador, siguiente acción o resumen de validación_ai/progress.md, _ai/findings.md, _ai/task_plan.md
Contexto entre proyectos o de portafolio<slug>-ai/<fecha>_<tema>.md del portafolio si existe un portafolio

Campos mínimos de la transferencia: objetivo actual, paso completado, decisiones clave, rutas de evidencia, preguntas no resueltas, siguiente acción y si se necesita sincronización del tablero. Mantenlo compacto; no pegues transcripciones completas o registros sin procesar.

Escala de Sincronización

Juzga cada cambio contra esta escala antes de editar el tablero.

NivelDesencadenanteActualización
0Exploración de solo lectura, sin nueva decisiónNada
1Hallazgo menor, pequeña rama fallida, nota temporalSolo Markdown o _ai
2Nuevo artefacto/ruta/resultado de QC, bloqueador, siguiente acción, estado, mapa de documentos, árbol de estructura, límite de datos, referencia o cambio de intentoMarkdown fuente o _ai, luego sincronizar PROJECT_BOARD.html
3Fase, hito, afirmación pública, propietario, prioridad o estado público cambiadoMarkdown fuente, tablero, PROJECT_GUIDELINES.md y — solo si el proyecto pertenece a un portafolio — el tablero del portafolio

Las notas de transferencia de contexto son generalmente de Nivel 1. Elévalas a Nivel 2 solo cuando cambien la siguiente acción, el estado, el bloqueador, el mapa de documentos, el límite de datos, el estado de la referencia o el estado del intento.

No sincronices el tablero en cada edición. Sincroniza cuando un colaborador necesitaría el nuevo estado.

Registros de Subproyectos

Cada 0-Project/<fecha>_<slug>/README.md debe responder: qué pregunta pone a prueba el intento; qué entradas, artículos, notas de datos o suposiciones usa; qué se ejecutó o razonó (objetivo, hipótesis, entradas, comando, métricas); qué falló, cambió o se estabilizó; la conclusión y la siguiente acción; y si afecta el estado del proyecto, las notas de datos, las notas de literatura o el tablero. Coloca las discusiones locales del intento, las transferencias de paso y las notas de diseño en la carpeta docs/ de ese intento.

Registra los intentos fallidos. Una ruta fallida con una razón clara es un activo útil del proyecto. Si está abandonado o reemplazado, márcalo como archivado con la razón de parada, el reemplazo si lo hay, la última evidencia y qué no repetir; muéstralo en el tablero solo como un elemento colapsado secundario una vez que alcance una fase estable o un punto de decisión.

Datos y Literatura

  • Usa 2-Data/DATA.md para la procedencia, versiones, clase de acceso, ubicaciones permitidas, esquema, QC y límites de artefactos derivados. Mantén los datos derivados del proyecto (características, trayectorias, tablas listas para análisis, intermediarios de QC) bajo el 2-Data/ de este proyecto, no en el área de datos global. Nunca escribas registros sensibles sin procesar, ejemplos con identidad, credenciales o extractos no publicados en notas, el tablero o copias públicas.
  • Usa 3-Paper_Survey/README.md para la evidencia que puede cambiar métodos, evaluación, alcance o interpretación. Resume los artículos por problema, método, datos o benchmark, resultado, limitación e implicación para este proyecto. Usa una matriz de evidencia cuando varias fuentes se refieran a una misma afirmación. Prefiere una paráfrasis concisa y enlaces sobre citas largas.

Referencias

  • Lee references/project-iteration-system.md al crear la estructura del proyecto, archivos de entrada, subproyectos, archivos de memoria de trabajo o reglas de sincronización.
  • Lee references/project-board.md al crear, revisar o sincronizar PROJECT_BOARD.html.
  • Lee references/data-and-literature.md antes de manejar notas de datos, procedencia de benchmarks, resúmenes de literatura o actualizaciones de evidencia a decisión.

Skills relacionados