Back to Details

specsfy-data-discovery

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Descobrir as informações que o sistema precisa guardar

确定系统需要存储的信息

Preparação obrigatória

必备准备工作

Antes de executar esta skill, carregue obrigatoriamente 
$specsfy-setup
na raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa. Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma pendência.
在执行此Skill之前，必须在项目根目录加载
$specsfy-setup
。在自动交接时，需在本阶段前重新加载它。复用对话中已确认的根目录，如果setup显示存在未完成项，则不要继续。

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
.
Converse em Português do Brasil sobre informações do sistema sem pedir que a pessoa descreva banco de dados, tabela, campo, chave ou relacionamento. Use palavras do próprio produto: o que será lembrado, quem usa, o que muda e quando deixa de ser necessário.
交互模式：
perguntas
。在提出任何问题之前，请阅读并应用
.specsfy/Spec.md
中的
编号提问协议
。
用日常语言沟通系统相关信息，不要要求对方使用数据库、表、字段、键或关系等技术术语。使用产品自身的业务表述：需要记录什么内容、谁会使用这些信息、内容会发生哪些变化以及何时不再需要这些信息。

Preparar a conversa

准备对话

  1. Leia a Inbox, a descoberta de 
    MVP.md
    , o backlog, a spec ou o pedido que originou a descoberta.
  2. Leia 
    PROJECT.md
    e 
    .specsfy/DATABASE.md
    quando existirem. Separe o que já foi confirmado do que ainda precisa de conversa.
  3. Procure somente informações que o sistema precise guardar, consultar, comparar, mostrar, compartilhar, corrigir ou apagar. Não pergunte sobre dados que não alteram a jornada ou a operação.
  4. Preserve fontes e formulações da pessoa. Uma hipótese não vira conteúdo confirmado no arquivo de dados.
  1. 查看收件箱（Inbox）、
    MVP.md
    中的需求发现内容、待办事项（backlog）、规格文档（spec）或触发本次需求发现的请求。
  2. 若存在
    PROJECT.md
    和
    .specsfy/DATABASE.md
    ，请阅读这两个文件。区分已确认的内容和仍需沟通的内容。
  3. 仅寻找系统需要存储、查询、比较、展示、分享、修正或删除的信息。不要询问不影响用户流程或业务操作的数据。
  4. 保留用户提供的信息来源和表述方式。未经确认的假设不能作为已确定内容写入数据文件。

Perguntar sem linguagem técnica

用非技术语言提问

Em cada rodada, escolha uma informação aplicável de maior impacto ainda não confirmada e siga o contrato central. Mantenha uma lista das informações a guardar ausentes ou ambíguas. Depois de cada resposta, atualize a lista e pergunte sobre a próxima até que todas estejam confirmadas, adiadas ou encerradas, respeitando o máximo de oito perguntas por área. Prefira perguntas como estas, ajustadas ao contexto:
  • "O que você precisa lembrar sobre cada pedido, pessoa ou atendimento?"
  • "Quem pode ver ou mudar essa informação?"
  • "O que precisa continuar ligado quando uma pessoa fizer mais de um pedido?"
  • "Quando essa informação muda, deixa de valer ou precisa ser apagada?"
  • "Que informação não pode aparecer para outras pessoas?"
Evite explicar a mecânica interna. Se a pessoa usar termos técnicos, confirme o efeito no trabalho dela antes de registrar a resposta.
每一轮沟通中，选择一个尚未确认且影响较大的信息点，遵循核心协议。列出缺失或模糊的待存储信息清单。每次得到回复后更新清单，然后询问下一个问题，直到所有信息都被确认、推迟或终止，注意每个领域最多提出8个问题。优先使用以下符合上下文的提问方式：
  • "关于每个订单、用户或服务记录，你需要系统记住哪些内容？"
  • "谁可以查看或修改这些信息？"
  • "当用户发起多个订单时，哪些信息需要保持关联？"
  • "这些信息何时会发生变化、失效或需要被删除？"
  • "哪些信息不能对其他用户展示？"
避免解释系统内部机制。如果用户使用技术术语，请先确认该术语在其工作中的实际作用，再记录回复内容。

Sugerir como cada informação será registrada

建议每条信息的记录格式

Depois de entender a finalidade, proponha uma forma simples de registrar cada informação e peça confirmação. Escolha a sugestão pelo uso esperado, sem citar tecnologias ou partes internas do sistema:
  • texto curto para nomes, títulos e códigos lidos rapidamente;
  • texto livre para observações e descrições maiores;
  • número para quantidades, medidas e contagens;
  • valor em dinheiro para preços, cobranças e descontos;
  • data ou horário para agendamentos, prazos e acontecimentos;
  • escolha entre opções para situação, categoria ou prioridade;
  • sim ou não para confirmações;
  • arquivo ou imagem para comprovantes e anexos.
