Ponte de Tarefas Paperclip

Use esta habilidade quando uma solicitação originada pelo Hermes precisar criar ou atualizar trabalho no Paperclip diretamente. Esta é a direção Hermes-para-Paperclip, separada do Paperclip acordando o Hermes através do adaptador hermes_local ou hermes_gateway.

Ambiente Necessário

Configure isto nos segredos do ambiente/perfil do Hermes, não no texto do prompt:

• PAPERCLIP_API_URL - URL base do Paperclip, com ou sem /api.
• PAPERCLIP_BRIDGE_API_KEY - uma chave de API de agente do Paperclip criada com scope.kind = "task_bridge".

Opcional:

• PAPERCLIP_API_KEY - variável de ambiente de fallback para perfis mais antigos; ela ainda deve conter uma chave com escopo task_bridge, nunca uma chave de agente completa.
• PAPERCLIP_COMPANY_ID - pula uma consulta de identidade quando definida.
• PAPERCLIP_AGENT_ID - pula uma consulta de identidade quando definida.
• PAPERCLIP_RUN_ID - enviada como X-Paperclip-Run-Id em requisições mutáveis quando o Hermes está rodando dentro de um heartbeat do Paperclip.

Nunca imprima ou cole chaves de API. O helper lê credenciais de variáveis de ambiente e imprime apenas resumos de resposta. Não coloque uma chave de API de agente reivindicada normal em um runtime do Hermes exposto à internet; chaves normais podem usar rotas amplas do Paperclip da mesma empresa.

Criar uma Chave de Ponte

Crie a chave a partir de uma sessão de API do Paperclip autenticada por quadro e armazene o token retornado uma vez:

curl -X POST "$PAPERCLIP_API_URL/api/agents/$HERMES_AGENT_ID/keys" \
  -H "Authorization: Bearer $BOARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hermes task bridge",
    "scope": {
      "kind": "task_bridge",
      "parentIssueId": "00000000-0000-4000-8000-000000000000"
    }
  }'

Use parentIssueId ou parentIssueIds quando o Hermes deve apenas criar tarefas filhas sob trabalho aprovado. Use projectId ou projectIds quando o limite aprovado for um projeto. Uma chave de ponte pode criar tarefas apenas dentro desse limite, pode comentar/atualizar apenas issues criadas ou atribuídas pela ponte, e não pode usar superfícies de lista/busca/leitura de issues em toda a empresa.

Helper

Execute o helper a partir deste diretório de habilidade:

node ./paperclip-task.mjs --help

Comandos:

node ./paperclip-task.mjs list-assigned
node ./paperclip-task.mjs create-task --parent-id "00000000-0000-4000-8000-000000000000" --title "Investigate checkout failures" --description "Capture failing request and root cause."
node ./paperclip-task.mjs comment --issue PAP-123 --body "Found the failing request path."
node ./paperclip-task.mjs update-status --issue PAP-123 --status in_review --comment "Ready for review."

create-task define como padrão atribuir a tarefa ao agente autenticado do Hermes para que o trabalho seja imediatamente acionável. Use --unassigned para criar trabalho em backlog em vez disso. Use --assignee-agent-id <uuid> apenas quando a chave de API do Paperclip tiver permissão para atribuir trabalho a esse agente.

Para corpos de múltiplas linhas, prefira arquivos ou stdin:

node ./paperclip-task.mjs create-task --title "Write rollout note" --description-file ./task.md
node ./paperclip-task.mjs comment --issue PAP-123 --body-file -

Expectativas de Fluxo de Trabalho

• Mantenha as tarefas com escopo de empresa usando a empresa resolvida a partir da chave de agente com escopo.
• Deixe o registro de atividade do Paperclip vir dos endpoints normais da API; não escreva logs locais que incluam credenciais.
• Use comentários para progresso duradouro.
• Use update-status apenas quando a issue tiver uma disposição real: done, in_review, blocked, todo, in_progress, backlog, ou cancelled.
• Use list-assigned antes de criar trabalho duplicado quando o usuário perguntar sobre atribuições atuais do Paperclip.