AgentSkillsCN

dossier-structure

规范数字报账的文件夹结构。

SKILL.md
--- frontmatter
name: dossier-structure
description: Padronização da estrutura de pastas para prestação de contas digital.

Dossier Structure Skill

Esta skill define o padrão de organização de arquivos para compor o Dossiê Digital de Prestação de Contas.

Objetivo

Padronizar a estrutura de arquivos para facilitar a auditoria e a automação do empacotamento (Transferegov).

Inputs

  • Metadados do Projeto
  • Lista de Documentos (Document[])
  • Transações Financeiras

Outputs

  • Estrutura de diretórios organizada no File System ou MinIO.

Estrutura Padrão

O dossiê deve seguir a seguinte hierarquia:

text
/ROOT
  ├── 01_Termo_Ajuste/
  │   ├── Termo_Aditivo_01.pdf
  │   └── Plano_Trabalho_Aprovado.pdf
  ├── 02_Relatorios/
  │   ├── Relatorio_Execucao_Fisica.pdf
  │   └── Relatorio_Execucao_Financeira.pdf
  ├── 03_Fiscal/
  │   ├── <ANO_MES>/
  │   │   ├── NF_<NUMERO>_<FORNECEDOR>.pdf
  │   │   └── CND_<TIPO>_<FORNECEDOR>.pdf
  ├── 04_Financeiro/
  │   ├── Extratos_Bancarios/
  │   │   └── Extrato_<ANO_MES>_<CONTA>.pdf
  │   ├── Comprovantes_Pagamento/
  │   │   └── Comp_<DATA>_<VALOR>.pdf
  │   └── Conciliacao/
  ├── 05_Producao_Tecnica/ (opcional)
  │   ├── Fotos/
  │   └── Listas_Presenca/
  └── 99_Outros/

Naming Convention

  • Arquivos: DATA_TIPO_IDENTIFICADOR.ext
    • Ex: 2024-01-15_NF_1234_DellComputadores.pdf
  • Evitar: Espaços, caracteres especiais, nomes genéricos ("digitalização.pdf").

Definition of Done (DoD)

  • Estrutura de pastas criada conforme checklist.
  • Todos os arquivos renomeados conforme padrão.
  • Arquivos vazios ou corrompidos identificados e removidos.
  • Índice remissivo gerado (mapeando arquivo -> pasta).

Anti-patterns

  • ❌ Estrutura "Flat" (todos os arquivos na raiz).
  • ❌ Nomes de arquivo não descritivos.
  • ❌ Misturar documentos de projetos diferentes.