CommunityEscrita e Ediçãogithub.com

troels-im/agent-skills-playbook-template

Modelo progressivo de docs-as-code para skills de agentes de IA, AGENTS.md, playbooks, traces de trabalho e políticas de teste 'just'.

O que é agent-skills-playbook-template?

Este skill, chamado **Lets**, fornece uma superfície de comando de baixo custo (baixo consumo de tokens) para fluxos de trabalho baseados em repositórios. Ele foi projetado para agentes como Claude Code, Cursor ou Codex, e usa uma abordagem estruturada de 'código como documentação'. O skill guia o agente através de um processo de seleção e execução de fluxos de trabalho armazenados em um diretório `flows/`. Ao iniciar, o agente lê um arquivo AGENTS.md, um índice raiz e um índice de fluxos para escolher o menor fluxo correspondente. O skill então instrui o agente a criar ou atualizar uma lista de verificação de execução (run checklist) com um nome padronizado baseado em timestamp UTC, seguir os playbooks nomeados no fluxo, e prefixar atualizações de progresso com um formato percentual. Como barreira de qualidade, o skill exige a execução de `just turn-test` antes de cada commit e `just pr-test` no passo final do fluxo. Ele inclui portões de entrada (user input gates) que forçam o agente a pausar e pedir informações ou aprovação do usuário quando um passo requer, evitando suposições. Apenas quando o usuário explicitamente autoriza o agente a continuar com seu melhor julgamento, as suposições podem ser registradas na checklist. Se nenhum fluxo corresponder, o agente deve rotear a requisição através de um playbook específico. O comando para ativar este template é `/lets`, não `/goal` ou `/loop`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Lets

Use este skill como a superfície de comando de baixo custo (baixo token) para fluxos de repositório.

Fluxo de Trabalho

  1. Leia AGENTS.md.
  2. Leia o index.md raiz.
  3. Leia flows/index.md.
  4. Selecione o menor fluxo correspondente.
  5. Carregue o arquivo do fluxo selecionado.
  6. Crie ou atualize a lista de verificação de execução do fluxo nomeada por aquele fluxo. Use slugs baseados em timestamp UTC para nomes de execução gerados: run-YYYYMMDDTHHMMSSZ-short-slug.md.
  7. Siga apenas os playbooks nomeados pelo fluxo e exigidos pelo passo atual.
  8. Prefixe as atualizações de progresso com o formato exigido pelo fluxo: XX% / YY% / ZZ%: mensagem.
  9. Execute just turn-test antes de cada commit.
  10. No passo final de um fluxo, execute just pr-test, corrija os testes de PR que falharem e repita até que os testes de PR passem ou um bloqueio real seja registrado.

Portões de Entrada do Usuário

Quando um passo do fluxo precisar de entrada do usuário, aprovação, uma decisão de produto ou feedback para continuar corretamente, pause o loop e pergunte. Não infira decisões faltantes nem continue com requisitos presumidos.

Continue sem perguntar apenas quando o usuário disser explicitamente para não interrompê-lo, não perguntar, prosseguir com o melhor julgamento, ou der uma instrução equivalente. Ao fazer isso, registre a suposição na lista de verificação da execução e mantenha-a reversível quando possível.

Se nenhum fluxo corresponder, diga isso claramente e encaminhe através de playbooks/repository/choose-workflow.md.

Não trate /goal ou /loop como comandos de usuário para este template. Use /lets como o comando voltado ao usuário e flows/ como a camada durável do repositório.

Habilidades Relacionadas