Communitygithub.com

AmanVarshney01/tcut

Atualiza um change do OpenSpec revisando seus artefatos de planejamento existentes e mantendo-os coerentes entre si. Use quando o usuário quiser revisar o plano de um change, incorporar novas decisões ou reconciliar seus artefatos após uma edição. Nunca edita código.

O que é tcut?

Esta skill permite revisar artefatos de planejamento de um change do OpenSpec, mantendo-os coerentes entre si. Ela suporta revisões específicas (como "o design agora usa X") ou revisões gerais de coerência, verificando contradições, lacunas e duplicações entre os artefatos existentes. A skill lista os changes disponíveis com seus metadados, lê o estado atual via `openspec status`, e propõe edições artefato por artefato — sempre confirmando com o usuário antes de aplicar qualquer alteração. Ela jamais edita código de implementação, cria novos artefatos (que seriam delegados a `/opsx:continue`), ou avança a fronteira de construção: seu foco exclusivo é revisar arquivos de planejamento já existentes. A skill funciona com qualquer esquema de workflow e usa exclusivamente os IDs e caminhos de artefatos relatados pelo OpenSpec, sem depender de nomes hardcoded.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AmanVarshney01/tcut/tree/HEAD/.claude/skills/openspec-update-change

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Revise os artefatos de planejamento existentes de um change e mantenha-os coerentes. Nunca edite código.

Seleção de store: Se o usuário nomear uma store (uma store é um repositório OpenSpec independente registrado nesta máquina) ou o trabalho estiver em uma, execute openspec store list --json para descobrir os IDs de store registrados e, em seguida, passe --store <id> nos comandos que leem ou escrevem specs e changes (new change, status, instructions, list, show, validate, archive, doctor, context). Outros comandos não aceitam a flag. Dicas impressas pelos comandos já trazem a flag; mantenha-a nos acompanhamentos. Sem uma store, os comandos atuam na raiz local openspec/ mais próxima.

Entrada: Opcionalmente, especifique um nome de change. Se omitido, verifique se pode ser inferido a partir do contexto da conversa. Se vago ou ambíguo, você DEVE perguntar pelos changes disponíveis.

Passos

  1. Se nenhum nome de change for fornecido, pergunte pela seleção

    Execute openspec list --json para obter os changes disponíveis ordenados pelo mais recentemente modificado. Em seguida, use a ferramenta AskUserQuestion para permitir que o usuário selecione qual change atualizar.

    Apresente os 3-4 changes mais recentemente modificados como opções, mostrando:

    • Nome do change
    • Schema (do campo schema se presente, senão "spec-driven")
    • Status (ex.: "0/5 tarefas", "completo", "sem tarefas")
    • Há quanto tempo foi modificado (do campo lastModified)

    Marque o change mais recentemente modificado como "(Recomendado)", já que é provavelmente o que o usuário deseja atualizar.

    IMPORTANTE: NÃO adivinhe ou selecione automaticamente um change. Sempre deixe o usuário escolher.

  2. Obtenha os artefatos do change

    openspec status --change "<nome>" --json
    

    Analise o JSON para entender o estado atual. A resposta inclui:

    • schemaName: O schema de workflow sendo usado (ex.: "spec-driven")
    • artifacts: Array de artefatos com seu status ("done", "ready", "blocked")
    • isComplete: Booleano indicando se todos os artefatos estão completos
    • planningHome, changeRoot, artifactPaths e actionContext: contexto de caminho e escopo. Use estes em vez de assumir caminhos locais do repositório.

    Os IDs e caminhos dos artefatos vêm do schema ativo — não os assuma e não crie ramificações com base em nomes de artefatos hardcoded. Schemas personalizados devem funcionar sem alterações.

    Os arquivos a editar são artifactPaths.<id>.existingOutputPaths — os arquivos concretos que existem em disco, já expandidos para artefatos glob (ex.: specs/**/*.md). NÃO escreva em resolvedOutputPath: para um artefato glob ele ainda é o padrão glob, não um arquivo real.

  3. Entenda a solicitação

    • Se o usuário pediu uma revisão específica ("o design agora usa X"), essa é a edição inicial.
    • Se ele apenas disse "atualizar" / "tornar isso coerente", trate como uma revisão de coerência: leia os artefatos existentes e verifique-os entre si em busca de contradições, lacunas e duplicações.
  4. Leia e reconcilie

    • Leia o(s) artefato(s) que a solicitação toca e os outros artefatos existentes do change.
    • Aplique a edição solicitada. Em seguida, verifique cada outro artefato existente em relação a ela — em QUALQUER direção: uma edição em um artefato posterior pode exigir a revisão de um anterior, e não apenas o contrário. A ordem de construção é uma ordem de leitura útil, não uma restrição sobre quais artefatos podem ser revisados.
    • Anote tudo que agora está inconsistente, ausente ou contraditório.
    • Revise apenas arquivos que já existem (existingOutputPaths). NÃO crie artefatos que ainda não existem e NÃO invente novos arquivos em um artefato glob — anote-os e aponte o usuário para /opsx:continue para criá-los.
    • Se o change já estiver coerente, diga isso e não faça edições.
  5. Confirme e aplique, um artefato de cada vez

    • Mostre cada revisão proposta e o motivo. Escreva apenas após a confirmação do usuário.
    • Se o usuário rejeitar uma revisão, não a escreva — deixe aquele artefato inalterado.
    • Quando uma reescrita substancial for necessária, obtenha primeiro as regras e o template daquele artefato:
      openspec instructions <artifact-id> --change "<nome>" --json
      
  6. Aponte para o próximo passo (orientação apenas — NUNCA aja sobre ele)

    • Artefatos ainda ausentes -> sugira /opsx:continue para criá-los.
    • Change já implementado (tarefas marcadas / já aplicado) -> o código pode não corresponder mais ao plano revisado; sugira /opsx:apply para levar a diferença ao código.
    • Tudo feito e implementado -> sugira /opsx:archive.

Saída

Após cada invocação, mostre:

  • Quais artefatos foram revisados (e quais revisões propostas foram rejeitadas)
  • Qualquer coisa adiada para /opsx:continue (artefatos ou arquivos ainda não criados)
  • Onde o change se encontra e o próximo comando recomendado

Guardrails

  • Apenas artefatos de planejamento — NUNCA edite código de implementação. Se o plano revisado implicar alterações de código, pare e aponte para /opsx:apply.
  • Use os IDs e caminhos de artefatos relatados por openspec status; nunca crie ramificações com base em nomes de artefatos hardcoded.
  • Edite apenas os arquivos concretos em existingOutputPaths; nunca escreva em um resolvedOutputPath glob.
  • Não avance a fronteira de construção: nenhum novo artefato, nenhum novo arquivo em artefatos glob — essa é a função de /opsx:continue.
  • Confirme cada edição com o usuário antes de escrever.
  • Se a solicitação mudar a intenção do change em vez de refiná-la, recomende começar do zero com /opsx:new (a heurística "Atualizar vs. Começar do Zero").

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Habilidades Relacionadas