specsfy-update-spec

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Atualizar uma especificação existente

更新现有规格说明书（spec）

Modo de interação

交互模式

Modo de interação:

perguntas

. Antes de formular qualquer pergunta, leia e aplique o

Contrato de perguntas numeradas

.specsfy/Spec.md

Incorpore um pedido surgido depois da definição inicial sem esconder a mudança, duplicar a fonte normativa ou obrigar a pessoa a conhecer atos e gates.

交互模式：

提问式

。在提出任何问题之前，请阅读并应用

.specsfy/Spec.md

中的

编号提问协议

。

将初始定义后出现的需求变更纳入其中，不得隐瞒变更、重复规范源内容或要求相关人员了解所有阶段和gates。

Orquestrar a conversa

对话编排

Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie

Pendência detectada: <descrição> — ação: resolvendo nesta etapa

e resolva-a quando pertencer ao próprio escopo. Quando houver troca de responsabilidade, anuncie

Transição automática: $specsfy-update-spec → $<destino> — motivo: <motivo> — resultado esperado: <resultado>

e carregue imediatamente a skill de destino, sem pedir confirmação nem repetir o comando. Continue na mesma conversa. Depois de uma correção necessária a esta etapa, anuncie

Retomada automática: $<destino> → $specsfy-update-spec — pendência resolvida: <resultado>

e retome-a imediatamente. Reavalie o estado após cada handoff para evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam exigindo autorização específica.

完成本步骤或检测到其他步骤的工作时，请通知

检测到待处理事项：<描述> — 操作：本步骤内解决

，并在属于自身范围时予以解决。当需要移交责任时，请通知

自动转换：$specsfy-update-spec → $<目标> — 原因：<原因> — 预期结果：<结果>

，并立即加载目标skill，无需请求确认或重复命令。继续当前对话。完成本步骤所需的修正后，请通知

自动重启：$<目标> → $specsfy-update-spec — 已解决待处理事项：<结果>

，并立即重启本步骤。每次移交后重新评估状态，避免循环。移交无需请求确认；敏感操作仍需特定授权。

Confirmar a entrada

确认输入

Preserve literalmente o novo pedido antes de interpretá-lo.
Localize a spec canônica em
```
specs/<estado>/<NNNN>-<slug>/spec.md
```
e leia seus metadados, requisitos, cenários, plano, tarefas, gates e evidências.
Leia as instruções do projeto,
```
PROJECT.md
```
,
```
.specsfy/STACK.md
```
,
```
.specsfy/RULES.md
```
,
```
.specsfy/DATABASE.md
```
e o research indexado aplicável.
Inspecione mudanças Git preexistentes na spec e não as atribua ao pedido atual.
Se não existir uma spec, anuncie a pendência e carregue
```
$specsfy-02-backlog
```
para uma ideia superficial ou
```
$specsfy-03-specify
```
quando já houver intenção explícita de criar a fatia.
Se a spec ainda estiver em
```
Draft
```
e nunca tiver obtido
```
Definition Gate: Passed
```
, carregue
```
$specsfy-03-specify
```
; esta skill governa somente a revisão de uma definição que já avançou.

在解读新需求之前，完整保留需求原文。
在
```
specs/<状态>/<NNNN>-<slug>/spec.md
```
中找到标准spec，并阅读其元数据、需求、场景、计划、任务、gates和证据。

阅读项目说明

PROJECT.md

、

.specsfy/STACK.md

、

.specsfy/RULES.md

、

.specsfy/DATABASE.md

以及适用的索引研究资料。

检查该spec已有的Git变更，不要将其归为当前需求变更。
如果spec不存在，请通知待处理事项，并根据需求成熟度加载
```
$specsfy-02-backlog
```
（适用于初步想法）或
```
$specsfy-03-specify
```
（适用于明确要创建该模块的情况）。
如果spec仍处于
```
Draft
```
状态且从未通过
```
Definition Gate: Passed
```
，请加载
```
$specsfy-03-specify
```
；本skill仅适用于已推进的定义的修订。

Classificar antes de escrever

编写前分类

Leia a matriz de classificação quando o pedido puder alterar comportamento, plano ou fronteira entre specs.

