FiboCode

Fibo Skills

Quando você opera um Agent CLI (Claude Code, Codex ou qualquer agente com suporte a skills) no terminal integrado do FiboCode, Fibo Skills ensina a esse agente o fluxo de trabalho orientado por especificações do FiboCode. Elas são opcionais — o terminal funciona sem elas —, mas a instalação fornece ao agente o mesmo ciclo brainstorm → spec → plan → execute → sync seguido pelo FiboCode, fazendo com que a saída seja registrada no sistema de documentos .fibo/ em vez de se afastar do seu código.

Skills são instruções empacotadas que o agente carrega sob demanda. Fibo Skills é open source e instalado no seu agente, não no FiboCode.

Repositório das skills: github.com/Alenkz12/FiboSkills

O conjunto de skills

Este é um único fluxo de trabalho, não um monte de comandos sem relação. As cinco primeiras skills passam o trabalho de uma etapa à seguinte; as duas últimas funcionam de forma independente:

SkillEtapaPara que serve
fibo-brainstormingEsclarecer a ideiaTransforma uma intenção vaga em uma lista de AC aprovada
fibo-writing-planDecidir a abordagemProduz design.md e plan.md a partir da spec
fibo-executing-planEscrever o códigoExecuta as tarefas do plano uma por vez e em ordem
fibo-recording-diffDeixar um registroTransforma o diff real em um diff.md legível, hunk a hunk
fibo-conventionsManter as regrasUm conjunto de regras para nomes, comentários, documentos e commit sync
fibo-code-analysisLer o códigoProduz o espelho de análise em camadas file → structure → folder
fibo-skills-reviewerAutomanutençãoAudita a redação dos próprios arquivos de skills

fibo-brainstorming — definir primeiro o requisito

É invocado antes de qualquer mudança no comportamento visível externamente. Faz uma pergunta de cada vez, com opções sempre que possível, refinando “quero um recurso” até chegar a critérios de aceitação em sintaxe EARS, e só grava spec.md depois da sua aprovação explícita. Não escreve código de produção, não executa testes e não faz commits — sua única função é eliminar ambiguidades.

fibo-writing-plan — transformar a spec em design e tarefas

É invocado quando a spec está aprovada. Lê spec.md e produz, no mesmo diretório, design.md (o HOW, com cada decisão de design marcada por ↔ AC) e plan.md (uma lista em que cada tarefa informa seus ACs, arquivos e método de verificação). Se a cobertura de AC for inferior a 100% ou uma tarefa citar um AC inexistente, ele se recusa a gravar no disco.

fibo-executing-plan — executar o plano estritamente em série

Executa as tarefas de plan.md uma por uma, nunca em paralelo, para que tarefas concorrentes não colidam nos mesmos arquivos. Cada tarefa só pode alterar os arquivos da própria lista. Em caso de falha, para e pergunta se você deseja ignorar / abortar / tentar novamente, em vez de reverter sozinho. Quando tudo termina, imprime um relatório de implementação e segue direto para o registro do diff e a sincronização de documentos.

fibo-recording-diff — tornar a alteração legível

É invocado após a implementação. Transforma um diff real em explicações por hunk, ordena os arquivos alterados em uma sequência coerente de leitura, anexa uma âncora de código e, quando útil, uma visualização lógica Mermaid a cada hunk, e explica por que ele existe e como se conecta à lógica ao redor. Não altera o código nem os ACs.

fibo-conventions — uma só voz para documentos e comentários

Aplica-se ao escrever Markdown, adicionar comentários ao código ou criar algo em .fibo/docs/: uso de Mermaid, formatos das tags code / text / graph, regras de caminhos e nomes, sincronização entre comentários e código e sincronização documental em lote antes do commit, cuja base é acompanhada em .fibo/index.json.

fibo-code-analysis — saída de análise estruturada

É usado para gerar a análise estruturada em .fibo/analysis e para compreender ou ampliar o pipeline de análise do próprio FiboCode: seleção de prompts, concorrência, organização em disco e prompts por linguagem. Esta skill e Code Analysis no aplicativo são duas entradas para a mesma forma de compreender código.

fibo-skills-reviewer — um check-up das próprias skills

Audita apenas a redação dos arquivos de skills: contradições, lacunas lógicas, referências pouco claras, divergência por redundância e notas internas de manutenção expostas. Altera como uma regra é dita, nunca qual é a regra; quando encontra um conflito real, para e deixa a decisão para você.

Instalação: Claude Code

Claude Code lê skills de um diretório .claude/skills/. O nível de projeto limita seu uso a um código; o nível de usuário as disponibiliza em todos os lugares:

# Project level (recommended: travels with the repo, so team and agent share one rule set)
git clone https://github.com/Alenkz12/FiboSkills .claude/skills

# Or user level (available in every project)
git clone https://github.com/Alenkz12/FiboSkills ~/.claude/skills

Reinicie o Claude Code (ou inicie uma nova sessão) e as skills fibo-* aparecerão na lista. Invoque uma com /fibo-brainstorming ou simplesmente descreva sua tarefa e deixe o agente escolher a etapa adequada.

Instalação: Codex e outros agentes

Os arquivos de skills são Markdown simples com frontmatter YAML, portanto são portáteis entre agentes. Clone-os onde preferir:

git clone https://github.com/Alenkz12/FiboSkills
  • Agentes com mecanismo nativo de skills — aponte o diretório de skills para o clone, seguindo a documentação do próprio agente.
  • Agentes que só leem um arquivo de instruções — descreva nesse arquivo (por exemplo, AGENTS.md) a localização e a finalidade dessas skills para que o agente as leia na etapa certa.

Verifique se funcionam

Peça algo pequeno ao agente no terminal integrado do FiboCode, como “adicione uma opção de configuração a este repositório”. Se as skills estiverem ativas, ele não editará o código primeiro; abrirá a etapa de brainstorming para confirmar os ACs e depois deixará spec.md, design.md e plan.md em .fibo/docs/specs/<feature>/.

Mantê-las atualizadas

Como as skills ficam em um git clone, basta uma linha para buscar a versão mais recente:

cd .claude/skills && git pull

Obter ajuda