Dutify

npx add-mcp 'https://mcp.dutify.ai'

Esta distribuição agora cobre Hub, PM, Wiki e Roadmarq. Instalações existentes mantêm o nome da skill dutify-api; instalações somente Hub podem manter dutify-hub-api. Chaves pessoais du_live_ funcionam em todos os produtos concedidos; chaves antigas de workspace mantêm os limites de produto. Consulte roteamento e compatibilidade de conectores. A rota MCP combinada é adotada somente após sua liberação separada e verificação da lista de ferramentas.

dutify-api — Skill para Claude Code

A versão 2026.09.25.2 adiciona orientação com reconhecimento de capacidade para credenciais de workspace dw_live_. Leia chaves de integração antes de usar essa família; atualizar instruções não implanta a autoridade nem os consumidores. A autoridade disponibiliza a emissão imediatamente quando implantada.

Uma skill para Claude Code (e Claude.ai) que ensina um LLM a usar a API HTTP do Dutify diretamente: descobrir endpoints por meio do catálogo agregado em https://dutify.ai/mp/api/v1/api-catalog, chamar a tag "lite" correta com um X-API-Key e se autocorrigir em erros validOptions em vez de adivinhar formatos de endpoint pela memória.

Cobre Hub, Project Management, Wiki/Codexum e Roadmarq em uma única skill. O Hub usa seu catálogo em https://dutify.ai/api/v1/api-catalog; o catálogo Suite existente agrega PM, Wiki e Roadmarq.

Instalação

Nível de usuário (qualquer sessão do Claude Code, qualquer projeto)

git clone https://github.com/dutifyai/dutify-cloud-ai-skill.git ~/.claude/skills/dutify-api

Após a instalação, reinicie sua sessão do Claude Code (ou /clear). A skill será carregada automaticamente quando um prompt mencionar Dutify ("criar uma tarefa em…", "listar bugs atribuídos a…", "quais páginas wiki estão sob…", etc.) — não é necessário invocá-la explicitamente.

Nível de projeto (somente ao trabalhar dentro de um projeto)

git clone https://github.com/dutifyai/dutify-cloud-ai-skill.git <your-project>/.claude/skills/dutify-api

Verificação

Após a instalação:

ls ~/.claude/skills/dutify-api/SKILL.md          # should exist
ls ~/.claude/skills/dutify-api/references/       # product references

Em seguida, em qualquer sessão do Claude Code, pergunte "qual é a URL do endpoint do catálogo de tipos de tarefa do Dutify?" — o Claude deve captar a skill, carregar references/task-types.md e responder.

Como a skill está organizada

A skill é indexada por tópico, em vez de um único documento grande. SKILL.md é o arquivo de orientação que um LLM sempre vê; os arquivos de referência de produto em references/ são carregados sob demanda com base no mapa de tópicos.

