Communitygithub.com

yinɡzhenɡzhang06-sys/requirement-clarifier

Puesto de clasificación de tres modos para solicitudes ambiguas (growme + change + improve). Escenarios nativos en chino, neutral en tiempo de ejecución, tabla de enrutamiento de más de 30 habilidades.

¿Qué es requirement-clarifier?

Este skill actúa como un *triage station* o 'puesto de clasificación' para cualquier solicitud ambigua que un desarrollador o agente de IA reciba. Su propósito principal es evitar la ejecución prematura: antes de actuar, obliga a responder tres preguntas clave: ¿qué quiere realmente el usuario?, ¿cuán complejo es?, y ¿por dónde empezar?. Opera en tres modos distintos: **growme** (clarificación de ideas difusas en requisitos estructurados), **change** (priorización y orden de ejecución de múltiples tareas) y **improve** (revisión y mejora de soluciones existentes). Es neutral en cuanto al runtime (funciona con Claude Code, Cursor, Codex y similares) y está diseñado para escenarios chinos nativos, aunque su lógica es universal. No ejecuta ninguna tarea por sí mismo; una vez que clasifica la solicitud, enruta al skill de ejecución adecuado (por ejemplo, a un skill de frontend, backend o contenido). Incluye una tabla de enrutamiento de más de 30 skills y referencias detalladas (dimensiones de preguntas, matrices de prioridad, puntos de mejora) para garantizar una clarificación precisa y evitar falsos positivos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add yingzhengzhang06-sys/requirement-clarifier

Preguntar en tu IA favorita

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

Documentación

Clarificación de Requisitos y Clasificación de Tareas (Grow / Change / Improve)

Frase gancho: No te apresures — antes de actuar, responde tres preguntas: "¿qué quiere realmente el usuario?", "¿qué tan complejo es?", "¿por dónde empezar?"

Es el "puesto de clasificación" — no presupone un dominio, no ejecuta por ti. Convierte ideas difusas en requisitos estructurados, montones de tareas en una secuencia de ejecución enrutada y soluciones existentes en listas de mejora. Luego señala claramente el siguiente skill que se debe usar, sin encargarse él mismo de la ejecución.

Este skill es un enrutador que asigna el problema del usuario a tres sub-skills:

  • growme-mode — Clarificación de requisitos ("ayúdame a pensar")
  • change-mode — Clasificación de tareas ("¿qué hago primero?")
  • improve-mode — Optimización estructural ("¿cómo lo mejoro?")

Posicionamiento central

Cualquier solicitud en la que "no estés seguro de por dónde empezar" pasa primero por este skill una vez. Tres acciones:

  1. Clarificar (growme): Convertir ideas difusas en requisitos ejecutables.
  2. Clasificar (change): Convertir un montón de tareas en un orden de ejecución.
  3. Mejorar (improve): Convertir una solución existente en una lista de puntos de mejora.

Responde a las tres preguntas fundamentales del usuario:

  • ¿Qué quieres realmente? (growme genera una "especificación de requisitos")
  • ¿Por dónde empezar? (change genera un "orden de ejecución")
  • ¿Está bien así? (improve genera una "lista de mejoras")

Reglas de enrutamiento

Al recibir la entrada del usuario, primero determina a qué modo pertenece (puede ser múltiple o secuencial):

Característica del usuarioModoEjemploEnrutar a
Expresa un resultado pero el camino no es clarogrowme"Quiero crear un skill de enseñanza con IA"growme-mode
Tiene múltiples tareas que necesita ordenar o seleccionarchange"Tengo 8 skills que necesitan refinamiento"change-mode
Ya tiene una solución pero no está seguro de si es óptimaimprove"¿Este SKILL.md está bien escrito?"improve-mode

Principios de decisión:

  • La mayoría de las solicitudes primero hacen growme (clarificar) y luego deciden si encadenar change / improve.
  • Orden secuencial: growme → change → improve (primero aclara qué se quiere, luego ordena, luego revisa la solución).
  • Informa claramente al usuario del modo que has determinado, y permite que confirme o corrija.
  • Si no es necesario clasificar, di directamente "no es necesario". No uses el skill por usarlo.
  • En una misma conversación pueden intervenir varios modos — llámalos secuencialmente según sea necesario.

No te enrutas a ti mismo: Una vez clasificada la tarea, debes apuntar a otro skill de ejecución. No está permitido hacer "después de A, vuelve a requirement-clarifier para clarificar".


Escenarios de activación

Activación fuerte (llamada directa):

  • "Ayúdame a pensar / ¿cómo hago esto? / tengo una idea" → growme-mode
  • "¿Cómo ordeno estas tareas? / ¿qué hago primero? / ¿cuáles son las rutas de implementación? / clasifica esto" → change-mode
  • "¿Cómo optimizar? / ¿qué problemas hay? / revisa esta solución / haz una auditoría" → improve-mode

Activación débil (cuando el contexto tiene semántica de "incertidumbre"):

  • Recibir un requisito de una sola línea sin criterios de aceptación.
  • Un montón de tareas sin dependencias declaradas.
  • Una solución existente con la que el usuario expresa "siento que algo no está bien".
  • Miembros del equipo con descripciones inconsistentes del mismo objetivo.