Para correção interna reversível sem efeito observável, não altere a spec: registre a avaliação na evidência da tarefa e retome
```
$specsfy-07-implement
```
.
Para esclarecimento editorial que não muda significado, preserve os gates e altere somente a redação necessária.
Para mudança de comportamento, aceite, escopo, dados, segurança ou interface, reabra desde o Ato I.
Para mudança somente de solução, tarefas ou estratégia de testes, reabra desde o Ato II.
Para capacidade independente da finalidade e dos atores da fatia atual, não a acrescente silenciosamente: carregue
```
$specsfy-02-backlog
```
ou
```
$specsfy-03-specify
```
conforme a maturidade do pedido.
Quando opções plausíveis mudarem materialmente o resultado, faça handoff para
```
$specsfy-02-backlog
```
, execute o ciclo adaptativo e retome esta skill ao final do ciclo. Se a pessoa escolher
```
avançar
```
, aplique a confirmação e o registro definidos no contrato central, reabra o Ato I quando restarem pontos aplicáveis, não encaminhe a definição como aprovada e não reabra o mesmo ciclo nesta retomada.

Esta skill não cria uma spec nova, não decide requisito material pela pessoa, não altera código de produção e não implementa o pedido.

当需求变更可能影响行为、计划或spec之间的边界时，请阅读变更分类矩阵。

对于可逆且无可见影响的内部修正，无需修改spec：在任务证据中记录评估结果，并重启
```
$specsfy-07-implement
```
。
对于不改变含义的编辑性澄清，保留gates，仅修改必要的措辞。
对于行为、验收标准、范围、数据、安全或界面的变更，从Ato I重新开始。
对于仅涉及解决方案、任务或测试策略的变更，从Ato II重新开始。
对于独立于当前模块目标和参与者的功能，不要悄悄添加：根据需求成熟度加载
```
$specsfy-02-backlog
```
或
```
$specsfy-03-specify
```
。
当合理选项会实质性改变结果时，移交至
```
$specsfy-02-backlog
```
，执行自适应循环，循环结束后重启本skill。如果用户选择
```
推进
```
，请应用中心协议中定义的确认和记录流程，当仍有适用要点时从Ato I重新开始，不要将定义视为已批准，且重启时不要重复同一循环。

本skill不创建新spec、不由用户决定实质性需求、不修改生产代码、不实施需求变更。

Incorporar a mudança

纳入变更

Confirme que a pessoa autorizou incorporar o pedido à spec atual. O pedido explícito para mudar, adicionar, remover ou corrigir já constitui essa autorização; não repita a confirmação.
Edite somente
```
spec.md
```
e o research indexado necessário. Não crie
```
change-request.md
```
,
```
plan.md
```
,
```
tasks.md
```
,
```
research.md
```
ou outra fonte paralela.
Atualize todas as seções normativas afetadas, preserve IDs e decisões ainda válidos e nunca renumere IDs existentes. Para mudança de comportamento, registre razão, decisão e IDs impactados na seção 17. Para mudança somente de plano, registre a razão na seção de plano ou risco afetada sem criar uma decisão de produto artificial.
Não reescreva evidência histórica como se tivesse sido produzida para a nova entrada. Marque como pendente toda prova posterior que dependa da versão invalidada.
Execute a projeção de impacto:

bash

node .agents/skills/specsfy-update-spec/scripts/analyze_change.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --base HEAD --mode impact

Use

--mode changelog

para listar IDs adicionados, removidos e alterados. A classificação usa títulos canônicos, não números de seção;

unknown

reabre do Ato I por segurança. O script é somente leitura e não substitui a comparação semântica com o pedido.

确认用户已授权将需求变更纳入当前spec。明确要求修改、添加、删除或修正的请求即视为授权；无需再次确认。
仅编辑
```
spec.md
```
和必要的索引研究资料。不要创建
```
change-request.md
```
、
```
plan.md
```
、
```
tasks.md
```
、
```
research.md
```
或其他并行源文件。
更新所有受影响的规范章节，保留仍有效的ID和决策，切勿重排现有ID。对于行为变更，在第17节记录原因、决策和受影响的ID。对于仅涉及计划的变更，在受影响的计划或风险章节记录原因，无需人为创建产品决策。
不要将历史证据改写为针对新输入的内容。将所有依赖失效版本的后续标记为待处理。
执行影响分析：

