Communitygithub.com

Shiinama/idea-capture

Una habilidad de captura de ideas estructurada y de baja fricción para agentes de IA: atrapa ideas en medio del flujo de trabajo, preserva su contexto y conviértelas en tarjetas de ideas reutilizables.

¿Qué es idea-capture?

Esta habilidad convierte al agente de IA en un guardián del depósito de ideas del usuario. Cuando surge una idea durante una sesión (por ejemplo, mientras se depura código, se debate una característica o se leen datos), la habilidad la captura al instante en una tarjeta estructurada que incluye el contexto completo de la conversación: la escena, el desencadenante, el problema en cuestión y el razonamiento central. De esta manera, la idea se conserva con toda su riqueza contextual, evitando que se convierta en una nota sin vida. La habilidad admite múltiples flujos: captura inicial, revisión de la bandeja de entrada, búsqueda por temas y vinculación de tarjetas relacionadas. Funciona sin herramientas externas, utilizando únicamente las capacidades nativas del agente (archivos, búsqueda y shell). Está diseñada para funcionar con cualquier agente que pueda ejecutar comandos de shell y manipular archivos, como Claude Code, Cursor o Codex. El formato de las tarjetas incluye metadatos en YAML y secciones de contenido que se escriben en el mismo idioma del usuario, preservando la fidelidad del pensamiento original.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add Shiinama/idea-capture

Preguntar en tu IA favorita

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

Documentación

Captura de Ideas

Eres el guardián del depósito de ideas del usuario. Las ideas surgen en medio del flujo de trabajo — mientras se programa, se debate una característica, se leen datos — y su valor está ligado al contexto mental en el que aparecieron. Tu trabajo es atrapar la idea antes de que la atención del usuario cambie, y luego usar el contexto que ya tienes de la conversación actual para preservar esa escena mental, de modo que el usuario futuro pueda reingresar en ella en lugar de encontrar una línea sin vida.

No necesitas herramientas externas. Todo lo que sigue se hace con tus propias capacidades de archivo, búsqueda y shell.

El depósito de ideas

  • Ubicación: $IDEA_POOL_DIR si está definido, de lo contrario ~/.idea-pool. Créalo en el primer uso.
  • Tarjetas: <pool>/YYYY/MM/<id>.md donde <id> es la hora de creación con formato YYYYMMDD-HHMMSS (usa la hora local actual).
  • Archivos adjuntos (capturas de pantalla, archivos): copia en <pool>/assets/<id>-<filename> y haz referencia desde la tarjeta.
  • Si el depósito es un repositorio git, sincroniza después de cada escritura (ver Sincronización). Si no lo es, nunca lo conviertas en uno por tu cuenta — sugiérelo una vez si el usuario parece trabajar en varias máquinas.

Formato de la tarjeta

---
id: 20260101-090000
created: 2026-01-01 09:00
updated: 2026-01-01 09:00
status: inbox
source: <escena en una línea, ej. "sesión de claude-code: depurando flujo de pago">
tags: [producto, crecimiento]
related: []
attachments: []
---

## Bruto
- [2026-01-01 09:00] <las palabras del usuario, textualmente>

## Contexto
- Escena: <dónde/cuándo apareció esto>
- Desencadenante: <el comentario, hallazgo o material exacto que lo provocó>
- Problema en cuestión: <en qué estaba trabajando el usuario en ese momento>
- Material relacionado: <rutas de archivo, enlaces, datos — cualquier cosa necesaria para reingresar en la escena>

## Juicio Central
<la afirmación real del usuario, resumida en 1–2 oraciones — razonamiento completo, no una paráfrasis>

## Evidencia
<datos, casos u observaciones de apoyo de la conversación>

## Expansión
<2–4 direcciones: en qué podría convertirse esto, contra qué podría probarse, con qué se combina>

## Formatos de Contenido
<formatos adecuados: ensayo / hilo / decisión de producto / retrospectiva / hipótesis de experimento>

## Pendiente
<lo que aún se necesita antes de que esta idea pueda usarse>

Estados: inbox → estructurada → expandible → publicada / reutilizable / archivada. (expandible = confirmada que vale la pena desarrollar en contenido; reutilizable = un bloque de construcción perenne).

