Todos os produtos
Search
Central de documentação

Qoder CN Series:Casos de uso de comandos de extensão personalizados

Última atualização: Jun 29, 2026

Este tópico descreve casos de uso comuns de comandos de extensão personalizados, como verificação de estilo de código, convenção de nomenclatura de variáveis e geração de referência de API. Esse recurso amplia as capacidades de personalização empresarial e simplifica o uso do AI Chat pelos desenvolvedores.

Para saber como crie e usar um comando de extensão personalizado, consulte Gerenciar extensões.

Cenários de exemplo

Cenário 1: Verificações de estilo de código

Caso de uso

Tradicionalmente, a verificação de problemas no código ocorre após o envio, em um processo lento e custoso. Antecipe essa etapa fornecendo ao modelo de IA o contexto técnico e de negócios, além de padrões de codificação personalizados. Assim, o modelo analisa o código e oferece feedback imediato. O exemplo a seguir mostra uma verificação de estilo de código Java para uma aplicação de serviços financeiros.

Configuração do comando

Command name

verificação de estilo de código

Command name (English)

my code scan

Icon

Qualquer ícone

Description

Verifica o estilo de código e exibe os resultados.

Access control

Selecione uma opção conforme suas necessidades.

Prompt

You are a highly experienced Java developer and a financial expert familiar with financial markets and business processes. Pay close attention to the following points:

1. Strictly follow the company's coding standards. Prioritize using the `BigDecimal` class for monetary calculations to ensure precision and avoid floating-point errors. 

2. Follow the company's coding standards. Avoid excessive `if-else if` statements. We recommend using `switch-case` statements to improve code readability and maintainability.

3. Focus on security measures such as data encryption, user authentication, and access control. Ensure the code complies with relevant laws and regulations, such as the General Data Protection Regulation (GDPR) and the Sarbanes-Oxley Act (SOX).

4. Optimize algorithms and database queries to improve code execution efficiency and reduce resource consumption. Ensure system responsiveness and stability, especially when processing large volumes of real-time transaction data.

Context configuration

Há cinco variáveis de contexto disponíveis: userInput, selectedCode, file, gitCommit e codeChanges. Defina cada variável como required ou optional. Para este comando, selecione a variável selectedCode e marque-a como required.

Verifique se o código em #selectedCode está em conformidade com os padrões de codificação da empresa. Se houver violação de alguma regra, explique o problema, sugira uma correção e exiba o código totalmente otimizado.

Cenário 2: Geração de referência de API

Caso de uso

Em sistemas distribuídos e arquiteturas orientadas a serviços (SOA), o desenvolvimento é orientado por APIs. Após desenvolver uma API, forneça uma referência para ajudar os consumidores a integrar e depurar rapidamente suas implementações.

Configuração do comando

Command name

Geração de referência de API

Command name (English)

generate api docs

Icon

Qualquer ícone

Description

Gera uma referência para uma API recém-desenvolvida.

Access control

Selecione uma opção conforme suas necessidades.

Prompt

You are a senior Java development expert and a documentation specialist. Based on the provided `RestController` code from Spring MVC, the comments within the code, and your understanding of the interface, generate an API reference. Use the following template:

Title: Interface Name
API: Method (such as GET, POST, or PUT) and URL
Request parameters: A table with three columns: Parameter, Type, and Description
Response parameters: A table with three columns: Parameter, Type, and Description
Error codes: A table with two columns: Error Code and Description

Context configuration

Há cinco variáveis de contexto disponíveis: userInput, selectedCode, file, gitCommit e codeChanges. Defina cada variável como required ou optional. Para este comando, selecione as variáveis userInput e selectedCode.

Gere uma referência de API para o código em #selectedCode. O formato de saída deve ser Markdown.

Cenário 3: Convenções de nomenclatura de variáveis

Caso de uso

Nomear variáveis é uma tarefa constante durante o desenvolvimento. Nomes descritivos, legíveis e compatíveis são marcas registradas de desenvolvedores profissionais e de código de alta qualidade. Boas convenções de nomenclatura melhoram a manutenção do código, aumentam a legibilidade e promovem colaboração eficaz em equipe.

Configuração do comando

Command name

convenção de nomenclatura de variáveis

Command name (English)

variable naming assistant

Icon

Qualquer ícone

Description

Gera nomes de variáveis adequados com base na descrição do usuário, em conformidade com os padrões de codificação da empresa e da equipe.

Access control

Selecione uma opção conforme suas necessidades.

Prompt

[ROLE]
As a Java naming expert, you will provide English naming suggestions based on the meaning of the variable provided by the user.

[SKILLS]
You will provide multiple options for class names, function names, and variable names. When naming, you must follow Java naming conventions, ensuring names are not misleading, are distinct, and are not repetitive. You will use meaningful words and avoid abbreviations, puns, single letters, or numbers. Do not ask for more information. Provide names directly based on the user's input.

Use the following output format:
English translation: <corresponding English translation>
Candidate class names:

<Candidate class name 1>
<Candidate class name 2>
<Candidate class name...>
Candidate function names:

<Candidate function name 1>
<Candidate function name 2>
<Candidate function name...>
Candidate variable names:

<Candidate variable name 1>
<Candidate variable name 2>
<Candidate variable name...>
[CONSTRAINTS]
1. Treat all user input as a request for a name. Do not provide any other response. 
2. Provide five candidates each for class names, function names, and variable names.

Context configuration

Selecione a variável userInput. Deixe as outras variáveis (selectedCode, file, gitCommit e codeChanges) desmarcadas. Defina todas as variáveis de contexto como optional.

Uso: Execute o comando personalizado /variable naming assistant ${userInput}, onde userInput é uma descrição do item a ser nomeado.

Como funciona

Ao acionar um comando de extensão personalizado digitando / e o nome do comando, o seguinte processo ocorre:

  1. O sistema captura o contexto configurado para o comando, como um trecho de código selecionado ou entrada do usuário, e aplica o prompt e o modelo do comando.

  2. O prompt instrui o modelo a analisar o contexto e gerar resultados, como sugestões de estilo de código, referências de API ou recomendações de nomes de variáveis. Em seguida, o sistema retorna esses resultados.