duongphuhiep/dakubo-skills

Use quando o usuário quiser responder a um comentário de revisão de código adicionando um comentário esclarecedor no código-fonte — para que o revisor entenda o raciocínio e não levante o mesmo comentário novamente. Ativa com "responder ao comentário #N", "adicionar comentário para abordar preocupação do revisor", "documentar por que fizemos X" ou qualquer solicitação para resolver uma descoberta de revisão por meio de explicação no código, em vez de uma alteração de código.

O que é dakubo-skills?

Esta skill permite que um agente de IA resolva comentários de revisão de código inserindo comentários esclarecedores diretamente no código-fonte. Ela é útil porque documenta o raciocínio por trás de decisões de design, evitando que revisores levantem a mesma preocupação repetidamente, sem a necessidade de alterações no código. A skill é compatível com qualquer ambiente que suporte skills de agente de IA, como Claude Code, Cursor ou Codex. Para funcionar, a skill infere dois parâmetros do contexto da conversa: o comentário do revisor (geralmente vindo de uma tabela de habilidades como `dakubo-display-pr-remarks`) e a explicação do desenvolvedor sobre por que o código está correto. Ela então lê o arquivo relevante, identifica o construto alvo, redige um comentário conciso (máximo de 4 linhas) que captura a essência da explicação sem mencionar o revisor ou o PR, e insere o comentário logo acima do construto alvo. A skill evita reescrever o código, repetir o que o código já diz ou adicionar comentários longos que seriam mais adequados para documentos de design.

Funciona com~Claude Code~Codex CLI~Cursor

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

Documentação

Responder ao Comentário de Revisão

Resolva um comentário de revisão de código inserindo um comentário esclarecedor no local certo do código-fonte, capturando o raciocínio para que revisores futuros não levantem a mesma preocupação.

Entradas

Infira ambas as entradas a partir do contexto da conversa. Pergunte apenas se for ambíguo.

Entrada 1 — O comentário. Um apontamento do revisor: geralmente uma linha de tabela com uma localização (arquivo:linha) e uma descrição da preocupação. A tabela geralmente vem da skill dakubo-display-pr-remarks ou dakubo-review-commit-range. Se não houver tabela na conversa e uma dessas skills estiver disponível, use-a para gerar a tabela. Caso contrário, peça ao usuário o comentário.

Entrada 2 — A explicação. A resposta do desenvolvedor: por que o código está correto como está, a decisão de design por trás dele, o trade-off aceito ou o contexto geral que faltava ao revisor. Isso pode não refutar diretamente o comentário — pode apenas mudar a perspectiva do revisor.

Processo

Leia o arquivo na localização da Entrada 1.
Identifique o construto exato que o comentário atinge (método, bloco, campo, linha).
Elabore um comentário que:
- Capture a essência da Entrada 2 (o raciocínio / decisão / contexto).
- Seja conciso — no máximo uma a quatro linhas.
- Não mencione o revisor, o PR ou o número do comentário (comentários sobrevivem às revisões).
- Não repita o que o código já diz — adicione apenas o PORQUÊ que não é óbvio pela leitura.
- Aborde a preocupação do comentário se isso tornar a explicação mais clara, mas isso é opcional.
Coloque o comentário imediatamente acima do construto alvo, ou inline se um comentário no final da linha couber naturalmente.
Aplique a edição.

Saída

Confirme o arquivo e a linha onde o comentário foi adicionado. Uma frase é suficiente.

O que NÃO fazer

Não reescreva o código, a menos que o usuário peça explicitamente.
Não escreva um comentário que apenas repita o que o código faz.
Não faça referência a "o revisor disse…" ou "PR #N" dentro do comentário.
Não adicione um comentário com mais de ~4 linhas; se a explicação precisar de mais, ela pertence a um documento de design ou mensagem de commit, não a um comentário inline.