specsfy-data-discovery

发现系统需要保存哪些信息

必须完成的准备工作

运行此技能前，必须先在项目根目录加载 $specsfy-setup。如果发生自动交接，请在此步骤前重新加载。沿用对话中已确认的根目录；如果 setup 指出有待处理事项，请勿继续。

交互模式

交互模式：perguntas。 提出任何问题前，请阅读并应用 .specsfy/Spec.md 中的 Contrato de perguntas numeradas。

请使用巴西葡萄牙语讨论系统信息，不要要求对方描述数据库、表、字段、键或关系。使用产品本身的词语： 需要记住什么、谁会使用、什么会变化，以及什么时候不再需要。

准备对话

1. 阅读 Inbox、MVP.md 中的发现内容、backlog、spec 或引发本次发现的请求。
2. 如果存在，请阅读 PROJECT.md 和 .specsfy/DATABASE.md。区分已确认的内容与仍需讨论的内容。
3. 只寻找系统需要保存、查询、比较、展示、共享、更正或删除的信息。不要询问不会影响使用流程或运作的数据。
4. 保留对方提供的信息来源和表述方式。假设不能作为已确认内容写入数据文件。

使用非技术语言提问

每轮选择尚未确认且影响最大的适用信息，并遵循核心约定。维护一份缺失或含义不清的待保存信息清单。每次收到回复后更新清单，并询问下一项，直到所有信息都已确认、延期处理或结束；每个领域最多提问八次。可以根据上下文调整以下问题：

• “每个订单、人员或服务需要记住什么？”
• “谁可以查看或更改这条信息？”
• “同一个人下多个订单时，哪些信息需要保持关联？”
• “这条信息什么时候会变化、失效或需要删除？”
• “哪些信息不能展示给其他人？”

避免解释内部机制。如果对方使用技术术语，请先确认它对其工作产生的影响，再记录回答。

建议如何记录每条信息

了解用途后，为每条信息提出一种简单的记录方式并请对方确认。根据预期用途选择建议，不要提及技术或系统内部组成部分：

• 短文本：用于名称、标题和便于快速查看的代码；
• 自由文本：用于备注和较长的描述；
• 数字：用于数量、测量值和计数；
• 金额：用于价格、收费和折扣；
• 日期或时间：用于预约、期限和事件；
• 选项：用于状态、类别或优先级；
• 是或否：用于确认；
• 文件或图片：用于凭证和附件。

将建议作为产品假设提出，用一句话说明理由，并询问它是否符合实际用途。只有在确认后，才记录建议格式。同一条信息有不同用途时，请分别记录每种用途。

记录已确认的内容

收到已确认的回答后，将上下文交给下面的脚本。 使用领域名称，并采用简短易懂、方便产品操作人员理解的句子。

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>"

仅在已确认的待保存信息部分记录已确认的回答。此部分应与从代码中观察到的内容分开。不要修改自动检测到的片段，也不要复制真实数据、凭据或敏感个人信息。

交接

• 如果旅程依赖已保存的信息，请先在待办列表中完成这项发现，再宣布简报已就绪。
• 在 MVP 发现阶段，将 MVP.md 保留为信息源；对于导入的待办列表中缺失或含糊、需要保存的信息，请加载此技能。
• 在编写规范时，如果数据源没有说明旅程需要记住什么，或谁可以查看每条信息，请加载此技能。
• Inbox 不会提出问题，只会保留信号供此阶段使用。

限制

• 不选择技术、内部结构或实现方式。
• 不创建待办列表、规范、任务、测试或代码。
• 不通过推断填补空缺。
• 不记录敏感内容。