---
name: pca-docs
description: "gera e analisa documentos oficiais (.docx) do pca camocim (dfds, trs) usando scripts de manipulacao xml."
---

# Habilidade de Documentação PCA Camocim

## Visão Geral
Esta habilidade equipa o Claude com ferramentas avançadas para manipular arquivos `.docx`. No contexto do projeto PCA Camocim, ela é usada para transformar dados brutos de contratação em documentos oficiais formatados (DFDs, Estudos Técnicos, TRs).

## Dependências e Requisitos
Esta skill requer: `pandoc`, `python-docx`.

## Ferramentas Disponíveis
Esta habilidade depende estritamente dos scripts localizados na pasta `scripts/`.

1.  **Criar Documentos (DFD/TR):**
    Use para gerar novos documentos a partir de templates.
    ```python
    # Exemplo de chamada interna
    python scripts/document.py --create --template "templates/dfd_template.docx"
    ```

2.  **Análise de Conteúdo (Ler Uploads):**
    Use `pandoc` para extrair texto de documentos antigos (ex: TRs de anos anteriores) para reaproveitamento.
    ```bash
    pandoc -f docx -t markdown "documento_antigo.docx"
    ```

## Instruções de Uso

### 1. Gerar DFD (Documento de Formalização da Demanda)
Sempre que o usuário pedir para formalizar um item do PCA:
- Não use apenas texto puro.
- Gere um arquivo `.docx`.
- Utilize os scripts para garantir que a formatação siga o padrão da Prefeitura (tabelas com bordas, fontes oficiais).

### 2. Redlining (Revisão de Minutas)
Se o usuário enviar uma minuta de contrato para revisão:
- Utilize o script `scripts/ooxml/scripts/validation/redlining.py` (se disponível) ou a lógica de "Track Changes".
- O objetivo é marcar sugerir alterações jurídicas ou técnicas sem quebrar a formatação original.

## Exemplo de Uso (Few-Shot)

**Entrada:**
"O item 'Computador i7' foi cadastrado. Gere o DFD oficial para a Secretaria de Saúde assinar."

**Raciocínio (Chain of Thought):**
1. O usuário quer um artefato físico (`.docx`).
2. Identifico os dados: Item (Computador i7), Secretaria (Saúde).
3. Devo usar a ferramenta de criação de documentos para estruturar isso numa tabela oficial.

**Saída:**
"Vou gerar o Documento de Formalização da Demanda (DFD) para este item.

[Bloco de Código executando a criação do arquivo e disponibilizando o download]"

## Verificação de Dependências
Certifique-se de que a pasta `scripts/` contém os módulos `utilities.py` e `document.py` antes de executar tarefas complexas.