specsfy-02-backlog

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Refinar e aprofundar o backlog

细化与深化待办项

Modo de interação

交互模式

Modo de interação:
perguntas
. Antes de formular qualquer pergunta, leia e aplique o
Contrato de perguntas numeradas
de
.specsfy/Spec.md
.
Transforme uma entrada vaga em um item de backlog compreensível e, quando a intenção exigir especificação, aprofunde as decisões até produzir um brief testável. Esta é a segunda etapa sequencial do framework. Ela reúne registro, refinamento e descoberta sem transformar o backlog em fonte normativa.
交互模式:
perguntas
(提问)。在提出任何问题之前,请阅读并应用
.specsfy/Spec.md
中的
编号提问协议
将模糊的输入转换为易于理解的待办项,当需求需要规格说明时,深入决策直至生成可测试的简报。这是框架中的第二个连续阶段,它整合了记录、细化和探索,不会将待办项转化为规范性来源。

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-02-backlog → $<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-02-backlog — pendência resolvida: <resultado>
e retome-a imediatamente. Reavalie o estado após cada handoff para evitar ciclos. O handoff não exige confirmação; ações sensíveis continuam exigindo autorização específica.
完成本阶段或检测到其他阶段的工作时,请宣布
Pendência detectada: <描述> — ação: resolvendo nesta etapa
(检测到待处理事项:<描述> — 操作:在本阶段解决),并在属于自身范围时予以解决。当需要移交责任时,请宣布
Transição automática: $specsfy-02-backlog → $<目标> — motivo: <原因> — resultado esperado: <预期结果>
(自动转换:$specsfy-02-backlog → $<目标> — 原因:<原因> — 预期结果:<预期结果>),并立即加载目标skill,无需请求确认或重复命令。继续当前对话。
在对本阶段进行必要修正后,请宣布
Retomada automática: $<目标> → $specsfy-02-backlog — pendência resolvida: <结果>
(自动恢复:$<目标> → $specsfy-02-backlog — 待处理事项已解决:<结果>),并立即恢复本阶段。每次移交后重新评估状态以避免循环。移交无需确认;敏感操作仍需特定授权。

Buscar duplicatas e referências

搜索重复项和参考内容

  1. Extraia termos derivados do pedido do usuário, incluindo nomes do domínio e equivalentes evidentes já usados na conversa.
  2. Antes de criar ou atualizar o item, pesquise esses termos em:
    • specs/inbox/*.md
      ;
    • specs/backlog/*.md
      ;
    • specs/<estado>/*/spec.md
      ;
    • docs/**/*.md
      .
  3. Leia somente resultados plausíveis e classifique cada relação:
    • possível duplicata: problema, pessoa, resultado e contexto substancialmente iguais;
    • backlog relacionado: item complementar, dependência ou precedente;
    • spec relacionada: comportamento definido ou entregue que limita o item;
    • documentação relacionada: vocabulário, regra ou contexto do projeto.
  4. Apresente correspondências materiais com seus caminhos. Diante de possível duplicata, confirme com o usuário se deve atualizar o item ou registrar uma diferença real.
  5. Registre fontes úteis em
    Referências relacionadas
    , com caminho relativo e tipo de relação. Não transforme uma decisão encontrada em declaração do usuário.
Se uma resposta mudar materialmente os termos, o problema, a pessoa, o resultado ou o contexto, repita a busca.
  1. 从用户请求中提取衍生术语,包括领域名称以及对话中已使用的明显等价术语。
  2. 在创建或更新项之前,在以下位置搜索这些术语:
    • specs/inbox/*.md
    • specs/backlog/*.md
    • specs/<estado>/*/spec.md
    • docs/**/*.md
  3. 仅阅读合理的结果,并对每个关系进行分类:
    • 可能重复项:问题、人物、结果和上下文基本相同;
    • 相关待办项:互补项、依赖项或前置项;
    • 相关规格说明:已定义或交付的、限制当前项的行为;
    • 相关文档:项目的词汇、规则或上下文。
  4. 展示重要匹配项及其路径。若存在可能的重复项,请与用户确认是更新现有项还是记录实际差异。
  5. Referências relacionadas
    (相关参考)中记录有用来源,包含相对路径和关系类型。请勿将找到的决策转化为用户声明。
如果回复实质性地改变了术语、问题、人物、结果或上下文,请重复搜索。

Garantir a captura mínima

