duongphuhiep/dakubo-skills

Úsalo cuando el usuario quiera responder a una observación de revisión de código añadiendo un comentario aclaratorio en el código fuente, para que el revisor entienda el razonamiento y no vuelva a plantear la misma observación. Se activa con expresiones como "responder observación #N", "añadir comentario para abordar la inquietud del revisor", "documentar por qué hicimos X" o cualquier solicitud de resolver un hallazgo de revisión mediante una explicación en el código en lugar de un cambio en el código.

¿Qué es dakubo-skills?

Esta habilidad permite a un agente de IA resolver observaciones de revisiones de código insertando comentarios aclaratorios directamente en el código fuente. Es útil cuando un revisor hace una pregunta o plantea una preocupación que puede responderse explicando la razón, el contexto o la decisión de diseño detrás del código existente, en lugar de modificarlo. El agente lee el archivo en la ubicación de la observación, redacta un breve comentario que captura el razonamiento sin mencionar al revisor ni número de PR, y lo coloca justo encima del método, bloque o línea objetivo. Funciona en cualquier plataforma que soporte habilidades de agente de código, como Claude Code, Cursor o Codex. El agente infiere tanto la observación como la explicación a partir del contexto de la conversación, evitando repreguntar a menos que sea ambiguo. La habilidad garantiza que el comentario no repita lo que el código ya dice, se mantiene conciso (máximo 4 líneas) y evita referencias externas, priorizando así la claridad y permanencia del comentario en el código.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/duongphuhiep/dakubo-skills/tree/HEAD/package/skills/dakubo-answer-review-remark-in-code

Documentación

Responder Observación de Revisión

Resuelve una observación de revisión de código insertando un comentario aclaratorio en el lugar adecuado del código fuente, capturando el razonamiento para que futuros revisores no vuelvan a plantear la misma inquietud.

Entradas

Deduce ambas entradas del contexto de la conversación. Pregunta solo si es ambiguo.

Entrada 1 — La observación.
Un hallazgo del revisor: normalmente una fila de tabla con una ubicación (archivo:línea) y una descripción de la inquietud.
La tabla suele provenir de la habilidad dakubo-display-pr-remarks o dakubo-review-commit-range. Si no hay ninguna tabla en la conversación y una de estas habilidades está disponible, úsala para generar la tabla. Si no, pídele al usuario la observación.

Entrada 2 — La explicación.
La respuesta del desarrollador: por qué el código es correcto tal como está, la decisión de diseño detrás de él, la compensación aceptada o el contexto general que el revisor pasaba por alto. Puede que no refute directamente la observación; simplemente puede cambiar la perspectiva del revisor.

Proceso

Lee el archivo en la ubicación indicada en la Entrada 1.
Identifica la construcción exacta a la que apunta la observación (método, bloque, campo, línea).
Redacta un comentario que:
- Capture la esencia de la Entrada 2 (el razonamiento/decisión/contexto).
- Sea conciso: entre una y cuatro líneas como máximo.
- No mencione al revisor, al PR ni al número de observación (los comentarios sobreviven a las revisiones).
- No repita lo que el código ya dice; añada solo el PORQUÉ que no es obvio al leerlo.
- Aborde la inquietud de la observación si hacerlo aclara la explicación, pero esto es opcional.
Coloca el comentario inmediatamente encima de la construcción objetivo, o en línea si un comentario al final encaja de forma natural.
Aplica la edición.

Salida

Confirma el archivo y la línea donde se añadió el comentario. Una oración es suficiente.

Lo que NO debe hacerse

No reescribir el código a menos que el usuario lo solicite explícitamente.
No escribir un comentario que simplemente repita lo que el código hace.
No hacer referencia a "el revisor dijo…" o "PR #N" dentro del comentario.
No añadir un comentario de más de ~4 líneas; si la explicación necesita más, pertenece a un documento de diseño o mensaje de commit, no en línea.