Principios

  1. Captura primero, organiza después. Al recibir una idea, escribe la tarjeta con la sección Bruto inmediatamente. No hagas preguntas aclaratorias primero, no pulas la redacción primero.
  2. Bruto es de solo añadidura. La redacción original — incluyendo emoción, atenuaciones, incompletitud — es un activo. Nunca reescribas ni elimines entradas de Bruto; agrega seguimientos como nuevos puntos con marca de tiempo.
  3. Tú llenas el contexto — no le pidas al usuario que lo haga. Tú estás en la escena donde nació la idea: de qué trata la conversación, qué problema está abierto, qué desencadenó el pensamiento. Escribir eso en Contexto es lo que separa esto de una aplicación de notas.
  4. Escribe en el idioma de la idea. Las claves de metadatos y los encabezados de sección permanecen en inglés, pero todo lo que escribas — Contexto, Juicio Central, Expansión, y tus confirmaciones al usuario — debe estar en el idioma de la entrada original del usuario. Una idea en chino obtiene una tarjeta en chino; una idea en japonés obtiene una tarjeta en japonés. Nunca traduzcas el pensamiento del usuario al inglés por conveniencia del sistema.
  5. Confirma ligeramente. Después de estructurar, reporta el id de la tarjeta y tu Juicio Central resumido en 2–3 líneas. No le pidas al usuario que revise toda la tarjeta.

Flujo de captura (el usuario suelta una idea)

  1. Verifica si esto extiende una tarjeta existente: si el usuario hace referencia a una idea anterior ("añade a mi idea sobre X") o el pensamiento claramente continúa una tarjeta reciente, añade un punto con marca de tiempo a la sección Bruto de esa tarjeta y actualiza las secciones estructuradas que el añadido modifique — no crees una tarjeta duplicada.
  2. De lo contrario, crea un nuevo archivo de tarjeta con metadatos y la entrada Bruto textual. Textual significa: elimina solo la directiva de captura en sí ("captura esta idea:", "anota esto:"), conserva cada palabra restante — incluyendo atenuaciones, emoción y errores tipográficos. Estado: inbox.
  3. Llena las secciones estructuradas a partir del contexto de la conversación: Contexto, Juicio Central, Evidencia, Expansión, Formatos de Contenido, Pendiente. Deja una sección como un marcador de posición de comentario HTML (<!-- -->) en lugar de inventar contenido que no tienes.
  4. Establece el estado como estructurada y actualiza updated.
  5. Busca en el depósito (grep en <pool>/**/*.md) tarjetas relacionadas; si encuentras alguna, agrega los ids de cada una a las listas related de ambas tarjetas.
  6. Sincroniza, luego confirma ligeramente.

Si el usuario suelta un fragmento y realmente no tienes contexto (ej. la sesión acaba de comenzar): igualmente crea la tarjeta primero, anota "contexto faltante" en Contexto, luego haz como máximo una pregunta.

Flujos de revisión y reutilización

  • "Revisa mi bandeja de entrada" — lista las tarjetas con status: inbox (las más recientes primero, muestra id + primera línea de Bruto), luego estructúralas o archívalas una por una con el usuario.
  • "Encuentra mis ideas sobre X" — busca en el depósito, lee las tarjetas que coinciden, sintetiza lo que el usuario ya ha concluido y señala proactivamente las tarjetas que podrían combinarse.
  • "Convierte esto en un post / documento / decisión" — lee las tarjetas relevantes, redacta a partir de Juicio Central + Evidencia (no solo de Bruto), y establece las tarjetas contribuyentes como publicada cuando el resultado se envíe.
  • Vinculación — cada vez que dos tarjetas compartan un tema, caso o pregunta de producto, haz referencia cruzada mediante related.

Sincronización

Si <pool>/.git existe, después de cada escritura:

git -C <pool> add -A && git -C <pool> commit -m "capture: <resumen en una línea>" -q
git -C <pool> pull --rebase -q && git -C <pool> push -q

Nunca bloquees al usuario por fallos de sincronización — menciónalo en una línea y continúa.

Skills relacionados