mcpField
M
mvpfy-context

mvpfy-context

github.com/promovawebAgent 工作流8210 次安装10 周前更新
代码仓库

关于 mvpfy-context

mvpfy-context 是供 MVPFy 编排器使用的技能，可在项目设置前或对话恢复时检查现有项目并整理技术背景。它提供有来源的建议和待解问题，除自身的 .mvpfy 产物外不修改项目文件。

主要功能

  1. 01分析现有项目文件
  2. 02查找规格与产品文档
  3. 03按语言和目录汇总代码
  4. 04识别声明的技术栈与依赖
  5. 05提供带来源和置信度的建议
  6. 06记录未解答的问题

适用场景

  1. 01在 MVP 访谈前整理项目背景
  2. 02恢复对话时避免重复已回答的问题
  3. 03找出可用于构思初始 MVP 的技术信息
  4. 04区分已知实现事实与待定产品决策

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/promovaweb/mvpfy --skill mvpfy-context

安装后在 Claude Code 中输入/mvpfy-context确认已加载。

附带文件agents/openai.yamlscripts/analyze-existing-project.mjs

详细介绍

现有项目的上下文

此技能在访谈开始前、项目配置期间以及每次恢复对话时启动。它会查找已有材料，并为 MVPFy 编排器提供简要概况。

职责

  1. 在使用方目录中运行 scripts/analyze-existing-project.mjs。
  2. 在 Markdown、YAML 和 JSON 文件中查找规格说明、简报、待办事项、计划、产品文档和记录。
  3. 读取清单，并按语言和文件夹统计编程文件。
  4. 识别已声明的技术栈、应用是否存在，以及有助于制定首个 MVP 的技术线索。
  5. 提供带有来源、摘要和置信度的建议回答。
  6. 记录材料无法回答的问题。

限制

  • 阅读仅用于获取上下文。不会修改使用方项目中的任何文件，MVPFy 自身在 .mvpfy/ 中创建的文件除外。
  • node_modules、vendor、.git、构建产物、缓存、覆盖率数据、机密信息和二进制文件不纳入读取范围。
  • 函数名、路由或依赖只能体现实现情况，不能证明产品的受众、问题、价值主张、价格或接受度。
  • 建议可以填补技术方面的空缺。产品、受众和范围的选择仍由用户在对话中确认。
  • 此技能绝不会写入 spec.md、修改 specsfy/，也不会将现有代码转换为 MVPFy 代码。

输出

报告保存在 .mvpfy/existing-project.json。其中包含：

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

状态中只会在 existing_project_context 中保存一个简要指针。编排器会在生成队列前读取完整报告，使用足够的建议以避免重复提问，并将材料无法支撑的结论标记为待确认。

编排器触发条件

在 setup-project.mjs 中，此技能会在初次创建 .mvpfy/ 后运行。 每次与 $mvpfy 开始对话时，都要重新运行：

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

然后读取 .mvpfy/existing-project.json，以及 state.json、answers.jsonl、MVP.md 和上下文来源文件。如果没有材料，就根据对方自由描述的想法继续。如果有材料，就从已说明的字段开始，只提出下一个相关的空缺。

评论

支持 Markdown