bash

node .agents/skills/specsfy-update-spec/scripts/analyze_change.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --base HEAD --mode impact

使用

--mode changelog

列出新增、删除和修改的ID。分类使用标准标题而非章节编号；

unknown

状态为安全起见从Ato I重新开始。该脚本仅为只读，不能替代与需求变更的语义对比。

Invalidar somente o necessário

仅使必要内容失效

Para mudança do Ato I, defina

Status: Draft

Definition Gate: Pending

Plan Gate: Pending

Delivery Gate: Pending

Para mudança somente do Ato II, defina

Status: Defined

, preserve

Definition Gate: Passed

e retorne

Plan Gate

Delivery Gate

para

Pending

Para esclarecimento editorial comprovadamente sem mudança semântica, preserve status e gates.
Nunca mantenha um gate posterior aprovado sobre uma entrada invalidada.
Preserve tarefas e evidências ainda válidas;
```
$specsfy-05-tasks
```
reconcilia itens afetados e suas dependências antes de novo RED.

Valide a estrutura intermediária:

bash

node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft

对于Ato I的变更，设置

Status: Draft

、

Definition Gate: Pending

、

Plan Gate: Pending

和

Delivery Gate: Pending

。

对于仅涉及Ato II的变更，设置
```
Status: Defined
```
，保留
```
Definition Gate: Passed
```
，并将
```
Plan Gate
```
和
```
Delivery Gate
```
重置为
```
Pending
```
。
对于已证实无语义变更的编辑性澄清，保留状态和gates。
切勿在失效输入之上保留已批准的后续gates。
保留仍有效的任务和证据；
```
$specsfy-05-tasks
```
会在新RED之前协调受影响的项目及其依赖关系。

验证中间结构：

bash

node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --allow-draft

Retomar o fluxo

重启流程

Mudança desde o Ato I: carregue
```
$specsfy-04-validate
```
; depois percorra tasks, TDD/BDD e a etapa que originou a mudança. Se o refinamento do backlog terminou por
```
avançar
```
, não faça esse handoff na mesma retomada: relate as lacunas e encerre com os gates pendentes.
Mudança somente do Ato II: carregue
```
$specsfy-05-tasks
```
, que reconcilia o plano, chama
```
$specsfy-06-tdd-bdd
```
e retoma a origem.
Mudança detectada durante implementação: retome
```
$specsfy-07-implement
```
somente depois de Definition e Plan Gate voltarem a
```
Passed
```
e existir RED válido para o comportamento novo ou alterado.
Mudança detectada depois de
```
Complete
```
: percorra novamente os atos invalidados e só restaure
```
Complete
```
com Delivery Gate e DoD comprovados.

从Ato I开始的变更：加载
```
$specsfy-04-validate
```
；之后依次执行任务、TDD/BDD以及引发变更的步骤。如果待办事项细化已通过
```
推进
```
完成，重启时无需进行此移交：报告缺口并以gates待处理状态结束。
仅涉及Ato II的变更：加载
```
$specsfy-05-tasks
```
，它会协调计划、调用
```
$specsfy-06-tdd-bdd
```
并重启源头步骤。
实施期间检测到的变更：仅当Definition和Plan Gate重新变为
```
Passed
```
且新行为或变更行为有有效的RED时，才重启
```
$specsfy-07-implement
```
。
```
Complete
```
状态后检测到的变更：重新执行所有失效的阶段，仅在Delivery Gate和DoD得到验证后恢复
```
Complete
```
状态。

Relatar

报告

Informe o pedido preservado, a spec alterada, a classificação, os IDs e seções afetados, os gates invalidados, as evidências preservadas ou tornadas pendentes e a próxima skill carregada. Não exponha complexidade do framework antes do resultado: diga primeiro que o pedido foi incorporado e que o fluxo necessário será retomado automaticamente.

告知用户保留的需求变更、修改后的spec、分类结果、受影响的ID和章节、失效的gates、保留或标记为待处理的证据，以及加载的下一个skill。在展示结果前不要暴露框架的复杂性：首先告知需求变更已纳入，必要流程将自动重启。