CommunityPesquisa e Análise de Dadosgithub.com

yaolifeng0629/ylf-agent-skills

Habilidades do agente YLF para tarefas de codificação disciplinadas e instruções persistentes de projeto

O que é ylf-agent-skills?

Este skill do YLF Agent estabelece um conjunto de regras de codificação para manter a disciplina e consistência durante o desenvolvimento. Ele é projetado para ser usado em tarefas únicas ou, para instruções persistentes de projeto, através do comando `ylf-project-instructions`. O skill enfatiza a adaptação ao projeto atual, lendo arquivos como `AGENTS.md` e `CLAUDE.md`, e seguindo padrões existentes. Ele cobre desde a definição clara de conclusão de tarefas até verificações reais, mudanças cirúrgicas e relatórios concisos. Além disso, inclui regras de segurança para evitar ações destrutivas, como deleções em massa ou exposição de segredos. Suporta qualquer plataforma de agente de IA que siga instruções baseadas em markdown, focando em eficiência e minimização de riscos.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add yaolifeng0629/ylf-agent-skills

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Padrões de Codificação YLF

Use isso apenas para a tarefa atual. Para tornar esses padrões persistentes em um projeto, use ylf-project-instructions.

Este skill é propositalmente curto. Adapte-se lendo o projeto atual, não carregando todas as regras do projeto dentro deste arquivo.

Processo

  1. Defina a conclusão.

    • Declare o resultado concreto e como você irá verificá-lo.
    • Para trabalhos não triviais, mantenha uma pequena lista de verificação e atualize-a conforme avança.
    • Conclusão significa que o resultado solicitado está funcionando, verificado onde possível e claramente reportado.
  2. Adapte-se ao projeto.

    • Leia primeiro as instruções ativas do projeto: AGENTS.md, CLAUDE.md, arquivos README, scripts de pacote, configuração de teste e código próximo.
    • As regras do projeto substituem este skill. Este skill preenche lacunas sobre como trabalhar.
    • Siga padrões existentes, dependências, nomenclatura, layout de arquivos e comandos de verificação.
    • Prefira uma dependência madura do projeto ou um pacote open-source bem mantido em vez de uma implementação personalizada quando essa for a solução normal.
  3. Esclareça apenas quando importa.

    • Se a tarefa é clara e de baixo risco, prossiga.
    • Pare e pergunte antes de escolhas de alto impacto: arquitetura, formato de dados, serviços externos, ações destrutivas, refatorações amplas ou escopo ambíguo.
    • Ao perguntar, dê sua resposta recomendada e a compensação.
  4. Mude cirurgicamente.

    • Faça a menor alteração que satisfaça a solicitação.
    • Não refatore, reformate, renomeie ou limpe código adjacente a menos que a tarefa exija.
    • Remova apenas código não utilizado que sua própria alteração criou.
    • Se uma correção começar a se propagar para arquivos não relacionados, pare e explique o limite antes de continuar.
  5. Verifique de verdade.

    • Bugs: reproduza primeiro quando possível, depois prove a correção.
    • Scripts: execute com entrada representativa e inspecione a saída.
    • Web/UI: abra a página, verifique a renderização e exercite o fluxo alterado.
    • Implantações e integrações: verifique o serviço ao vivo ou o painel de controle quando houver acesso.
    • Se a verificação completa for bloqueada por ruído ambiental existente, execute a verificação mais restrita que ainda prove o resultado solicitado e diga o que permanece não verificado.
  6. Mantenha limites de segurança.

    • Não execute ações git a menos que o usuário peça explicitamente.
    • Não exclua arquivos ou diretórios em lote. Exclua apenas um caminho de arquivo explícito por vez. Se for necessária exclusão em massa, pare e peça ao usuário para lidar com isso.
    • Não exponha segredos. Tudo bem verificar se um segredo existe ou se um nome corresponde.
    • No Windows, separe ruídos ambientais como bloqueios de arquivo, problemas de pnpm sem TTY ou artefatos de build desatualizados da correção da alteração.
  7. Reporte de forma simples.

    • Diga ao usuário o que você alterou, qual é o resultado e o que foi verificado.
    • Mencione apenas itens não resolvidos que realmente permanecem.
    • Mantenha detalhes de implementação fora do relatório final, a menos que o usuário os solicite.

Poda

Ao atualizar este skill, mantenha cada regra se ela mudar o comportamento. Exclua exemplos longos, tutoriais de ferramentas e fatos específicos do projeto. Esses pertencem a instruções do projeto ou skills separados.

Habilidades Relacionadas