Communitygithub.com

SUGE2016/diaps-chataps

Desenvolva ou depure o ChatAPS (aplicação APS em chataps/): ponte DiAgent, ferramentas MCP, solvers CP-SAT, interface do quadro Kanban, persistência de execuções. Use ao editar chataps/, docs/csv, diagent_runtime ou comportamento de agendamento APS.

O que é diaps-chataps?

Este skill é um guia completo para desenvolvimento e depuração do ChatAPS, um sistema de planejamento e agendamento avançado (APS) construído como uma aplicação FastAPI que expõe uma interface de usuário (quadro Kanban) e uma API REST. Ele integra um agente DiAgent através de uma ponte SSE, exporta ferramentas MCP (Model Context Protocol) para interação com o agente e utiliza solvers CP-SAT para otimização de recursos e agendamento. O skill especifica a estrutura de diretórios, os arquivos de contrato entre agente e ferramentas, e fornece uma checklist para testes de integração, garantindo que o DiAgent reconheça corretamente as ferramentas MCP e que o agendamento respeite restrições de recursos (como máquinas serra). Também reforça princípios de desenvolvimento: minimalismo, documentação prévia de alterações e proteção de chaves secretas. É ideal para desenvolvedores que precisam modificar a lógica de negócio, adicionar novas ferramentas ou depurar o comportamento do sistema de agendamento.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/SUGE2016/diaps-chataps/tree/HEAD/.cursor/skills/chataps-dev

Perguntar na sua IA favorita

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

Documentação

Skill de Desenvolvimento ChatAPS

Leitura Obrigatória

  1. docs/AGENT_CONTRACT.md — Limites e contrato de ferramentas
  2. chataps/diagent_runtime/README.md — Como apontar para o DiAgent
  3. chataps/diagent_runtime/skills/chataps-aps/SKILL.md — Skill do Agente em Runtime (para o DiAgent, não para o Cursor)

Índice Rápido de Diretórios

CaminhoUso
chataps/server.pyUI FastAPI + /api/* + montagem MCP
chataps/mcp_aps.pyExportação de ferramentas MCP
chataps/tools.pySTATE + ferramentas de negócio
chataps/solver/heat_cpsat / schedule_cpsat
chataps/diagent_bridge.pySSE ↔ DiAgent
chataps/aps_context.pyInjeção de snapshot do Kanban no system
chataps/runs_store.pyPersistência de run / chat
chataps/static/Interface do Kanban + Agente de Agendamento
docs/csv/Dados mestres de teste
docs/demo-video/Materiais de vídeo de demonstração do produto; fluxo de geração no skill pessoal product-demo-video

Checklist de Integração

  1. ChatAPS python server.py → :8010
  2. DiAgent env apontando para diagent_runtime, :8100
  3. Log do DiAgent deve exibir o número de ferramentas MCP (incluindo ui_navigate)
  4. Após pedido urgente, a serra na mesma restrição de recurso deve ter gap≈0 (agendamento com restrição de recurso, não serial global)
  5. Após atualização, o diálogo e o Kanban devem ser restauráveis

Princípios de Alteração

  • Minimização; primeiro proposta, depois código.
  • Nova ferramenta: alterar simultaneamente tools.py, mcp_aps.py, runtime SKILL.md e tabela de contrato.
  • Não incluir valores reais de chaves secretas em exemplos da documentação.

Habilidades Relacionadas