Claude member subagent description repeats itself when name equals role ("QA Engineer, QA Engineer.")

Aberta Para iniciantes
#2,528 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
84/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
github, node.js, typescript

Direção de pesquisa

Comece por renderClaudeMember em packages/squad-sdk/src/client/adapters/claude-members.ts e acompanhe como ele monta a descrição e o texto Owns: a partir do membro e da linha de roteamento. Confira os testes próximos sobre a renderização de membros Claude e depois verifique a saída para um nome igual à função e para tipos de trabalho roteados iguais à função. O trabalho estará concluído quando essas repetições forem omitidas e os nomes e tipos de trabalho distintos forem mantidos.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

bug

Version: CLI built from release/prepare-2.0.0-preview.5 @ 38d45d02 (package version 2.0.0-preview.6).

What happens

.claude/agents/<id>.md builds its description as "<name>, <role>.". Members named after their role, which is common with init --roles and plain-role teams, get a stuttering description:

D=$(mktemp -d); cd "$D"; git init -q
node <squad-cli>/dist/cli-entry.js init --roles --client copilot,claude
node <squad-cli>/dist/cli-entry.js cast --name "QA Engineer" --role "QA Engineer"
node <squad-cli>/dist/cli-entry.js cast --name Quinn --role "Security Engineer"
grep -h '^description' .claude/agents/qa-engineer.md .claude/agents/quinn.md
description: "QA Engineer, QA Engineer. Spawned by the Squad coordinator."
description: "Quinn, Security Engineer. Owns: Security Engineer. Spawned by the Squad coordinator."

The second line shows a related repetition. Right after a cast, the only routing.md row for a member has the role as its work type, so Owns: repeats the role too.

Claude Code chooses which subagent to delegate to from this text, so the repeated words carry no information. Claude Code's /agents list shows these strings verbatim.

Expected

  • When the name equals the role (case-insensitive, after trimming), use just "<role>.".
  • Drop Owns: work types that equal the role, and omit Owns: when nothing is left.

Source

  • packages/squad-sdk/src/client/adapters/claude-members.ts, renderClaudeMember, lines 148–152: summary = purpose ?? \${name}, ${role}.`andOwns: ${routed.join('; ')}`.

Related: #2456 (closed; vague descriptions written before routing exists). This is the remaining cosmetic part.

🤖 Generated with Claude Code

Linguagem predominante
TypeScript
Estrelas
3.4k
Forks
516
Merge médio
1d 15h
PRs com merge (30d)
116

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de github/squad

Todas as issues de github/squad

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.