AnpingWhale/skills

Setup Anping Skills - Inicializador de Projetos

Inicializa o repositório atual como um ambiente de projeto adequado para colaboração de longo prazo com o Codex. Este Skill é orientado por prompt, não um script de instalação determinístico: primeiro explora, depois pergunta, em seguida apresenta um rascunho e, por fim, grava.

O objetivo não é instalar todos os Skills, mas combiná-los conforme a necessidade do projeto:

• Skills próprios do Anping, como multi-agent-orchestrator, transfer-codex-sessions.
• Skills externos de destaque, como os engineering skills de Matt Pocock.
• Regras de projeto e arquivos de conhecimento, como AGENTS.md, CONTEXT.md, CONTEXT-MAP.md, docs/agents/, docs/adr/.

Princípios de Execução

• Antes de começar, explique o veículo de execução. Inicializações longas ou com múltiplos arquivos devem seguir as regras de orquestração multi-agente do projeto atual; se a política da ferramenta não permitir delegação, explique o uso de fallback em etapas.
• Faça apenas uma pergunta por vez ao usuário. Não jogue todas as decisões de uma só vez.
• Para cada Skill recomendado, explique seu propósito, origem e por que é adequado para o projeto atual.
• Não inclua o código-fonte de Skills de terceiros. Skills externos devem ser integrados apenas por meio de origem de instalação ou diretório de referência.
• Antes de escrever arquivos, mostre quais arquivos serão modificados, os blocos principais e as opções padrão, e aguarde a confirmação do usuário.
• Não sobrescreva AGENTS.md, README.md, CONTEXT.md ou docs/agents/* existentes; atualize blocos já existentes, evitando duplicação.

Fluxo de Trabalho

1. Pré-verificação de Dependências de Skills

Verifique primeiro se os Skills essenciais já estão presentes na sessão atual e em ~/.codex/skills/. Leia references/skill-catalog.md e, de acordo com as necessidades do projeto, determine quais são obrigatórios, recomendados ou opcionais:

• Seleção de Skills e esclarecimento de objetivos: ask-matt, grill-with-docs.
• Modelagem de domínio e consolidação de conhecimento: domain-modeling.
• Orquestração da thread principal: multi-agent-orchestrator.
• Configuração de projetos de engenharia: setup-matt-pocock-skills.

Não instale automaticamente todos os itens ausentes. Primeiro, informe ao usuário os Skills ausentes, a origem, o propósito e o nível de recomendação; após a confirmação do usuário, instale usando skill-installer ou o método recomendado pela fonte original.

2. Explorar o Projeto

Leia rapidamente o estado atual do repositório e forneça apenas um resumo breve ao usuário, sem tirar conclusões precipitadas:

• git remote -v e .git/config: se é um projeto GitHub/GitLab/local.
• AGENTS.md, CLAUDE.md na raiz: se já existem regras de agente ou seções relacionadas a Agent skills.
• README.md na raiz: se o objetivo do projeto já está claro.
• CONTEXT.md, CONTEXT-MAP.md na raiz.
• docs/agents/, docs/adr/, src/*/docs/adr/.
• .scratch/: se já existe uma convenção de issues em markdown local.
• ~/.codex/skills/ ou Skills disponíveis na sessão atual: quais Skills próprios e externos já estão instalados.

3. Exibir Descobertas

Informe ao usuário com uma lista resumida:

• O tipo aproximado do projeto atual.
• Os arquivos de colaboração de IA já existentes.
• Os arquivos ausentes, mas que podem ser valiosos.
• Os Skills essenciais instalados/não instalados.
• Quais decisões serão perguntadas em seguida, uma de cada vez.

4. Perguntar de Forma Incremental

Cada seção deve começar com 1-3 frases explicando propósito e impacto, depois apresentar a sugestão padrão, aguardar a resposta do usuário e passar para a próxima seção.

A. Objetivo do Projeto

Se o objetivo do projeto não estiver claro, use ask-matt para selecionar o fluxo apropriado; quando for necessário entrevistar e documentar durante a conversa, use grill-with-docs. Após chegar a um consenso sobre o objetivo, pergunte se deseja escrever ou atualizar a seção de descrição do projeto no README.md.

