mvpfy-context

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Contexto de um projeto existente

现有项目的上下文

Esta skill entra antes da entrevista, durante a configuração do projeto e no início de cada retomada da conversa. Ela procura material já criado e entrega um retrato curto para a orquestradora do MVPFy.

此Skill在访谈前、项目配置期间以及每次恢复对话开始时运行。它会查找已创建的素材，并为MVPFy的编排器提供一份简要概述。

Responsabilidade

职责

Executar
```
scripts/analyze-existing-project.mjs
```
no diretório consumidor.
Procurar specs, briefs, backlogs, planos, documentos de produto e registros em arquivos Markdown, YAML e JSON.
Ler manifestos e contar arquivos de programação por linguagem e pasta.
Reconhecer a stack declarada, a existência de uma aplicação e os sinais técnicos que ajudam a formular o primeiro MVP.
Entregar sugestões de resposta com origem, resumo e grau de confiança.
Registrar perguntas que o material não consegue responder.

在客户目录中执行
```
scripts/analyze-existing-project.mjs
```
脚本。
查找规格说明（specs）、项目简报（briefs）、待办事项（backlogs）、计划、产品文档和记录，涉及Markdown、YAML和JSON格式文件。
读取清单文件，按语言和目录统计编程文件数量。
识别已声明的技术栈、应用程序的存在情况，以及有助于构建首个MVP的技术信号。
提供包含来源、摘要和置信度的响应建议。
记录素材无法回答的问题。

Limites

限制

A leitura é somente de contexto. Nenhum arquivo do projeto consumidor é alterado, exceto os artefatos criados dentro de
```
.mvpfy/
```
pelo próprio MVPFy.
```
node_modules
```
,
```
vendor
```
,
```
.git
```
, builds, caches, cobertura, segredos e arquivos binários ficam fora da leitura.
Um nome de função, uma rota ou uma dependência mostra implementação. Não prova público, problema, proposta de valor, preço ou aceitação do produto.
Uma sugestão pode preencher uma lacuna técnica. A pessoa ainda confirma escolhas de produto, público e escopo durante a conversa.
A skill nunca escreve
```
spec.md
```
, não modifica
```
specsfy/
```
e não transforma código existente em código do MVPFy.

仅读取上下文信息。不会修改客户项目的任何文件，除非是MVPFy自身在
```
.mvpfy/
```
目录内创建的工件。
```
node_modules
```
、
```
vendor
```
、
```
.git
```
、构建文件、缓存文件、覆盖率文件、机密文件和二进制文件不在读取范围内。
函数名、路由或依赖项仅能体现实现细节，无法证明目标受众、问题、价值主张、定价或产品认可度。
建议可以填补技术空白，但人员仍需在对话中确认产品受众、目标和范围的选择。
该Skill绝不会编写
```
spec.md
```
，不会修改
```
specsfy/
```
目录，也不会将现有代码转换为MVPFy代码。

Saída

输出

O relatório fica em

.mvpfy/existing-project.json

. Ele contém:

```
sources.specs
```
: documentos encontrados, tipo, título, caminho e trecho;
```
sources.code
```
: arquivos de programação agrupados por linguagem;
```
manifests
```
: manifestos lidos e dependências declaradas;
```
stack
```
: tecnologias reconhecidas com seus caminhos de origem;
```
suggested_answers
```
: campos que o contexto ajuda a responder;
```
gaps
```
: perguntas que continuam abertas;
```
summary
```
: contagens e leitura geral do projeto.

O estado recebe somente um ponteiro resumido em

existing_project_context

. A orquestradora lê o relatório completo antes de montar a fila, usa sugestões suficientes para não repetir perguntas e marca como pendente qualquer conclusão que o material não sustente.

报告存储在

.mvpfy/existing-project.json

中，包含以下内容：

```
sources.specs
```
：找到的文档、类型、标题、路径和片段；
```
sources.code
```
：按语言分组的编程文件；
```
manifests
```
：读取的清单文件和已声明的依赖项；
```
stack
```
：识别出的技术及其来源路径；
```
suggested_answers
```
：上下文有助于回答的字段；
```
gaps
```
：仍未解决的问题；
```
summary
```
：项目的统计数据和总体概述。

状态仅接收

existing_project_context

中的精简指针。编排器在构建队列前会读取完整报告，使用足够的建议以避免重复提问，并将素材无法支撑的任何结论标记为待处理。

Gatilhos da orquestradora

编排器触发条件

setup-project.mjs

, a skill roda depois da criação inicial de

.mvpfy/

. No começo de cada conversa com

$mvpfy

, rode novamente:

bash

node skills/mvpfy-context/scripts/analyze-existing-project.mjs --project .

Depois leia

.mvpfy/existing-project.json

junto de

state.json

answers.jsonl

MVP.md

e das fontes de contexto. Se não houver material, continue pelo relato livre da ideia. Se houver, comece pelos campos já explicados e apresente somente a próxima lacuna relevante.

在

setup-project.mjs

中，此Skill在

.mvpfy/

初始创建完成后运行。在每次与

$mvpfy

对话开始时，再次运行以下命令：

bash

node skills/mvpfy-context/scripts/analyze-existing-project.mjs --project .

之后，将

.mvpfy/existing-project.json

与

state.json

、

answers.jsonl

、

MVP.md

以及上下文来源一同读取。如果没有素材，则继续通过自由叙述想法推进；如果有素材，则从已解释的字段开始，仅呈现下一个相关的空白点。