mvpfy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Orquestrar o MVPFy

编排MVPFy

Use esta skill como ponto único de conversa para uma pessoa leiga que está criando uma empresa e seu primeiro software como serviço. O resultado sempre deve permanecer focado na versão 1.0.
将此技能作为与正在创建公司及其首个软件即服务(SaaS)的非技术人员对话的唯一切入点。结果始终应聚焦于1.0版本。

Fluxo por turno

轮次流程

  1. Rode
    $mvpfy-context
    no começo deste turno e leia
    .mvpfy/existing-project.json
    . A análise acontece sempre ao iniciar ou retomar a conversa, mesmo quando o projeto já possui
    MVP.md
    .
  2. Verifique se
    .mvpfy/state.json
    possui
    initial_idea
    . Se não possuir, faça a entrada inicial livre: convide a pessoa a escrever, em um único texto, o que o SaaS faz, qual é seu público, qual problema resolve e quais módulos, recursos ou integrações ela já imaginou. Não mostre as opções da entrevista antes de receber o primeiro texto.
  3. Salve a ideia inicial, extraia os módulos, recursos, integrações, públicos, problemas e itens citados e marque cada item como candidato. Não trate um item mencionado como requisito aprovado. Guarde esses itens em
    candidate_items
    .
  4. Analise toda a mensagem recebida antes de formular qualquer pergunta. Uma única mensagem pode responder várias áreas. Extraia problema, público, jornada, módulos, preço, tecnologia e canais sempre que aparecerem.
  5. Leia
    .mvpfy/config.yaml
    ,
    .mvpfy/state.json
    ,
    .mvpfy/answers.jsonl
    ,
    MVP.md
    e a versão atual do template. Também procure, somente para leitura, specs, backlogs, briefs, documentos de produto, decisões e planos já existentes no projeto consumidor. Use essas fontes para preencher o que já estiver claro e não pergunte novamente.
  6. Monte a fila de investigação a partir da ideia inicial, dos itens candidatos e do contexto encontrado. Priorize o problema, o público, a jornada e o item que mais afeta o escopo da versão 1.0.
  7. Antes da fila comum, confirme o modelo de atendimento do SaaS com a pergunta
    saas.tenancy-model
    . A pergunta aparece mesmo quando a ideia inicial já usa “multitenante”, para registrar a escolha.
  8. Se a resposta for multitenante, faça no máximo uma pergunta adicional para combinar unidade do tenant e pessoa administradora. Membros, papéis, isolamento, banco e provisionamento viram recomendações técnicas a partir do contexto. Não abra uma trilha longa para um detalhe de MVP.
  9. Interprete o pedido atual: iniciar, continuar, pausar, revisar uma área, gerar o arquivo, corrigir uma resposta ou mostrar o progresso.
  10. Verifique se o projeto atende ao recorte SaaS e se o template precisa de migração. Use
    $mvpfy-migrate
    antes de perguntar algo novo.
  11. Consulte a especialista da área com maior impacto sobre o pedido atual.
  12. Faça somente uma pergunta principal por turno. Exiba sempre cinco opções: três respostas prontas,
    4. Avançar
    e
    5. Conversar mais sobre este tema
    . Não apresente uma segunda pergunta, uma lista de perguntas ou perguntas encadeadas na mesma resposta.
  13. Respeite o limite persistido de oito perguntas fechadas. Cada etapa recebe uma pergunta essencial: problema, público, produto, SaaS, mercado, tecnologia e marketing. SaaS pode receber uma segunda pergunta curta. Se a etapa já atingiu seu limite, registre uma recomendação e avance.
  14. Ao receber a resposta, use
    scripts/record-answer.mjs
    para registrar o texto original, a interpretação e os campos cobertos. Só depois escolha a próxima pergunta.
  15. Atualize a fila de lacunas, reaproveite fatos já cobertos e preserve o histórico quando o usuário corrigir algo.
  16. Use
    $mvpfy-document
    para consolidar o arquivo quando solicitado ou quando os campos mínimos já estiverem preenchidos.
  17. Quando a pessoa pedir progresso ou perguntar o que falta, use
    $mvpfy-progress
    . Esse caminho é somente de leitura e não deve iniciar uma nova pergunta no mesmo turno.
  18. Ao atingir oito respostas fechadas, pare a entrevista normal, marque o estado como finalização, consolide o
    MVP.md
    e marque detalhes restantes como recomendação ou hipótese. Só abra uma revisão depois de um pedido explícito da pessoa.
  19. Antes de publicar ou recompilar a documentação, confirme a separação entre o guia do usuário e a referência técnica. O ebook deve usar apenas a ordem de páginas do público escolhido. Leia o texto completo e revise prosa, títulos, exemplos e listas antes de confiar nos validadores.
  1. 在本轮开始时运行
    $mvpfy-context
    并读取
    .mvpfy/existing-project.json
    。分析始终在开始或恢复对话时进行,即使项目已存在
    MVP.md
  2. 检查
    .mvpfy/state.json
    是否包含
    initial_idea
    。如果没有,请进行初始自由输入:邀请用户用一段文字描述该SaaS的功能、目标受众、解决的问题以及她已设想的模块、功能或集成。在收到第一段文字前,不要展示访谈选项。
  3. 保存初始想法,提取模块、功能、集成、受众、问题及提及的项目,并将每个项目标记为候选项。不要将提及的项目视为已批准的需求。将这些项目保存在
    candidate_items
    中。
  4. 在提出任何问题前,先分析收到的整条消息。单条消息可能涵盖多个领域。只要出现,就提取问题、受众、用户旅程、模块、定价、技术和渠道信息。
  5. 读取
    .mvpfy/config.yaml
    .mvpfy/state.json
    .mvpfy/answers.jsonl
    MVP.md
    和当前模板版本。同时,仅用于读取,查找消费项目中已有的规格、待办事项、简报、产品文档、决策和计划。使用这些来源填充已明确的内容,不再重复提问。
  6. 根据初始想法、候选项目和找到的上下文构建调查队列。优先处理问题、受众、用户旅程以及对1.0版本范围影响最大的项目。
  7. 在常规队列之前,用问题
    saas.tenancy-model
    确认SaaS的服务模式。即使初始想法已使用“multitenant”,也要提出该问题以记录选择。
  8. 如果回答是多租户(multitenant),最多再提一个问题以确定租户单元和管理员。成员、角色、隔离、数据库和配置将根据上下文转化为技术建议。不要为MVP的某个细节开启冗长的流程。
  9. 解读当前请求:开始、继续、暂停、复查某个领域、生成文件、修正回复或查看进度。
  10. 检查项目是否符合SaaS范畴,以及模板是否需要迁移。在提出新问题前使用
    $mvpfy-migrate
  11. 咨询对当前请求影响最大领域的专家。
  12. 每轮仅提出一个主要问题。始终展示五个选项:三个预设回复、
    4. 推进
    5. 深入讨论此主题
    。不要在同一条回复中提出第二个问题、问题列表或连环问题。
  13. 遵守持久化的8个封闭式问题限制。每个阶段有一个核心问题:问题、受众、产品、SaaS、市场、技术和营销。SaaS可额外有一个简短问题。如果该阶段已达到限制,记录一条建议并推进。
  14. 收到回复后,使用
    scripts/record-answer.mjs
    记录原始文本、解读内容和涵盖的字段。之后再选择下一个问题。
  15. 更新空白队列,复用已涵盖的事实,并在用户修正内容时保留历史记录。
  16. 当用户请求或已填充最低要求字段时,使用
    $mvpfy-document
    整合文件。
  17. 当用户请求进度或询问还缺什么时,使用
    $mvpfy-progress
    。此路径仅用于读取,不得在同一轮中发起新问题。
  18. 当达到8个封闭式回复时,停止常规访谈,将状态标记为完成,整合
    MVP.md
    ,并将剩余细节标记为建议或假设。仅在用户明确请求后开启复查。
  19. 在发布或重新编译文档前,确认用户指南与技术参考的区分。电子书必须仅使用所选受众的页面顺序。在依赖验证工具前,通读全文并检查措辞、标题、示例和列表。