确保最小捕获

  1. Preserve a formulação original recebida na conversa ou em
    specs/inbox/<data-hora>-<slug>.md
    . Separe declaração, inferência e aberto.
  2. Confirme se o contexto esclarece:
    • problema percebido;
    • pessoa afetada ou beneficiada;
    • resultado ou valor esperado;
    • contexto suficiente para distinguir a entrada de pedidos semelhantes.
  3. Se algo estiver ausente, vago, contraditório ou ambíguo, selecione três lacunas reais de maior impacto e monte uma rodada numerada.
  4. Reavalie as lacunas depois de cada resposta. Não transforme os itens em questionário fixo nem repita informação já fornecida.
  5. Não crie nem atualize o arquivo enquanto algum item essencial continuar ausente ou ambíguo. Se a pessoa não souber responder, explique a lacuna sem inventar conteúdo.
A captura mínima não exige solução técnica, critérios completos de aceitação ou prioridade. Esses dados podem amadurecer no aprofundamento.
  1. 保留对话中或
    specs/inbox/<日期-时间>-<slug>.md
    中收到的原始表述。区分声明、推断和未明确事项。
  2. 确认上下文是否明确:
    • 感知到的问题;
    • 受影响或受益的人员;
    • 预期结果或价值;
    • 足以区分当前输入与类似请求的上下文。
  3. 如果存在缺失、模糊、矛盾或歧义的内容,选择三个影响最大的实际空白,并生成一组编号问题。
  4. 每次回复后重新评估空白。不要将项转化为固定问卷,也不要重复已提供的信息。
  5. 在关键信息缺失或模糊时,请勿创建或更新文件。若用户无法回答,请说明空白之处,不要编造内容。
最小捕获不需要技术解决方案、完整的验收标准或优先级。这些数据可在深化阶段逐步完善。

Criar ou atualizar o item

创建或更新项

  1. Se a pessoa apenas quiser explorar sem registrar, converse e confirme antes de escrever.
  2. Se existir item correspondente, atualize-o sem mudar seu ID e preserve a formulação anterior.
  3. Se a origem for
    specs/inbox/
    , registre esse caminho em
    Referências relacionadas
    ; não altere nem apague a captura.
  4. Para criar um item novo, execute:
bash
node <diretório-da-skill>/scripts/iniciar_backlog.mjs \
  --title "<título curto>" \
  --idea "<formulação original>" \
  --problem "<problema percebido>" \
  --person "<pessoa afetada ou beneficiada>" \
  --result "<resultado ou valor esperado>" \
  --context "<contexto que distingue a ideia>" \
  [--slug <slug>] [--root <raiz>]
  1. Use o caminho absoluto impresso pelo script. Ele prefere
    .specsfy/templates/custom/Backlog.md
    e recorre a
    .specsfy/templates/Backlog.md
    .
  1. 如果用户仅想探索而无需记录,请先对话确认再进行撰写。
  2. 如果存在对应项,更新它但不修改其ID,并保留先前的表述。
  3. 如果来源是
    specs/inbox/
    ,请在
    Referências relacionadas
    (相关参考)中记录该路径;不要修改或删除原始捕获内容。
  4. 要创建新项,请执行:
bash
node <skill目录>/scripts/iniciar_backlog.mjs \
  --title "<简短标题>" \
  --idea "<原始表述>" \
  --problem "<感知到的问题>" \
  --person "<受影响或受益的人员>" \
  --result "<预期结果或价值>" \
  --context "<区分该想法的上下文>" \
  [--slug <slug>] [--root <根目录>]
  1. 使用脚本输出的绝对路径。脚本优先使用
    .specsfy/templates/custom/Backlog.md
    ,若不存在则使用
    .specsfy/templates/Backlog.md

Organizar e priorizar

组织与优先级排序

Leia
references/backlog-quality.md
ao estruturar, refinar, priorizar ou avaliar prontidão.
  • Classifique, quando conhecido, em Produto → Épico → Funcionalidade → item.
  • Use tipos como épico, história, regra, técnico e melhoria sem confundir tipo com prioridade.
  • Ordene por valor, risco, dependências, urgência, esforço, desbloqueios e incerteza; não marque tudo como prioridade alta.
  • Aprofunde campos conforme risco e complexidade. Autenticação, pagamentos, permissões, privacidade e operações assíncronas exigem mais cuidado.
  • Prefira comportamento observável a solução de interface.
  • Torne atributos de qualidade mensuráveis quando forem materiais.
  • Use listas, fluxos, cenários ou matrizes quando reduzirem ambiguidade.
在构建、细化、排序或评估就绪状态时,请阅读
references/backlog-quality.md
  • 若已知,请按产品 → 史诗 → 功能 → 项进行分类。
  • 使用史诗、用户故事、规则、技术项和改进等类型,但不要将类型与优先级混淆。
  • 按价值、风险、依赖关系、紧迫性、工作量、解锁因素和不确定性排序;不要将所有项标记为高优先级。
  • 根据风险和复杂度深入完善字段。认证、支付、权限、隐私和异步操作需要更多关注。
  • 优先考虑可观察的行为而非界面解决方案。
  • 当质量属性重要时,使其可衡量。
  • 当能减少歧义时,使用列表、流程、场景或矩阵。

