Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

[Bug]: /speckit-converge is not idempotent — re-runs append duplicate remediation tasks

Aberta
  • Algo errado?
#4,269 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@ntdatt812 já está trabalhando nisso.

Desde 11/9/2026.

  • #4330 de @ntdatt812 — fechado sem integrar
  • #4520 de @ntdatt812 — aberto

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
48/100
Tipo de issue
Bug
Clareza
Razoavelmente clara
Status de atividade
Ativa
Domínio
developer-experience, tooling

Direção de pesquisa

Comece lendo .claude/skills/speckit-converge/SKILL.md e inspecione como ele lê tasks.md, lida com tarefas não marcadas e acrescenta tarefas de remediação. Compare esse fluxo com /speckit-implement e com o trabalho de detecção de duplicatas em #2968, depois reproduza converge duas vezes. Considera-se concluído quando o estado dos pré-requisitos é verificado ou recebe um aviso, o trabalho existente não marcado é reutilizado ou atualizado e somente novas lacunas recebem novos IDs.

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

Descrição

Version

spec-kit v1.0.1 (.claude/skills/speckit-converge/SKILL.md)

Description

/speckit-converge only checks that tasks.md exists before assessing the codebase and appending remediation tasks. It keeps no persisted evidence that /speckit-implement actually ran against the current task list, and it does not map its findings onto existing unchecked tasks before appending.

Two consequences:

  1. Invoked early (before implement has run, or after a partial implementation), it appends remediation tasks for work that is already represented by existing unchecked tasks — now under new IDs, splitting traceability for the same work across two task entries.
  2. Invoked twice (e.g. converge → partial fix → converge again), gaps found both times are appended both times.

Expected behavior

  • Converge verifies prerequisite state (an implementation checkpoint, or at minimum warns loudly when tasks.md contains unchecked tasks that overlap its findings).
  • Before appending, each finding is compared against existing unchecked tasks; covered work is reused/updated rather than duplicated, and only genuinely new gaps get new IDs.

Context

Found while upgrading a template fleet from 0.5.0 to v1.0.1 and reviewing the newly vendored command. Related in spirit to the duplicate-detection work in #2968, but on the tasks.md side rather than GitHub issues.

Linguagem predominante
Python
Estrelas
140k
Forks
12.6k
Merge médio
2d 11h
PRs com merge (30d)
186

Preparar o ambiente

Abrir no Codespaces

Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.

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/spec-kit

Todas as issues de github/spec-kit

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

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