B. Padrão de Orquestração da Thread Principal

Pergunte se deseja ativar o multi-agent-orchestrator. Explique que os benefícios são governança de contexto, validação independente e redução de auto-validação; o custo é que tarefas curtas podem aumentar o total de tokens. Após o usuário concordar, pergunte se deseja incluir a autorização de delegação em nível de projeto: permitir que a thread principal, respeitando as políticas de system/developer/tool, as regras do repositório e os requisitos de aprovação, crie ou use subagent / role agent de forma autônoma com uma thread Codex visível ao usuário. Após confirmação, escreva as regras de orquestração da thread principal e a autorização em AGENTS.md, preferencialmente usando o template do Skill já instalado.

C. Layout de Contexto

Permita que o usuário escolha:

• Single-context: um CONTEXT.md na raiz e docs/adr/. Padrão para a maioria dos repositórios.
• Multi-context: CONTEXT-MAP.md na raiz apontando para vários diretórios de contexto, adequado para monorepos ou repositórios com múltiplos produtos.

Ao precisar gravar arquivos específicos, leia references/project-files.md.

D. Base de Conhecimento do Projeto

Pergunte se deseja criar uma base de conhecimento do projeto voltada para humanos e IA. Sugestão padrão:

• docs/agents/anping-skills.md: Skills ativados neste projeto, seus propósitos e limites de chamada.
• docs/agents/project-knowledge.md: Regras para consolidação de conhecimento do projeto.
• docs/adr/README.md: Instruções de uso do ADR. Por padrão, os ADRs serão escritos em português, a menos que o usuárioPrefira explicitamente inglês ou bilíngue.

E. Integração de Skills Externos

Recomende Skills externos com base no tipo de projeto. Por padrão, não instale todos; recomende apenas as combinações que serão úteis para o projeto atual. Antes de instalar Skills de terceiros, explique a origem e o motivo, e solicite confirmação.

5. Apresentar Rascunho e Confirmar

Antes de gravar, mostre:

• A lista de arquivos que serão modificados ou criados.
• Um resumo das seções a serem adicionadas/atualizadas no AGENTS.md, incluindo se Delegation Authorization será incluída.
• A lista de Skills a serem registrados em docs/agents/anping-skills.md.
• O layout do CONTEXT.md ou CONTEXT-MAP.md.
• Se Skills externos serão instalados ou apenas recomendados.

Após a confirmação do usuário, execute as modificações nos arquivos.

6. Gravar Configuração do Projeto

Grave conforme a escolha do usuário:

• Seção de colaboração Anping/Codex no AGENTS.md ou no arquivo de regras de agente existente.
• docs/agents/anping-skills.md.
• docs/agents/project-knowledge.md.
• CONTEXT.md ou CONTEXT-MAP.md.
• docs/adr/README.md.
• Itens de segurança no .gitignore, como codex_sessions/, se o projeto for usar migração de sessão.

Se o projeto também usar setup-matt-pocock-skills, não duplique o bloco Agent skills com o mesmo significado; atualize ou mescle as seções existentes.

7. Validar

Após gravar, faça uma validação leve antes de relatar a conclusão:

• Releia as seções principais modificadas para confirmar que o conteúdo está nos arquivos esperados.
• Verifique se não há blocos duplicados de Anping / Agent skills / Multi-Agent Orchestrator.
• Confirme se os arquivos que devem ser criados existem, como docs/agents/anping-skills.md, CONTEXT.md ou CONTEXT-MAP.md, docs/adr/README.md.
• Se arquivos YAML, TOML, JSON ou outras configurações parseáveis foram modificados, valide o formato usando um parser local.
• Se alguma escolha não foi executada, registre o motivo e o risco remanescente.

8. Concluir

Por fim, relate:

• Quais capacidades foram ativadas.
• Quais arquivos foram modificados.
• Quais Skills foram instalados e quais são apenas recomendados.
• Como o usuário pode, com uma frase, acionar essas capacidades no futuro.
• Riscos remanescentes, como Skills externos não instalados, credenciais GitHub indisponíveis ou objetivo do projeto ainda não claro.

Não faça commit, push ou upload público automaticamente, a menos que o usuário solicite explicitamente.