Aprofundar para a especificação

深化以用于规格说明

Quando a pessoa pedir aprofundamento, promoção ou criação de uma spec:
  1. Leia a entrada de
    specs/inbox/
    , o item de
    specs/backlog/
    ou a spec indicada. Se houver mais de um candidato, pergunte qual aprofundar.
  2. Resuma em uma frase o problema, a pessoa e o resultado percebido.
  3. Separe o que está decidido do que pode mudar escopo, experiência, segurança, dados, testes ou arquitetura.
  4. Leia
    references/discovery-map.md
    para selecionar perguntas relevantes; não percorra o mapa mecanicamente.
  5. Leia
    ../specsfy-03-specify/references/mcr-10.md
    e faça a análise categorial silenciosamente antes da primeira pergunta.
  6. Leia
    references/specialists.md
    somente quando tecnologia ou disciplina exigir contexto adicional.
当用户要求深化、升级或创建规格说明时:
  1. 阅读
    specs/inbox/
    中的输入、
    specs/backlog/
    中的项或指定的规格说明。若存在多个候选项,请询问用户要深化哪一个。
  2. 用一句话总结感知到的问题、人员和结果。
  3. 区分已确定的内容与可能改变范围、体验、安全、数据、测试或架构的内容。
  4. 阅读
    references/discovery-map.md
    以选择相关问题;不要机械地遍历整个图谱。
  5. 阅读
    ../specsfy-03-specify/references/mcr-10.md
    ,并在提出第一个问题前先进行静默分类分析。
  6. 仅当技术或学科需要额外上下文时,才阅读
    references/specialists.md

Conduzir a descoberta adaptativa

引导适配性探索

Execute um ciclo sem limite máximo de rodadas:
  1. Antes de cada rodada, releia a entrada, as decisões confirmadas, o contexto acumulado e as novas respostas, além da evidência aplicável.
  2. Reclassifique lacunas e dependências. Continue enquanto existir lacuna aplicável; encerre quando cada uma estiver decidida, não aplicável ou resolvida por evidência.
  3. Selecione pelo menos três lacunas reais por
    impacto × incerteza
    , priorizando P1, P2 e P3, e apresente a rodada conforme o contrato central.
  4. Registre cada resposta original, a decisão normalizada e seus efeitos. Volte ao primeiro passo; não reutilize uma fila fixa.
Inclua
Avançar
em cada pergunta desde a primeira rodada. Se a pessoa escolher essa opção:
  • na rodada seguinte, confirme se ela encerra definitivamente as perguntas daquela área, responde depois ou volta a responder agora;
  • inclua a confirmação entre as três perguntas numeradas da rodada;
  • ao encerrar, registre
    Área encerrada pelo usuário: <área>
    e não pergunte novamente, salvo reabertura explícita;
  • ao adiar, registre
    Área adiada pelo usuário: <área>
    e preserve os pontos não respondidos para retomada;
  • não preencha respostas por inferência;
  • permita o handoff solicitado, mantendo
    Status: Draft
    e
    Definition Gate: Pending
    quando restarem lacunas aplicáveis.
Durante a conversa:
  • ofereça pelo menos três opções numeradas quando reduzirem o esforço e recomende uma com justificativa curta;
  • aceite respostas livres e use-as na reanálise;
  • preserve termos originais e diferencie declaração, inferência, hipótese, decisão, conflito e aberto;
  • confirme intenção operacional por síntese;
  • não recite as dez categorias nem transforme cada uma em pergunta.
Garanta cobertura suficiente de problema, atores, resultado, escopo, jornadas, falhas, limites, regras, dados, segurança, privacidade, desempenho, acessibilidade, restrições existentes e sinais objetivos de aceite e sucesso.
执行无最大轮次限制的循环:
  1. 每轮问题提出前,重新阅读输入内容、已确认的决策、累积的上下文和新回复,以及适用的证据。
  2. 重新分类空白和依赖关系。只要存在适用空白就继续;当每个空白都已确定、不适用或通过证据解决时结束。
  3. 选择至少三个基于
    影响 × 不确定性
    的实际空白,优先考虑P1、P2和P3,并根据核心协议展示该轮问题。
  4. 记录每个原始回复、标准化决策及其影响。回到第一步;不要使用固定的问题队列。
