Entrada do Usuário
$ARGUMENTS
Você DEVE considerar a entrada do usuário antes de prosseguir (se não estiver vazia).
Verificações de Pré-Execução
Verificar hooks de extensão (antes da conversão de tarefas para issues):
- Verifique se o arquivo
.specify/extensions.ymlexiste na raiz do projeto. - Se existir, leia-o e procure por entradas sob a chave
hooks.before_taskstoissues. - Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali; depois continue normalmente. - Filtre os hooks onde
enabledestá explicitamente comofalse. Trate hooks sem o campoenabledcomo habilitados por padrão. - Para cada hook restante, não tente interpretar ou avaliar expressões de
conditiondo hook:- Se o hook não tiver campo
condition, ou ele for nulo/vazio, trate o hook como executável. - Se o hook definir uma
conditionnão vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o hook não tiver campo
- Ao construir invocações de comando a partir de nomes de comando de hook, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook executável, gere a seguinte saída com base em sua flag
optional:- Hook opcional (
optional: true):## Extension Hooks **Pre-Hook Opcional**: {extension} Command: `/{command}` Description: {description} Prompt: {prompt} To execute: `/{command}` - Hook obrigatório (
optional: false):
Após emitir o bloco acima, você DEVE de fato invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você executaria o comando neste agente/sessão (a invocação pode diferir do## Extension Hooks **Pre-Hook Automático**: {extension} Executing: `/{command}` EXECUTE_COMMAND: {command} Wait for the result of the hook command before proceeding to the Outline.{command}literal mostrado acima; por exemplo, um agente em modo skills executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o hook.
- Hook opcional (
- Se nenhum hook estiver registrado ou
.specify/extensions.ymlnão existir, pule silenciosamente.
Outline
- Execute
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasksa partir da raiz do repositório e analise a lista FEATURE_DIR e AVAILABLE_DOCS. Todos os caminhos devem ser absolutos. Para aspas simples em argumentos como "I'm Groot", use a sintaxe de escape: por exemplo 'I'''m Groot' (ou use aspas duplas se possível: "I'm Groot"). - SE EXISTIR: Carregue
.specify/memory/constitution.mdpara princípios do projeto e restrições de governança. - A partir do script executado, extraia o caminho para as tarefas.
- Obtenha o remote Git executando:
git config --get remote.origin.url
[!CAUTION] PROSSIGA PARA OS PRÓXIMOS PASSOS SOMENTE SE O REMOTE FOR UMA URL DO GITHUB
- Buscar issues existentes para deduplicação: Antes de criar qualquer coisa, construa o conjunto de IDs de tarefas que você está prestes a processar a partir de
tasks.md(cada uma é umTseguido por pelo menos três dígitos, por exemploT001—/speckit-convergeatribui novos IDs comT{M+1:03d}, que é um piso e não um teto; portanto, quando um arquivo tem mais de 999 tarefas, os IDs têm quatro ou mais dígitos). Em seguida, use a ferramentalist_issuesdo servidor MCP do GitHub para procurar issues que já cobrem esses IDs. Não passe um valorstate, pois omiti-lo faz com que a ferramenta retorne issues abertas e fechadas. SoliciteperPage: 100para manter o número de chamadas baixo e, como a ferramenta usa paginação baseada em cursor, solicite páginas com o parâmetroafter(usando oendCursorda resposta anterior). Para cada título de issue, compare-o com o padrão de ID de tarefa\bT\d{3,}\b(o{3,}aceita IDs de quatro ou mais dígitos — com\d{3}um título contendoT1000não corresponderia, pois o\bfinal não pode ficar entre dois dígitos, então essa tarefa seria silenciosamente nem deduplicada nem criada; as bordas de palavra ainda impedem que um token comoST001corresponda, e forçam todo o grupo de dígitos a ser consumido, entãoT100nunca pode corresponder dentro deT1000; isso também reconhece títulos escritos comoT001 ...,T001: ...ou[T001] ...) e, quando corresponder a um de seus IDs de tarefa, marque esse ID como já tendo uma issue. Pare de paginar assim que cada ID de tarefa tiver sido correspondido, ou quando não houver mais páginas, para não continuar buscando todo o histórico de issues do repositório depois que todos os IDs de tarefa forem contabilizados. Isso limita o número de chamadas em repositórios com grandes históricos de issues e ainda previne duplicatas quando o comando é reexecutado apóstasks.mdser regenerado ou o skill ser reinvocado. - Para cada tarefa na lista, use o servidor MCP do GitHub para criar uma nova issue no repositório que represente o remote Git. As linhas de tarefa em
tasks.mdcomeçam com uma caixa de seleção markdown, então primeiro remova o- [ ]inicial (e quaisquer marcadores[P]/[US#]) para recuperar o ID da tarefa e sua descrição. Crie a issue com um título canônico único no formatoT001: <descrição>, com o ID escrito uma vez seguido pela descrição da tarefa (por exemplo, a linha- [ ] T001 Create project structurese torna o títuloT001: Create project structure).- Pule qualquer tarefa cujo ID já esteja presente no conjunto de issues existentes da etapa anterior e informe (por exemplo,
T001 already has an issue, skipping). - Crie issues apenas para tarefas que ainda não têm uma issue correspondente.
- Pule qualquer tarefa cujo ID já esteja presente no conjunto de issues existentes da etapa anterior e informe (por exemplo,
[!CAUTION] EM HIPÓTESE ALGUMA CRIE ISSUES EM REPOSITÓRIOS QUE NÃO CORRESPONDAM À URL DO REMOTE
Verificações de Pós-Execução
Verificar hooks de extensão (após a conversão de tarefas para issues):
Verifique se o arquivo .specify/extensions.yml existe na raiz do projeto.
- Se existir, leia-o e procure por entradas sob a chave
hooks.after_taskstoissues. - Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali; depois continue normalmente. - Filtre os hooks onde
enabledestá explicitamente comofalse. Trate hooks sem o campoenabledcomo habilitados por padrão. - Para cada hook restante, não tente interpretar ou avaliar expressões de
conditiondo hook:- Se o hook não tiver campo
condition, ou ele for nulo/vazio, trate o hook como executável. - Se o hook definir uma
conditionnão vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o hook não tiver campo
- Ao construir invocações de comando a partir de nomes de comando de hook, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook executável, gere a seguinte saída com base em sua flag
optional:- Hook opcional (
optional: true):## Extension Hooks **Hook Opcional**: {extension} Command: `/{command}` Description: {description} Prompt: {prompt} To execute: `/{command}` - Hook obrigatório (
optional: false):
Após emitir o bloco acima, você DEVE de fato invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você executaria o comando neste agente/sessão (a invocação pode diferir do## Extension Hooks **Hook Automático**: {extension} Executing: `/{command}` EXECUTE_COMMAND: {command}{command}literal mostrado acima; por exemplo, um agente em modo skills executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o hook.
- Hook opcional (
- Se nenhum hook estiver registrado ou
.specify/extensions.ymlnão existir, pule silenciosamente.