zion-prd-evolve
Ponto de entrada único do dia 2 do harness Zion Build PRD — endereça mudanças pós-release (RF novo, RF alterado/removido, decisão revertida) versionando a PRD (§13 changelog), roteando supersessão de ADR e re-decomposição parcial, e parando nas pontes. Use quando um requisito muda depois da release 1, ou o usuário disser "mudou o escopo", "reverter uma decisão" ou "evoluir a PRD".
- License 许可
- MIT
- 最近更新
- 2026-07-29
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- zion-prd-evolve
- metadata
- { "author": "zion-build-prd" }
- description
- Ponto de entrada único do dia 2 do harness Zion Build PRD — endereça mudanças pós-release (RF novo, RF alterado/removido, decisão revertida) versionando a PRD (§13 changelog), roteando supersessão de ADR e re-decomposição parcial, e parando nas pontes. Use quando um requisito muda depois da release 1, ou o usuário disser "mudou o escopo", "reverter uma decisão" ou "evoluir a PRD".
- argument-hint
- A mudança pós-release em linguagem natural (ex.: "exportar PNG saiu; entrou exportar SVG")
- user-invocable
- true
- disable-model-invocation
- false
02 资源文件 4
- 脚本references/check-adr.sh6.8 KB
- 脚本references/check-prd.sh8.2 KB
- 参考文档references/process-context.md2.6 KB
- 参考文档references/quality-rules.md14.0 KB
03 SKILL.md 正文
zion-prd-evolve — o dia 2 do harness (mudança pós-release)
Ponto de entrada único para mudar um artefato depois da release 1: um RF novo, um RF alterado ou
removido, ou uma decisão estruturante revertida. Versiona a PRD (changelog na §13), roteia para os
comandos donos de cada artefato parando em cada gate, e termina nas pontes — o ciclo /speckit.*
é do usuário. Sequência e fronteira em references/process-context.md; regras do dia 2 em
references/quality-rules.md #dia-2. Contrato de 5 fases; gates aconselham, nunca bloqueiam.
Cenários canônicos (uma mudança pode combinar mais de um)
- C1 — RF novo: requisito que não existia. Toca §6 (RF no épico certo ou épico novo) + §13 + re-decomposição parcial do épico + tabela (§12 via trace).
- C2 — RF alterado ou removido: requisito muda de significado ou sai de escopo. Toca §6 + §13 +
specs do épico afetado + tabela; spec já com
spec.md→ contexto de re-specify montado pela ponte. - C3 — Decisão revertida: decisão estruturante caiu. Toca ADR novo que substitui o antigo
(referência cruzada simétrica) + §8 (restrições) + §13 + aviso de revisar a
constitution+ a narrativa da §1 quando a decisão caída a sustentava (o bloco de avisos acusa).
Fase 0 — Pré-requisito (aconselha)
docs/PRD.md deve existir — o dia 2 pressupõe o dia 1. Faltando → avise ("recomendo /zion-prd-write
antes") e pare graciosamente.
Fase 1 — Validar entrada e classificar
O argumento é a descrição da mudança em linguagem natural. Classifique-a em C1/C2/C3 (pode ser mais de um). Descrição vaga demais para classificar → pergunte em vez de adivinhar (ex.: "essa mudança cria um requisito novo, altera um existente, ou derruba uma decisão de arquitetura?"). Cuidado com a decisão que cai disfarçada de requisito (parece C2, é C3): se a mudança só se resolve trocando uma decisão estruturante já registrada num ADR, é C3. Confirme a classificação com o usuário antes de tocar qualquer arquivo.
Fase 2/3 — Plano de toque + execução roteada
Monte e mostre o plano de toque: a lista ordenada dos artefatos afetados e o comando dono de cada um. Execute inline só o que é barato e local; para o resto, pare e delegue com handoff explícito, um gate por vez — não encadeie tudo num turno só.
Inline (você mesmo):
- §13 (changelog) — acrescente uma linha na tabela da §13 da PRD, no formato de
#dia-2:Data,Cenário(só C1/C2/C3),Mudança,Motivo,Artefatos afetados. O evolve é o dono da escrita do changelog. - Edição pontual da §6/§8 — o RF novo/alterado na §6 (no épico certo) ou a restrição na §8.
Delegado (pare em cada gate):
- Supersessão de decisão (C3) →
/zion-adr-new "<título>" --substitui ADR-<n>: cria o ADR novo comSubstitui: ADR-<n>e marca o antigoStatus: Substituído por ADR-<m>(referência simétrica). - Re-fatiamento do épico afetado (C1/C2) →
/zion-prd-decompose --epico E<k>: re-fatia apenas o épico indicado; specs já implementadas são intocáveis. - Narrativa estrutural defasada (C1/C2/C3) →
/zion-prd-decompose --narrativa: quando a mudança cria/derruba componente ou contrato de topo, ou quando o blocozion:narrativa-avisosdodocs/architecture.mdacusanarrativa-superseded/narrativa-defasada. Revisa só a §1–§2, sem re-fatiar nada, e nunca sobrescreve a prosa do Autor sem confirmação (ADR-018). - Reconciliação da tabela (§12) →
/zion-prd-trace: dono único da tabela. - Spec já especificada (C2) →
/zion-prd-specify-promptem enquadramento re-specify: revê a spec existente contra a mudança, com a linha da §13 como contexto. - ADR substituído alimentava a
constitution(C3) → aconselhe rodar/zion-prd-constitution-promptde novo (não edita aconstitution).
Fase 4 — Validar saída (aconselha)
Rode os verificadores do references/ e ecoe o veredito por item — não reverta:
bash references/check-prd.sh prd docs/PRD.md
bash references/check-adr.sh docs/adr
check-prd.sh confere a §13 (todo RF-xx/ADR-xxx citado existe, ou a linha o declara "removido";
Cenário só C1/C2/C3) e a §8 (restrição apontando ADR substituído → restricao-morta). check-adr.sh
confere a simetria da supersessão. Scripts ausentes (instalação parcial) → degrade para conferência
em prosa contra #dia-2, com aviso — como as demais skills.
Saída
A PRD versionada (§13), os artefatos afetados atualizados pelos comandos donos e — quando a mudança toca
uma spec já especificada — o prompt de re-specify pronto para o usuário disparar. PARE nas pontes: o
ciclo /speckit.* é do usuário.
04 同仓库更多 Skills
zion-speckit-install
Instala a integração do harness Zion Build PRD com o Spec Kit no repositório do PRODUTO — grava o bloco versionado de regras de fonte canônica no CLAUDE.md, semeia docs/architecture.md de esqueleto e oferece um guard de pre-commit opt-in. Idempotente e re-rodável, substitui só o bloco marcado e nunca sobrescreve documento existente. Use para "instalar a integração com o Spec Kit", "declarar o canon no repo do produto" ou para atualizar o bloco de regras após upgrade do harness.
zion-prd-write
Estágio 3 do harness Zion Build PRD — copia o esqueleto da PRD e conduz o preenchimento seção a seção (RF-xx por épico, NFRs com número, restrições das ADRs), guardando a fronteira o-quê/como. Use para "escrever a PRD", "preencher a PRD" ou revisar uma PRD existente, depois da descoberta e dos spikes.
zion-prd-trace
Reconcilia a rastreabilidade da PRD (§12), o backlog de specs (docs/backlog.md) e os blocos derivados do docs/architecture.md do produto (índice de ADRs, visão do backlog) a partir das specs/*/spec.md — RF↔spec, spec↔pasta e status ☐/◐/● derivados por máquina, com o veredito advisório do check de arquitetura ecoado. É o ritual de fim de spec. Use para "atualizar a rastreabilidade", "reconciliar a tabela/o backlog" ou depois de fatiar/implementar uma spec. Rodável a qualquer momento.
zion-prd-spike
Estágio 2 do harness Zion Build PRD — pesquisa os trade-offs das 2–3 decisões estruturantes e registra ADRs em docs/adr/ antes de fechar a PRD. Use após a descoberta, sempre que houver decisões que mudam a PRD inteira a provar com spike, ou quando o usuário mencionar "decisões estruturantes", "trade-offs" ou "ADRs".
zion-prd-specify-prompt
Ponte do harness Zion Build PRD para o Spec Kit — monta o prompt do /speckit.specify de UMA spec vertical, blindando a fronteira sem-stack, entrega pronto e para. Use para levar uma spec do backlog ao Spec Kit; não dispara o /speckit.* por você.
zion-prd-plan-prompt
Ponte do harness Zion Build PRD para o Spec Kit — monta o prompt do /speckit.plan de UMA feature injetando os ADRs confirmados — e, quando existe, a prosa estrutural do docs/architecture.md do produto — como restrição a honrar, entrega pronto e para. Use para levar uma feature (spec.md + ADRs) ao passo plan do Spec Kit; não dispara o /speckit.* por você.