Yakui Studio - 配乐工作室

Crie trilhas sonoras programáticas em estilo 8-bit/chip a partir de áudio de referência ou motivação original, com separação de faixas real, transcrição polifônica e monofônica, edição manual, orquestração de eventos e exportação de loop. Ideal para BGM de jogos e adaptações com código fonte editável.

O que é Yakui Studio - 配乐工作室?

Esta skill transforma ideias musicais em trilhas sonoras programáticas no estilo chip/8-bit, combinando técnicas de análise de áudio, transcrição e síntese. Ela suporta dois fluxos principais: a partir de uma referência de áudio, onde realiza separação de faixas (stems) com Demucs e transcrição com Basic Pitch/pYIN, ou a partir de uma motivação original, onde o compositor pode criar livremente. O resultado é um conjunto de arquivos editáveis (partitura em JSON, sintetizador em Python) que podem ser renderizados como áudio loopável. A skill é projetada para ser usada com o ambiente Yakui Studio, mas também pode ser executada de forma independente. Ela prioriza a edição manual e a verificação humana, garantindo que a transcrição não seja tratada como verdade absoluta, e permite ajustes finos na orquestração, timbres e duração. O fluxo inclui análise de referência, inicialização de faixa, edição de partitura, síntese e entrega de áudio final com preview, loop e relatório de renderização.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2409324124/yakui-studio/tree/HEAD/skills/procedural-chiptune

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Trilha Sonora Programática em Estilo Chip

Separe a informação musical do motor de timbre: áudio de referência → faixas reais sob demanda → candidatos a transcrição e edição → partitura de eventos → síntese de forma de onda → pré-escuta/mestre em loop. Suporta música original sem referência; neste caso, pule a transcrição.

Primeiro, Defina os Objetivos Musicais

Priorize a referência, duração, estilo e faixas já aprovadas pelo usuário. Para detalhes não críticos ausentes, escolha um rascunho razoável sem repetir perguntas já respondidas. Salve novas versões em diretórios de faixa independentes, preservando o original aprovado. A criação em si não representa autorização para integrar sites, jogos ou publicar npm.

Para adaptação de referência, leia primeiro Análise e Decisão de Referência. Se precisar preservar detalhes de linha principal/resposta na mixagem, leia Faixas Reais e Transcrição e use Demucs + Basic Pitch ONNX/pYIN; o modo NumPy básico não puxa automaticamente essas dependências pesadas. Ao usar o Yakui Studio Workbench para edição e importação, leia o Yakui Studio instalado no mesmo nível. Se for apenas para entender a origem dos métodos, leia Caso Yakui; a velocidade, acordes e comprimentos de seção do caso não são regras padrão para novas músicas.

Análise de Áudio de Referência

Reporte resultados de análise somente após obter áudio decodificável real. BPM ou tabelas de notas fornecidas pelo usuário em texto precisam ser verificados; descrições de página, nomes de música e links de vídeo online não são evidência de que o áudio foi ouvido. Quando houver apenas URL, use os meios de obtenção de mídia normais disponíveis; se o acesso for bloqueado, explique o que está faltando, não invente resultados de transcrição. Gravações de referência não são automaticamente mixadas nas faixas ou no pacote de código fonte.

Ferramentas básicas:

python scripts/analyze_reference.py referencia.wav --start 0 --seconds 30 --out analise-intro.json

O caminho é relativo a esta skill; pode-se usar seu caminho absoluto. Dependências: Python 3.10+, NumPy. Para decodificação de referência e exportação MP3, também é necessário FFmpeg (no PATH ou variável FFMPEG).

  • Compare pelo menos os candidatos a batida do início e das seções principais, observando metade/dobro da velocidade; só então passe --bpm para alinhar os candidatos a notas.
  • half_beat_candidates é a saliência harmônica na mixagem, não uma melodia independente reconhecida automaticamente. O pico mais alto pode pertencer ao harmônico do baixo, bateria ou outra voz.
  • Anote observações, candidatos de baixa confiança e escolhas de arranjo; quando a resposta aguda não puder ser extraída de forma confiável, mantenha a ambiguidade; respostas originais devem ser marcadas explicitamente.
  • Para adaptações que priorizam detalhes, faça a separação em faixas reais primeiro, salve os rótulos do modelo conforme as sources reais; depois use transcrição polifônica para preservar notas simultâneas e F0 monofônico para contrastar seções melódicas claras. Melodia principal/resposta são papéis musicais; não transforme automaticamente filtragem de banda ou other do Demucs em faixas de papel independentes.
  • Mantenha timestamps originais, pitch bends, valores de confiança/ativação e razões de edição no arquivo de análise; a quantização só adiciona campos derivados. Use a pauta e frases reais representativas para verificar oitavas, ornamentos curtos, notas repetidas e toques simultâneos; não trate a saída do modelo como partitura precisa da música original.

