CommunityPesquisa e Análise de Dadosgithub.com

Lucian1u/material-to-deliverable

Transforme materiais dispersos em ativos de conhecimento reutilizáveis. Organize documentos reais em relatórios, resumos e índices de fontes prontos para entrega.

O que é material-to-deliverable?

Esta skill é projetada para ajudar desenvolvedores e profissionais a converter materiais brutos em artefatos de conhecimento bem estruturados e rastreáveis. Ela funciona assumindo um diretório de projeto local com uma pasta `00_input/` contendo documentos reais (como notas, relatórios ou dados) e orienta o usuário na definição do tipo de entrega (ex.: relatório, proposta, revisão). A skill então executa um fluxo de trabalho rigoroso em oito etapas que vai desde a inicialização do projeto e verificação de informações sensíveis até a criação de um índice de fontes, rascunho de esboço, geração da entrega final e auditoria de qualidade. Cada fato na saída é vinculado à sua fonte original, e a skill para se os dados forem insuficientes ou se a confirmação do usuário para informações sensíveis estiver pendente. Suportada pelas plataformas de agente AI como Claude Code, Cursor e Codex, ela se baseia em scripts Python (ex.: `init_project.py`, `validate_project.py`) e arquivos de referência Markdown para impor regras de evidência, resumo e tipos de entrega, garantindo que o resultado final esteja livre de material inventado ou suposições não autorizadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Lucian1u/material-to-deliverable

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

Material para Entrega

Transforme materiais reais da pasta 00_input/ em documentos de texto verificáveis, rastreáveis e prontos para entrega.

Condições de Início

Execute somente quando todas as condições a seguir forem atendidas.

  • O usuário fornece ou especifica um diretório de projeto local.
  • 00_input/ contém pelo menos um material real.
  • O usuário deseja um dos seguintes: relatório, proposta, revisão retrospectiva, pesquisa ou apresentação de curso.

Se o diretório não estiver claro, pergunte apenas pelo diretório do projeto. Se o tipo de entrega não estiver claro, pergunte apenas pelo tipo de entrega. Se não houver material real, pare e não gere exemplos ou materiais substitutos.

Leitura Obrigatória Antes de Cada Execução

Antes de iniciar o processamento, leia completamente:

Após confirmar o tipo de entrega, leia a seção correspondente em Regras de Tipos de Entrega.

Fluxo de Trabalho

1. Confirmar Projeto e Inicializar

Se o projeto ainda não foi inicializado, execute o script a partir do diretório de instalação desta Skill, passando o caminho absoluto do projeto:

python3 <skill-directory>/scripts/init_project.py /caminho/absoluto/para/o/projeto

Não presuma que o diretório atual do usuário contém uma pasta scripts/. Primeiro, resolva <skill-directory> com base na localização deste arquivo e depois execute o script.

Se 01_working/ já existir, leia o estado existente e continue. Não reinicialize ou sobrescreva arquivos.

2. Verificar Entrada e Informações Sensíveis

Liste todos os arquivos em 00_input/. Registre quaisquer arquivos que não possam ser lidos ou cuja origem seja desconhecida. Não modifique, mova ou renomeie materiais originais.

Primeiro, realize a verificação de informações sensíveis. Se encontrar nomes, informações de contato pessoais, contas, dados de clientes, contratos, registros financeiros, de saúde, educacionais, credenciais, caminhos internos ou outras informações potencialmente restritas:

  1. Registre apenas o tipo de risco e a localização do arquivo em 02_material-index.md. Não copie valores sensíveis.
  2. Pause imediatamente.
  3. Solicite ao usuário que confirme se tem autorização para processar esses materiais ou que forneça uma cópia anonimizada.

Sem a confirmação do usuário, não prossiga com esboço, escrita ou entrega.

3. Esclarecer a Tarefa

Faça no máximo sete perguntas, uma de cada vez, cada uma alterando o produto final. Priorize: destinatário, cenário de uso, decisão a ser tomada, prazo, tipo de entrega, conteúdo obrigatório e conteúdo proibido.

Se o usuário responder "não sei", registre como item pendente. Não forneça respostas no lugar do usuário. Grave os resultados em 01_task-brief.md, exiba um resumo e aguarde a confirmação do usuário.

4. Estabelecer Índice de Materiais e Lacunas

Preencha 02_material-index.md para cada material, distinguindo:

  • Fatos diretamente sustentáveis ​​pela fonte
  • Declarações da pessoa ou organização envolvida
  • Entrevistas, feedback ou observações parciais
  • Julgamento pessoal do usuário
  • Informações a confirmar

Registre conflitos, ausências, arquivos ilegíveis, necessidade de anonimização e evidência insuficiente em 03_gaps-and-conflicts.md. Não generalize conclusões com base em material escasso.

Se lacunas impeditivas persistirem, continue perguntando ou pare. Não gere o produto principal.

5. Criar Esboço com Fontes

Crie 04_source-backed-outline.md com base no tipo de entrega. Cada seção deve especificar: a pergunta a ser respondida, os materiais usados, as conclusões permitidas, o julgamento do usuário, os itens pendentes e o método de validação.

Exiba um resumo do esboço e a cobertura de fontes. Aguarde a confirmação do usuário. Não escreva o produto principal antes da confirmação.

6. Gerar Produto Principal e Índice de Fontes

Com base no esboço confirmado, gere:

  • 05_main-deliverable.md
  • 06_one-page-summary.md
  • 07_source-index.md

Cada fato chave deve ser vinculado a um arquivo e localização específicos no índice de fontes. Não invente números, pessoas, casos, citações ou resultados que não estejam nos materiais. Julgamentos pessoais devem ser separados dos fatos das fontes.

7. Revisar com Base nos Materiais Originais

Releia 00_input/. Não se baseie apenas no produto recém-gerado para auto-verificação. Registre problemas de fato, escopo, lógica, privacidade, consistência com a tarefa e expressão em 08_audit-report.md.

Corrija apenas problemas que possam ser resolvidos de forma clara com os materiais existentes. Mantenha como pendente qualquer item que exija julgamento do usuário.

8. Organizar Pacote de Entrega

Somente se não houver problemas impeditivos na auditoria, escreva o conteúdo aprovado em:

02_delivery/
  main-deliverable.md
  one-page-summary.md
  source-index.md
  readme.md

02_delivery/ não deve conter materiais originais, prompts, logs de chat, rascunhos internos ou valores sensíveis. Por fim, execute a partir do diretório de instalação desta Skill:

python3 <skill-directory>/scripts/validate_project.py /caminho/absoluto/para/o/projeto --stage delivery

Após o script de validação ser aprovado, ainda assim lembre o usuário de fazer a liberação manual final. O script verifica apenas a estrutura de arquivos e resíduos óbvios, não pode comprovar a correção factual.

Condições de Parada

Pare e explique o que está faltando em qualquer um dos seguintes casos:

  • 00_input/ está vazio ou os materiais não podem ser lidos.
  • O usuário não confirmou que os materiais sensíveis podem ser processados.
  • O destinatário, tipo de entrega ou objetivo principal ainda não está claro.
  • Os materiais atuais não suportam a conclusão principal.
  • O usuário ainda não confirmou o resumo da tarefa ou o esboço.

Não contorne as condições de parada com materiais fictícios, pesquisa na internet ou inferência de senso comum, a menos que o usuário autorize explicitamente uma nova fonte de dados.

Idioma de Saída

Por padrão, siga o idioma atualmente usado pelo usuário. Mantenha os nomes de arquivos em inglês para facilitar o uso entre ambientes; o conteúdo dos arquivos deve estar no idioma do usuário.

Habilidades Relacionadas