Arquivo	Tópico
SKILL.md	Roteamento de todos os produtos e mapa de tópicos; as convenções do Suite permanecem em references/suite-guide.md
references/auth.md	Cabeçalho da chave de API, os 40+ escopos, workspace vinculado via /v1/api-keys/current
references/errors.md	Envelopes aninhados do PM vs. planos do FR/Wiki, vocabulário de códigos de erro, resposta de limite de taxa, erros de rede
references/tasks.md	/lite/context, pesquisa, criação, atualização, comentários, relacionamentos, anexos, recorrência, registros de tempo, Idempotency-Key, TaskCreationRequest não-lite, movimentação entre workspaces
references/task-types.md	Catálogo, as 9 linhas SYSTEM, padrão de cascata (3 níveis — lista→pasta→espaço, sem fallback de workspace), alterações de tipo únicas e em massa, definidores de padrão por nível, reatribuição ao excluir
references/wiki.md	Listar/ler/escrever páginas Wiki, formatos de corpo Markdown vs. TipTap, sintaxe de consulta de pesquisa
references/roadmarq.md	Solicitações de recursos + bugs, prefixos de ID curto por quadro, verbos lite (/votes não /vote, /moderation não /moderate), regra de consulta ?workspaceIdentifier=
references/webhooks.md	Assinaturas, envelope de payload, X-Webhook-Signature-256, agendamento de novas tentativas, fluxo de tickets WebSocket, formato de leitura do log de atividades
references/custom-fields.md	CRUD de campos personalizados (lite), definição de valores em tarefas, configuração de fórmulas (JSON estruturado), configuração de rollup
references/views.md	Visualizações (Lite): criar/listar/obter/atualizar/clonar, visibilidade/ordem de colunas, filtros, comportamento de criação no MCP
references/dashboards-forms.md	/v1/dashboard/lite, administração de formulários (configuração + envios + exportação CSV), envio de formulário público
references/sprints.md	Grupos de sprint, ciclo de vida do sprint (iniciar/concluir/rolar), associação, burndown — não-lite
references/imports.md	Importação CSV: fluxo de pré-visualização → confirmação, upload de uma única vez, consulta de status do job
references/admin.md	Erros de cota do plano (402 QUOTA_EXCEEDED), CRUD de status / prioridade / nível por escopo, equipes, token de colaboração do whiteboard
references/members.md	Lista de membros do workspace / função / remoção, convites enviar / cancelar / aceitar / recusar
references/notifications.md	Listar + contar + marcar como lido, peculiaridade de paginação estilo página, campo data é um objeto JSON real (diferente do log de atividades)
references/filters.md	Filtros salvos por lista, por usuário, Long id numérico, sem endpoint "aplicar filtro salvo" na pesquisa lite

Autenticação

Chamadas de acesso a dados usam X-API-Key: du_live_… para produtos concedidos, dk_live_… para um workspace do Suite ou dh_live_… para um workspace do Hub. Crie chaves de workspace nas configurações do workspace e chaves pessoais nas configurações da conta. As chaves de workspace mantêm seu vínculo fixo; as chaves pessoais descobrem workspaces permitidos e selecionam um por chamada com X-Dutify-Workspace. Consulte autenticação e chaves pessoais para escopos e códigos de negação.

Por que uma skill indexada por tópico em vez de um documento longo

As skills carregam completamente sempre que são acionadas — um único documento de 1500 linhas consumiria esse contexto por tarefa. Dividir a orientação em SKILL.md e detalhes por tópico significa que uma tarefa somente wiki carrega apenas wiki.md; uma configuração de webhook carrega webhooks.md + auth.md; nada mais. O ponto de entrada é conciso; cada referência tem em média ~95 linhas.

Avaliação

evals/evals.json contém 5 prompts que exercitam a skill de ponta a ponta:

• create-task-python — script Python de qualidade de produção que cria uma tarefa por nome
• list-wiki-pages-curl — curl + um arquivo de notas
• update-fr-status — uma solicitação HTTP única para alterar o status de uma solicitação de recurso
• bulk-retype-tasks — Python que encontra todas as tarefas em uma lista, consulta os identificadores de tipo de tarefa do workspace e altera em massa o tipo delas via endpoint /v1/tasks/bulk/change-type
• find-untyped-tasks — curl + notas explicando a cadeia de padrão de cascata e como taskType: null surge

Estes são destinados a harnesses de avaliação (por exemplo, o framework skills-eval da Anthropic) que pontuam execuções with_skill vs. without_skill em relação a listas de expectativas.

Contribuição

A fonte canônica desta skill vive em Dutify-suite/skills/dutify-api/ dentro do monorepo do suite Dutify; este espelho no GitHub é para distribuição. Edite na fonte e republicue; não abra PRs contra este repositório, a menos que esteja publicando uma correção já mesclada upstream.

Licença

Documentação interna do Dutify. O uso da API requer uma chave de API Dutify válida.

Manutenção da distribuição de compatibilidade do Hub

Referências canônicas do Hub vivem em references/hub. Verifique cópias com python scripts/sync_hub_references.py --hub-skill <hub-repo>; use --write para exportar arquivos de manifesto. A distribuição do Hub inclui referências completas e nunca requer a skill de todos os produtos em tempo de execução. Atualize ambas as distribuições e seus arquivos de versão juntos quando o comportamento compartilhado mudar.