从第一轮问题开始,每个问题都包含
Avançar
(推进)选项。如果用户选择此选项:
  • 在下一轮中,确认用户是要彻底结束该领域的提问、稍后回复还是现在回复;
  • 将确认问题包含在该轮的三个编号问题中;
  • 结束时,请记录
    Área encerrada pelo usuário: <领域>
    (用户已结束领域:<领域>),除非用户明确重新开启,否则不再提问;
  • 延迟时,请记录
    Área adiada pelo usuário: <领域>
    (用户已延迟领域:<领域>),并保留未回答的问题以便后续恢复;
  • 不要通过推断填补回复;
  • 允许用户请求的移交,当仍存在适用空白时,保持
    Status: Draft
    (状态:草稿)和
    Definition Gate: Pending
    (定义闸门:待处理)。
对话过程中:
  • 当能减少工作量时,提供至少三个编号选项,并附上简短理由推荐其中一个;
  • 接受自由回复,并将其用于重新分析;
  • 保留原始术语,区分声明、推断、假设、决策、冲突和未明确事项;
  • 通过总结确认操作意图;
  • 不要罗列十个类别,也不要将每个类别转化为问题。
确保充分覆盖问题、参与者、结果、范围、流程、故障、限制、规则、数据、安全、隐私、性能、可访问性、现有约束以及验收和成功的客观指标。

Manter o item

维护项

Use exatamente
specs/backlog/<NNNN>-<slug>.md
e mantenha:
  • Status: Captured
    enquanto o item estiver apenas registrado;
  • Status: Refining
    durante refinamento ou descoberta;
  • Status: Ready for specification
    quando o brief estiver suficiente;
  • Status: Promoted
    depois que uma spec derivada existir.
Mantenha as metainformações na tabela abaixo do título. Não invente prioridade, prazo, stakeholder, solução ou evidência. Use
Pronto para desenvolvimento
como diagnóstico, nunca como autorização de implementação.
严格使用
specs/backlog/<NNNN>-<slug>.md
路径,并保持:
  • Status: Captured
    (状态:已捕获):当项仅已记录时;
  • Status: Refining
    (状态:细化中):在细化或探索期间;
  • Status: Ready for specification
    (状态:准备好规格说明):当简报足够充分时;
  • Status: Promoted
    (状态:已升级):当衍生的规格说明存在后。
在标题下方的表格中维护元信息。不要编造优先级、期限、利益相关者、解决方案或证据。将
Pronto para desenvolvimento
(准备好开发)用作诊断,而非实施授权。

Encerrar

结束

Apresente um
Brief pronto para especificar
com:
  1. Problema e objetivo.
  2. Atores.
  3. Escopo e fora de escopo.
  4. Jornadas e regras essenciais.
  5. Critérios de aceite em Given/When/Then.
  6. Restrições técnicas e de qualidade.
  7. Suposições.
  8. Decisões abertas ou
    Nenhuma lacuna aplicável
    .
  9. Vocabulário ambíguo e inferências confirmadas.
Atualize o item de backlog quando a pessoa autorizar esse registro. Quando o brief estiver suficiente ou a pessoa escolher
avançar
, retorne automaticamente para
$specsfy-update-spec
se a etapa foi chamada por mudança tardia em spec aprovada. Para criar ou consolidar a definição inicial, chame
$specsfy-03-specify
. No caso de
avançar
, entregue brief parcial e informe as lacunas que impedem o Definition Gate.
展示一份
Brief pronto para especificar
(准备好规格说明的简报),包含:
  1. 问题与目标。
  2. 参与者。
  3. 范围与非范围。
  4. 核心流程与规则。
  5. Given/When/Then格式的验收标准。
  6. 技术与质量约束。
  7. 假设。
  8. 未解决的决策或
    Nenhuma lacuna aplicável
    (无适用空白)。
  9. 歧义词汇与已确认的推断。
当用户授权记录时,更新待办项。当简报足够充分或用户选择
avançar
(推进)时,如果本阶段是因已批准规格说明的后期变更而调用的,请自动返回
$specsfy-update-spec
。若要创建或整合初始定义,请调用
$specsfy-03-specify
。若用户选择
推进
,则交付部分简报,并说明阻碍定义闸门的空白。

Limites

限制

  • Não alterar nem apagar entradas de Inbox.
  • Não criar
    spec.md
    , tarefas, research, testes ou código.
  • Não inventar stakeholders, integrações, restrições ou decisões.
  • Não transformar hipótese técnica em requisito.
  • Não mover nem apagar item existente sem confirmação.
  • 不得修改或删除Inbox中的条目。
  • 不得创建
    spec.md
    、任务、研究、测试或代码。
  • 不得编造利益相关者、集成、约束或决策。
  • 不得将技术假设转化为需求。
  • 未经确认,不得移动或删除现有项。