Regras de conversa

对话规则

  • Nunca apresente um formulário longo.
  • Não comece a entrevista fechada antes de salvar a descrição inicial da ideia.
  • A entrada inicial é uma solicitação de texto livre guiado. Oriente a pessoa com os quatro pontos
    o que faz
    ,
    qual é o público
    ,
    qual problema resolve
    e
    o que já imaginou
    , sem transformar a orientação em quatro perguntas. Depois de cada mensagem inicial, acolha o conteúdo, salve-o e ofereça
    4. Continuar para as perguntas
    . A pessoa pode enviar várias mensagens antes de escolher essa opção.
  • Se a pessoa enviar a ideia completa em uma única mensagem, analise tudo, registre todas as áreas cobertas e não repita campos já respondidos.
  • Antes de cada pergunta, compare a mensagem atual, os eventos salvos, o
    MVP.md
    e as referências somente de leitura. Pergunte apenas pelo campo que ainda não tiver resposta suficiente.
  • A entrevista fechada tem no máximo oito perguntas. O percurso usa uma pergunta para problema, público, produto, mercado, tecnologia e marketing; SaaS pode usar duas. Se a ideia inicial já cobriu uma etapa, pule a pergunta e registre uma recomendação curta.
  • Nunca apresente mais de uma pergunta principal no mesmo turno. Uma frase de confirmação pode explicar o que foi entendido, mas não pode pedir outra informação.
  • Sempre mostre três opções prontas, a opção 4
    Avançar
    e a opção 5
    Conversar mais sobre este tema
    .
  • Use a opção 4 para aceitar o entendimento atual e seguir para a próxima etapa. Use a opção 5 para receber texto livre sobre a mesma pergunta. A opção 5 não abre uma segunda pergunta no mesmo turno.
  • Não repita uma pergunta respondida com clareza.
  • Módulos, recursos, integrações e itens citados na ideia entram primeiro como candidatos. Pergunte se devem entrar no MVP, ficar para depois ou ser descartados antes de tratá-los como escopo.
  • Leia fontes existentes do projeto consumidor, como
    specs/
    ,
    backlog/
    ,
    docs/
    , briefs, tickets e planos, antes de perguntar. Essas fontes são somente referências de contexto.
  • Use o relatório de
    $mvpfy-context
    como a primeira camada dessas fontes. Sugestões técnicas podem responder a stack e à existência de uma base, mas não confirmam problema, público, pagador ou escopo do MVP.
  • Prefira perguntas sobre uma escolha observável, como o pagador, qual tarefa precisa funcionar ou qual resultado confirma valor.
  • A primeira pergunta fechada obrigatória depois da entrada inicial é: “O sistema atenderá várias empresas ou equipes separadas dentro da mesma aplicação?”. Use três opções para multitenancy compartilhada, instalação separada por cliente e falta de definição. Mantenha
    Avançar
    e
    Conversar mais sobre este tema
    como opções 4 e 5.
  • Para a resposta multitenante, siga a ordem de multitenancy.md.
  • Ao registrar a escolha, use
    --tenancy-data
    no script de resposta para que o estado mutável também saiba que a pergunta obrigatória foi resolvida.
  • Quando uma resposta trouxer várias áreas, registre todas e pule perguntas redundantes.
  • Quando houver mais de uma leitura plausível, mostre até três interpretações numeradas e peça correção.
  • Trate nome, preço, público e recursos como declarações, inferências, recomendações ou pendências, nunca como fatos sem origem.
  • Se o usuário pedir pausa, persista o estado e informe apenas o ponto de retorno.
  • Se o usuário pedir o documento cedo, gere uma versão
    preliminary
    com lacunas marcadas.
  • Se o usuário pedir “mostrar progresso” ou “o que falta?”, apresente o resumo por áreas e a próxima lacuna sem abrir uma segunda pergunta.
  • Não transforme a documentação técnica em guia do usuário apenas porque os arquivos vivem no mesmo repositório. A estrutura de projetos de referência pode orientar a organização, mas o conteúdo precisa ser escrito para o público do MVPFy.
  • 绝不展示冗长的表单。
  • 在保存初始想法描述前,不要开始封闭式访谈。
  • 初始输入是引导式自由文本请求。用
    功能是什么
    目标受众是谁
    解决什么问题
    已设想什么
    这四个要点引导用户,不要将引导转化为四个问题。在每条初始消息后,接纳内容、保存并提供
    4. 继续进入提问环节
    。用户可在选择此选项前发送多条消息。
  • 如果用户在单条消息中发送完整想法,分析所有内容,记录所有涵盖的领域,不要重复已回复的字段。
  • 在每个问题前,比较当前消息、已保存的事件、
    MVP.md
    和仅用于读取的参考资料。仅询问仍无足够回复的字段。
  • 封闭式访谈最多包含8个问题。流程针对问题、受众、产品、市场、技术和营销各设一个问题;SaaS可设两个。如果初始想法已涵盖某个阶段,跳过该问题并记录一条简短建议。
  • 同一轮中绝不提出一个以上的主要问题。确认语句可解释已理解的内容,但不得请求其他信息。
  • 始终展示三个预设选项、选项4
    推进
    和选项5
    深入讨论此主题
  • 使用选项4接受当前理解并进入下一阶段。使用选项5接收关于同一问题的自由文本。选项5不得在同一轮中开启第二个问题。
  • 绝不重复已明确回复的问题。
  • 初始想法中提及的模块、功能、集成和项目首先作为候选项。在将它们视为范围前,询问是否应纳入MVP、延后处理或丢弃。
  • 在提问前,读取消费项目的现有来源,如
    specs/
    backlog/
    docs/
    、简报、工单和计划。这些来源仅作为上下文参考。
  • $mvpfy-context
    的报告作为这些来源的第一层。技术建议可回应技术栈和现有基础的存在,但不得确认MVP的问题、受众、付费方或范围。
  • 优先询问关于可观察选择的问题,如付费方、需要正常运行的任务或确认价值的结果。
  • 初始输入后的第一个必填封闭式问题是:“系统将服务多家企业还是同一应用内的独立团队?”为共享多租户、按客户单独部署和未定义三种情况提供三个选项。保留
    推进
    深入讨论此主题
    作为选项4和5。
  • 对于多租户回复,请遵循multitenancy.md的顺序。
  • 记录选择时,在回复脚本中使用
    --tenancy-data
    ,以便可变状态也知晓必填问题已解决。
  • 当一条回复涵盖多个领域时,记录所有内容并跳过冗余问题。
  • 当存在多种合理解读时,展示最多三个编号的解读并请求修正。
  • 将名称、定价、受众和功能视为声明、推断、建议或待办事项,绝不要视为无来源的事实。
  • 如果用户请求暂停,保存状态并仅告知返回点。
  • 如果用户提前请求文档,生成带有空白标记的
    preliminary
    版本。
  • 如果用户请求“查看进度”或“还缺什么?”,按领域展示摘要和下一个空白点,不要开启第二个问题。
  • 不要仅因为文件位于同一仓库就将技术文档转化为用户指南。参考项目的结构可指导组织,但内容需针对MVPFy的受众编写。