Sin activación (límite claro):

  • La información ya está completamente clara → ve directo al grano, no uses el skill por usarlo.
  • Una sola pregunta pequeña y clara ("¿cómo se usa X?") → usa AskUserQuestion directamente.
  • Ya es un problema de dominio específico ("¿cómo escribo un botón en frontend?") → enruta a frontend-design / ui-ux-pro-max y otros skills de dominio.
  • Puramente escritura / traducción / generación → enruta a original-writing / humanizer / content-rewrite.

Formato de salida (vista del enrutador)

Modo determinado: growme / change / improve (combinables)

【growme】 → Cargar growme-mode (ejecutar clarificación de requisitos)
【change】  → Cargar change-mode (ejecutar clasificación de tareas)
【improve】 → Cargar improve-mode (ejecutar optimización estructural)

Sugerencia siguiente: [Enrutar concretamente a XX skill / ejecutar directamente / aclarar más]

Estructura de archivos (este kit)

requirement-clarifier/             ← Enrutador (estás aquí)
├── SKILL.md                       ← Este archivo: enrutamiento + activación + límites
├── growme-mode/                   ← Sub-skill 1: Clarificación de requisitos
│   ├── SKILL.md
│   └── references/
│       ├── seven-dimensions.md    ← 7 dimensiones de interrogación
│       ├── ask-question-toolkit.md ← Técnicas de uso de AskUserQuestion
│       └── red-flags.md           ← Contraejemplos de falsa clarificación
├── change-mode/                   ← Sub-skill 2: Clasificación de tareas
│   ├── SKILL.md
│   └── references/
│       ├── complexity-rubric.md   ← Criterios de complejidad
│       ├── priority-matrix.md     ← Matriz P0/P1/P2/P3
│       ├── routing-table.md       ← Tabla de enrutamiento de 30+ skills
│       └── parallel-dependency.md ← Dependencias y paralelismo
├── improve-mode/                  ← Sub-skill 3: Optimización estructural
│   ├── SKILL.md
│   └── references/
│       ├── seven-leverage-points.md ← 7 tipos de puntos de mejora
│       ├── smart-criteria.md      ← Principios SMART
│       └── red-flags.md           ← Contraejemplos de falsa mejora
├── examples/                      ← Casos reales
│   ├── fake-clarification.md      ← Muestra de falsa clarificación
│   ├── fake-triage.md             ← Muestra de falsa clasificación
│   └── fake-improve.md            ← Muestra de falsa mejora
├── test-prompts.json              ← 6 muestras de prueba en vivo + preguntas de autoevaluación
├── README.md                      ← Fachada del kit (plantilla house-style)
├── LICENSE                        ← MIT
└── .claude-plugin/
    └── marketplace.json           ← Plugin de doble canal

Informe de refinamiento movido a 精修skills/13-元skill与治理/打磨报告/requirement-clarifier-打磨报告.md (archivo centralizado para ver el estado de refinamiento de todos los skills).


Gotchas (capa de enrutador)

❌ Cosas que no debes hacer

  1. No "ejecutar" en lugar de enrutar — Este skill es un "puesto de clasificación", no un "quirófano". Una vez clarificada y clasificada la tarea, apunta claramente al siguiente skill de ejecución.
  2. No usar el skill por usarlo — Si la entrada del usuario ya es suficientemente clara, simplemente confírmalo.
  3. No presuponer un dominio — No asumas frontend, backend, contenido, negocio ni ningún otro dominio.
  4. No enrutarte a ti mismo — Una vez clasificada, no apuntes a requirement-clarifier; forma un ciclo cerrado "clasificación → ejecución → verificación".
  5. No saltar growme para ir directamente a change — La premisa de un montón de tareas es "ya tener claro qué se quiere"; de lo contrario, primero clarifica.
  6. No hacer más de 5 preguntas a la vez — Más de 5 significa que no estás captando lo esencial.
  7. No enumerar más de 7 puntos de mejora — Más de 7 significa que no estás priorizando, solo enumerando.

✅ Criterios para considerar completitud

Antes de emitir la salida, pregúntate:

"¿Puede el usuario empezar a trabajar directamente con esta salida?"

  • Sí → Completo.
  • No → ¿Qué paso falta? Vuelve a completarlo.
  • No estoy seguro → Marca "Requiere confirmación del usuario sobre XX antes de comenzar".

Cuándo leer los sub-skills

  • Solicitudes relacionadas con growme → Cargar growme-mode/SKILL.md + references/seven-dimensions.md.
  • Solicitudes relacionadas con change → Cargar change-mode/SKILL.md + references/priority-matrix.md + references/routing-table.md.
  • Solicitudes relacionadas con improve → Cargar improve-mode/SKILL.md + references/seven-leverage-points.md.
  • Autoevaluación de completitud → Leer la sección Gotchas de este archivo.

Extensión y estructura

  • SKILL.md principal (enrutador): ≤ 200 líneas (actual ~150, dentro del límite).
  • Sub-skills SKILL.md: ≤ 250 líneas.
  • Sub-skills references/: Se cargan bajo demanda, no se inyectan en el contexto principal.
  • Número total de archivos del esqueleto: ≤ 20.

Skills relacionados