Crie uma Faixa Editável

python scripts/init_track.py /caminho/absoluto/nova-faixa --title "Título da faixa" --bpm 95 --bars 24

Isso copia um template de arranjo independente, sintetizadores e entrada de build, sem sobrescrever diretórios existentes. A saída inclui track.json, arrange.py, render_score.py, build.py e lista de dependências. A motivação do template é apenas um exemplo original; deve ser modificada conforme os objetivos musicais atuais; não renderize toda música como o template trocando apenas o BPM.

No diretório da faixa, execute:

python -m pip install -r requirements.txt
python build.py --mp3 --three-pass

Faça primeiro frases/seções representativas e depois expanda para a duração alvo; quando o usuário já aprovou o arranjo detalhado, siga-o diretamente sem criar barreiras de aprovação adicionais.

  • A semínima é a unidade de tempo do evento; a duração é calculada a partir de BPM, número de compassos e fórmula de compasso; quando próximo da duração especificada, explique as restrições de pulsação, não force a duração acelerando o áudio inteiro.
  • Melodia principal, resposta, baixo, harmonia, arranjo e bateria são orquestrados separadamente. No clímax, aumente a extensão, ritmo e densidade harmônica, deixando espaço de panorâmica e nível para a melodia principal.
  • Sintetizadores usam ondas PolyBLEP de pulso comprovadas, ondas triangulares de harmônicos limitados, ruído LFSR para bateria, envelopes curtos e delay no tempo. Ajuste timbres por faixa; expandir vozes chip não significa simular estritamente as limitações de canais do FC/NES.
  • A análise e transcrição de referência podem servir a outros estilos; quando o usuário especificar estilos como pós-rock, preserve as melodias já verificadas e escolha instrumentos/ renderizadores adequados ao estilo. Templates chip não se transformam automaticamente em timbres de guitarra real ou pós-rock; não troque rótulos do template para fingir novo estilo.
  • 8-bit por padrão refere-se a timbre/arranjo; a saída mantém qualidade 44,1 kHz, 16 bits estéreo, a menos que o usuário exija explicitamente redução de profundidade de bits.

Para editar diretamente a partitura ou ajustar timbres, leia Formato de Partitura de Eventos. render_score.py score.json --out audio --mp3 --three-pass pode pular o arranjador e renderizar qualquer partitura compatível.

Pré-Escuta e Entrega

audio/ gera preview.wav, loop.wav, MP3 opcional, trecho do clímax e render-report.json. O preview pode ter fade out; o master do loop não tem fade out completo, mas a cauda atrasada envolve para o início. --three-pass gera teste de emendas em três passes.

Verifique duração, valores finitos, clipping, nível de seção e transições abruptas perto do loop; verificações digitais não substituem a audição. Quando a capacidade de ouvir não estiver disponível, entregue arquivos reproduzíveis para o usuário testar, não afirme que já ouviu. Foco no tema, resposta, densidade do clímax, clareza do solo e emendas do loop; não declare que o estilo combina só porque o arquivo de música existe.

Incorpore áudio com caminhos absolutos para fornecer pré-escuta completa e trecho representativo do clímax; anexe código de arranjo/síntese, partitura e breve descrição de seção. Quando o usuário pedir reprodução leve no terminal, porte o sintetizador local para os mesmos parâmetros de evento e timbre, evitando incorporar PCM inteiro ou exigir que o usuário instale Python; não altere automaticamente o visualizador ou o fluxo de publicação para fazer a pré-escuta.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas