Um motor de anotação de código profissional que substitui comentários prolixos gerados por AI por documentação técnica concisa de nível sênior em chinês natural.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install code-comment
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o code-comment usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Code Comment?
A skill Code Comment foi projetada para atuar como um Senior Tech Lead, focando na remoção de explicações robóticas, redundantes e literais frequentemente geradas por ferramentas de AI padrão. Ela visa a remoção de comentários óbvios que explicam o que o código faz em favor de insights significativos que explicam por que uma lógica específica existe. Ao aplicar uma política rigorosa de 'sem sabor de AI', garante que seu repositório mantenha um estilo de documentação limpo, profissional e centrado no ser humano.
Esta skill suporta uma ampla gama de linguagens de programação populares, incluindo Java, C++, Kotlin, JavaScript, TypeScript, Python, Rust, Go e React (JSX/TSX). Prioriza a saída em chinês nativo, removendo frases traduzidas por máquina e pontuação desnecessária para entregar um código pronto para uso imediato em produção.
Casos de uso do Code Comment
- Refatoração de bases de código legadas para melhorar a legibilidade e remover dívida técnica na documentação.
- Limpeza de trechos de código gerados por AI para garantir que atendam aos padrões profissionais de codificação.
- Padronização de estilos de comentários em projetos multilíngues para consistência da equipe.
- Revisão e otimização de docstrings (JSDoc, KDoc, etc.) para melhor clareza e brevidade.
- Proteção de lógica sensível com avisos concisos sobre concorrência ou riscos de desempenho.
Como o Code Comment funciona
- A skill identifica todos os comentários existentes no bloco de código fornecido em várias linguagens suportadas.
- Filtra comentários óbvios que apenas repetem o sentido literal do código (ex: i++ // incrementa i).
- Mapeia frases de AI prolixas para terminologia técnica concisa usando uma tabela de mapeamento interna especializada.
- As strings de documentação são reestruturadas para manter tags necessárias como @param e @return, simplificando o texto descritivo.
- A saída final é renderizada como um arquivo completo e executável dentro de um bloco Markdown específico da linguagem, excluindo estritamente textos explicativos.
Configuração do Code Comment
Para integrar esta skill ao seu ambiente, certifique-se de que seu agent tenha acesso ao diretório Openclaw Skills. Não são necessárias dependências externas além de um host de agent de AI compatível.
# Example: Triggering code-comment via CLI
openclaw run code-comment --path ./src/main.ts
Esquema de Dados e Taxonomia de Code Comment
A skill processa e entrega dados com base na seguinte taxonomia:
| Tipo de Dado | Descrição |
|---|---|
| Input | Código-fonte bruto com comentários prolixos ou gerados por AI |
| Processed Logic | Preservação de nomes de variáveis, imports e lógica funcional |
| Output | Bloco de código envolto em Markdown com comentários em chinês otimizados |
| Format | Sintaxe específica da linguagem (ex: JSDoc para TS, Docstring para Python) |
Recursos avançados do Code Comment
- Suporte multilíngue com detecção de sintaxe sensível ao contexto para React JSX vs. JavaScript padrão.
- Adesão estrita a limites de 5 palavras para comentários inline para manter extrema brevidade.
- Mapeamento automático de termos traduzidos por máquina para jargões de desenvolvedores padrão da indústria (ex: mudar 'valor de backup' para 'fallback').
- Garantia de zero mutação de lógica, assegurando que apenas blocos de comentários sejam modificados, deixando a lógica de execução intocada.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Edição de Vídeo com DaVinci
Transforme filmagens brutas em exportações 4K polidas usando ferramentas de edição de estilo DaVinci baseadas em AI e renderização remota por GPU.
Video Maker Free Export
Uma poderosa habilidade de edição de vídeo com AI que transforma clipes brutos em exportações MP4 1080p polidas através de comandos de texto simples e renderização remota em GPU.
Visual Content Generator Claw
Um especialista em ativos visuais orientado por AI projetado para gerar rapidamente pôsteres, imagens para mídias sociais, capas de vídeo e fundos para humanos digitais.
TokenRouter Image Generator
Uma poderosa habilidade multimodal para gerar e editar imagens via modelos compatíveis com TokenRouter dentro do ecossistema OpenClaw.
AI Video Generator Free Kiss
Uma ferramenta automatizada de criação de vídeo por AI que transforma fotos de retratos estáticos em cenas de beijo animadas realistas para redes sociais.
Karaoke Lyric Video Maker Free
Uma ferramenta movida por AI que transforma arquivos de áudio em vídeos de letras de karaokê de alta qualidade com sincronização automática no nível da palavra.
Apresentou*
