Communitygithub.com

AaronAsAChimp/skills

Use para portar código de uma linguagem de programação para outra.

O que é skills?

Esta skill permite que um agente de IA portar (traduzir) código-fonte de uma linguagem de programação para outra. É útil para desenvolvedores que precisam migrar projetos, reutilizar lógica em diferentes ecossistemas ou converter bibliotecas. A skill suporta qualquer par de linguagens e pode ser usada com ferramentas como Claude Code, Cursor ou Codex. O processo começa com a criação de um esboço das funcionalidades principais, identificação de bibliotecas equivalentes e tratamento de casos de borda. Em seguida, os testes unitários são portados primeiro para servir como base de verificação. O código final é portado iterativamente, seguindo convenções e padrões da linguagem alvo, mantendo comentários e logs. A skill também oferece opções como implementar stubs ou criar funcionalidades do zero.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronAsAChimp/skills/tree/HEAD/skills/porting-code

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portando código

Esta skill é usada para portar código de uma linguagem para outra.

Entrada

  • Linguagem alvo
  • Arquivos fonte ou código a ser portado

Processo

Comece criando um esboço das funcionalidades principais presentes no código atual. Anote quaisquer:

  • Casos de borda que o código ou testes unitários consideram
  • Bibliotecas utilizadas e equivalentes recomendados na linguagem alvo.

Use a ferramenta de entrada ou perguntas estruturadas para percorrer cada biblioteca utilizada e verificar com o usuário qual equivalente usar.

Opções adicionais a apresentar:

  • Funcionalidade de stub (esboço)
  • Implementar do zero

Em seguida, porte quaisquer testes unitários. Use isso como base para verificar o código portado.

Finalmente, porte o código usando o esboço preparado anteriormente. Itere sobre isso usando os testes unitários para informar correções.

Diretrizes gerais

  • Use padrões comuns para a linguagem alvo.
  • Use convenções de nomenclatura comuns para a linguagem alvo.
  • O código portado deve espelhar o código original para que seja fácil para o usuário encontrar funcionalidades equivalentes.
  • Mantenha logs e comentários presentes no código original.
  • Anote quaisquer novos casos de borda.
  • Anote quaisquer alterações na estrutura do código para ajudar o usuário a se orientar.

Critérios de sucesso

  • Testes unitários passam, se presentes.
  • Linting passa, se presente.
  • Todas as funcionalidades principais estão implementadas.
  • Todos os casos de borda identificados foram considerados.
  • Todas as bibliotecas necessárias estão instaladas e prontas para uso.

Exemplos

Exemplo de código original

/**
 * Calcuta o preço final do produto incluindo quaisquer descontos e com imposto.
 * 
 * Lança um erro em caso de desconto inválido.
 */
export function calculatePrice(basePrice: number, discount: number | null, taxRate: number): number {
	let discountAmount = 0;

	if (discount) {
		if (discount >= 1) {
			// Se os descontos estiverem mal configurados, podem resultar em um
			// preço negativo. Pare antes de mostrar ao usuário um preço inválido.
			throw new Error('Invalid discount');
		}

		discountAmount = basePrice * discount;
	}

	const taxAmount = (basePrice - discountAmount) * taxRate;

	return (basePrice - discountAmount) + taxAmount;
}

Exemplo de esboço

Funcionalidades principais:

  • A função calculatePrice aceita um preço base, percentual de desconto e uma taxa de imposto e calcula o preço final do produto.
    • Casos de borda:
      • Desconto pode ser nulo
      • Se o desconto for maior ou igual a 1, lançar uma exceção para evitar preços inválidos.

Exemplo de código portado

def calculate_price(base_price: float, discount: Optional[float], tax_rate: float) -> float:
	"""
	Calcuta o preço final do produto incluindo quaisquer descontos e com imposto.

	Lança uma exceção em caso de desconto inválido.
	"""
	discount_amount = 0

	if discount is not None:
		if discount >= 1:
			# Se os descontos estiverem mal configurados, podem resultar em um
			# preço negativo. Pare antes de mostrar ao usuário um preço inválido.
			raise Exception('Invalid discount')

		discount_amount = base_price * discount

	tax_amount = (base_price - discount_amount) * tax_rate

	return (base_price - discount_amount) + tax_amount

Exemplo de resposta

Portei o código para Python.

  • calculatePrice agora é calculate_price

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Habilidades Relacionadas