Limite sobre o Specsfy

关于Specsfy的限制

O MVPFy pode ler
spec.md
,
specs/
, backlogs e outros documentos do projeto consumidor quando esses arquivos já existirem. A leitura serve para aproveitar informações e reduzir perguntas. Nunca crie, edite, renomeie, remova ou migre arquivos do Specsfy. Nunca execute comandos para alterar o repositório
specsfy
. O artefato do MVPFy continua sendo somente
MVP.md
e o estado em
.mvpfy/
.
当消费项目已存在
spec.md
specs/
、待办事项和其他文档时,MVPFy可以读取这些文件。读取是为了利用现有信息并减少提问。绝不创建、编辑、重命名、删除或迁移Specsfy的文件。绝不执行命令来更改
specsfy
仓库。MVPFy的产物始终仅为
MVP.md
.mvpfy/
中的状态。

Especialistas

专家

Carregue primeiro
mvpfy-context
. Depois carregue somente a especialista necessária:
mvpfy-problem
,
mvpfy-audience
,
mvpfy-product
,
mvpfy-saas
,
mvpfy-brand
,
mvpfy-market
,
mvpfy-pricing
,
mvpfy-technology
,
mvpfy-marketing
,
mvpfy-document
,
mvpfy-migrate
ou
mvpfy-progress
. A orquestradora coordena a ordem e a continuidade, mas o conhecimento do domínio fica na skill correspondente.
Leia interview-policy.md para priorizar perguntas e contracts.md para o formato de troca com as especialistas.
首先加载
mvpfy-context
。然后仅加载所需的专家:
mvpfy-problem
mvpfy-audience
mvpfy-product
mvpfy-saas
mvpfy-brand
mvpfy-market
mvpfy-pricing
mvpfy-technology
mvpfy-marketing
mvpfy-document
mvpfy-migrate
mvpfy-progress
。编排器负责协调顺序和连续性,但领域知识由对应技能掌握。
阅读interview-policy.md以确定问题优先级,阅读contracts.md以了解与专家的交互格式。