Apresente a sugestão como hipótese do produto, explique seu motivo em uma frase e pergunte se ela representa o uso real. Registre o 
formato sugerido
somente depois da confirmação. Quando uma mesma informação tiver usos distintos, registre cada uso separadamente.
在理解信息用途后，提出一种简单的记录方式并请求确认。根据预期用途选择建议格式，不要提及技术或系统内部组件：
  • 短文本：用于名称、标题和便于快速阅读的编码；
  • 自由文本：用于备注和较长的描述；
  • 数字：用于数量、度量和计数；
  • 货币值：用于价格、收费和折扣；
  • 日期或时间：用于预约、期限和事件；
  • 选项选择：用于状态、类别或优先级；
  • 是/否：用于确认类信息；
  • 文件或图片：用于凭证和附件。
将建议作为产品假设提出，用一句话解释理由，并询问是否符合实际使用场景。仅在得到确认后记录
建议格式
。当同一信息有不同用途时，需分别记录每种用途。

Registrar o que foi confirmado

记录已确认的内容

Depois de uma resposta confirmada, entregue o contexto para o script abaixo. Use um nome do domínio e frases curtas compreensíveis para quem opera o produto.
bash
node .agents/skills/specsfy-data-discovery/scripts/\
registrar_dados_conversados.mjs \
  --project <raiz> \
  --nome "<informação do produto>" \
  --para-que-serve "<finalidade>" \
  --o-que-guardar "<informações necessárias>" \
  --formato-sugerido "<forma confirmada de registrar>" \
  --ligacoes "<o que permanece ligado a quê>" \
  --acesso "<quem consulta ou altera>" \
  --ciclo-de-vida "<quando muda, deixa de valer ou é apagado>" \
  --fontes "<caminhos de Inbox, backlog, MVP ou spec>"
O arquivo mantém a seção 
Informações a guardar confirmadas
separada do que foi observado no código. Não altere o trecho detectado automaticamente e não copie dados reais, credenciais ou informações pessoais sensíveis.
在得到确认回复后，为下方脚本提供上下文信息。使用业务领域名称和简短易懂的表述，便于产品操作人员理解。
bash
node .agents/skills/specsfy-data-discovery/scripts/\
registrar_dados_conversados.mjs \
  --project <raiz> \
  --nome "<informação do produto>" \
  --para-que-serve "<finalidade>" \
  --o-que-guardar "<informações necessárias>" \
  --formato-sugerido "<forma confirmada de registrar>" \
  --ligacoes "<o que permanece ligado a quê>" \
  --acesso "<quem consulta ou altera>" \
  --ciclo-de-vida "<quando muda, deixa de valer ou é apagado>" \
  --fontes "<caminhos de Inbox, backlog, MVP ou spec>"
文件中需将
已确认的待存储信息
部分与代码中检测到的内容分开。不要修改自动检测到的内容，也不要复制真实数据、凭证或敏感个人信息。

Handoffs

交接规则

  • No backlog, faça esta descoberta antes de declarar o brief pronto quando a jornada depender de informações guardadas.
  • Durante a descoberta do MVP, preserve primeiro a fonte e as Inboxes; depois carregue esta skill para cada informação do produto a guardar que estiver ausente ou ambígua.
  • Na especificação, carregue esta skill se a fonte de dados não explicar o que a jornada precisa lembrar ou quem pode consultar cada informação.
  • A Inbox não faz perguntas. Ela apenas preserva sinais para esta etapa.
  • 在待办事项中，当用户流程依赖存储的信息时，需先完成本次需求发现，再标记需求简报为就绪。
  • 在MVP需求发现阶段，先保留原始信息来源和收件箱内容；之后针对每个缺失或模糊的待存储产品信息，加载此Skill。
  • 在规格文档阶段，如果数据来源未说明用户流程需要记录的内容或每个信息的查看权限，则加载此Skill。
  • 收件箱不负责提问，仅为本次阶段保留相关线索。

Limites

限制条件

  • Não escolher tecnologia, estrutura interna ou implementação.
  • Não criar backlog, spec, tarefas, testes ou código.
  • Não preencher lacunas por inferência.
  • Não registrar conteúdo sensível.
  • 不得选择技术方案、内部结构或实现方式。
  • 不得创建待办事项、规格文档、任务、测试或代码。
  • 不得通过推理填补信息空白。
  • 不得记录敏感内容。