Idea → MVP：从灵感发现到产品落地

Overview

本 skill 覆盖产品从 0 到 1 的完整流程：发现灵感 → 验证想法 → 实现 MVP。全程使用中文输出。

用户可以从任意阶段切入：

• 没有想法 → 从阶段一开始
• 已有想法需验证 → 从阶段二开始
• 想法已验证想动手 → 从阶段三开始

三阶段工作流

阶段一：灵感发现（Find Ideas）

目标：通过多平台搜索，发现近期流行的实用小工具和独立产品，提炼痛点并生成可拓展的产品 Ideas。

执行：读取 references/find-ideas.md，按照其中的搜索策略、筛选标准、Idea 扩展方法和报告模板执行。在与用户讨论的过程中，留意用户透露的行业背景、产品偏好、技术经验等信息，记录到 user-profile.md。

核心步骤：

1. 确认搜索偏好：检查 .env.idea2mvp，如未配置偏好则询问用户：是否配置 Product Hunt Token 以使用 API 搜索？是否使用 Playwright 控制浏览器搜索小红书？用户选择跳过的数据源会写入 .env.idea2mvp（SKIP_PH_API=true / SKIP_XHS_PLAYWRIGHT=true），后续自动跳过不再询问，改用 web_search 替代
2. 并行搜索 Product Hunt、中文社区（小红书/V2EX/少数派）、Indie Hackers、独立开发者社区、GitHub Trending
3. 筛选 5-8 个最有启发性的工具，深度分析痛点和模式
4. 生成 5 个可拓展的产品 Ideas
5. 输出完整的工具探索报告

阶段输出：工具探索报告（含工具推荐 + 产品 Ideas + 趋势洞察）

阶段过渡：报告输出后，与用户深入讨论感兴趣的 Idea 方向。沟通完成后，询问用户是否生成一份灵感确认文档（Markdown 文件），内容包括：

• 用户选定或倾向的 Idea 方向
• 用户在沟通中表达的产品偏好、行业经验、个人优势
• 用户关心的关键问题和顾虑
• 讨论中产生的新想法或调整

此文档作为阶段二的输入上下文，确保验证阶段能延续阶段一的沟通成果，避免有价值的对话信息丢失。文件保存至项目工作目录（如 idea-brief.md）。

阶段二：想法验证（Validate Ideas）

目标：通过结构化的多步骤流程验证想法的可行性，以交互式咨询的方式逐步推进。

执行：读取 references/validate-ideas.md，按照其中的七步验证流程执行，每个环节都需要和用户确认信息，让用户参与评价和决策。评分时参考 references/evaluation-framework.md。沟通过程中持续将用户表现出的认知水平、行业见解、技术倾向等信息更新到 user-profile.md。

七步流程概览：

1. 想法澄清 — 通过反向提问帮用户厘清产品概念
2. 市场调研 — 搜索竞品、分析市场格局和空白点
3. 需求验证 — 在社区中验证真实需求和付费意愿
4. 技术可行性 — 评估技术栈、MVP 范围和开发周期
5. 商业模式 — 设计盈利模式和获客策略
6. 风险评估 — 识别致命风险和应对方案
7. 综合评分 — 五维度评分 + 最终建议 + 行动计划

关键机制：

• 每步完成后输出阶段文档，等用户确认后再推进
• 发现根本性障碍时触发 Idea 扩展机制（参考 references/idea-expansion.md），不简单否定，而是提出替代方向
• 用户可在任何阶段决定放弃或转向

阶段输出：可行性评估报告（参考 references/report-template.md）

若建议推进，询问用户是否进入阶段三。

阶段三：实现 MVP（Build MVP）

目标：基于验证结果，用用户能理解和维护的技术方案，规划并实现最小可行产品。

执行：读取 references/build-mvp.md，按照其中的 MVP 实现流程执行。必须先读取 user-profile.md，根据用户技术背景选择技术栈和沟通方式。涉及前端界面开发时，读取 references/frontend-design.md，按照其中的设计规范产出有辨识度的界面。

核心步骤：

1. 了解技术背景 — 读取 user-profile.md，如信息不足则主动询问用户的技术经验，确认用户能接受的交付形式
2. 确认 MVP 范围 — 基于阶段二的技术评估，锁定核心功能列表（只做必须的）
3. 技术方案设计 — 优先选择用户熟悉的技术栈；如需使用用户不熟悉的技术，在用户能理解的层度上解释为什么需要、怎么用
4. 逐步实现 — 按功能模块逐步编码实现，每完成一个模块与用户确认
5. 运行指引 — 提供用户能独立操作的启动步骤，确保用户能把 MVP 跑起来
6. 部署准备 — 提供部署方案和上线建议

阶段输出：可运行的 MVP 代码 + 用户能看懂的启动/部署指引

工具使用

• web_search：阶段一搜索工具/趋势，阶段二搜索竞品/社区讨论/市场数据
• agent-browser：深入访问产品页面、社区帖子、用户评价。（如未安装，先执行：npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser 安装 skill）.
• 代码编辑工具：阶段三实现 MVP

用户画像文件（贯穿全流程）

在三个阶段的对话过程中，持续维护一份 user-profile.md 文件（保存至项目工作目录），记录从对话中了解到的用户信息：

• 技术背景：熟悉的编程语言、框架、工具链，技术水平自评
• 行业经验：所在行业、工作角色、相关领域经验
• 认知水平：对产品、市场、商业模式等概念的理解程度
• 资源条件：可投入时间、预算、团队情况
• 偏好与风格：沟通偏好、决策风格、风险偏好

信息采集方式：

• 不要专门盘问用户，而是在自然对话中捕捉。例如：用户说”我之前用 Python 写过爬虫”→ 记录技术背景；用户问”什么是 LTV”→ 记录认知水平；用户说”我是设计师”→ 记录行业经验
• 阶段一讨论 Idea 时，用户的选择倾向、关注点、提问方式都能反映其背景
• 阶段二验证过程中，用户对技术方案、商业模式的反应能进一步补充画像
• 只在阶段三信息明显不足时才主动询问技术背景

使用规则：

• 在任何阶段的首次交互时，检查是否已存在 user-profile.md，如存在则先读取
• 每当从对话中捕捉到新的用户背景信息，及时追加更新（不需要征求用户同意）
• 当需要向用户解释技术概念、商业术语或做方案推荐时，先读取此文件，在用户能理解的认知层度上沟通
• 阶段三选择技术栈时，必须读取此文件，优先使用用户熟悉的技术

交互规范

1. 开场：判断用户意图，引导到对应阶段
2. 语言：全程中文
3. 态度：专业、客观、有建设性，用数据和事实说话
4. 阶段过渡：明确告知进度，征求用户意见后再推进
5. 适配用户：解释和沟通的深度应匹配用户的技术和认知背景（参考 user-profile.md）

Bundled Resources

references/

• references/find-ideas.md — 灵感发现的完整执行指南：搜索策略、关键词模板、筛选标准、Idea 扩展思维框架、报告输出模板。阶段一使用。
• references/validate-ideas.md — 想法验证的七步流程详细指南：每步的目标、执行步骤和输出模板。阶段二使用。
• references/idea-expansion.md — Idea 扩展与延伸方法论：底层模式提炼、问题诊断、场景迁移、替代方向生成。阶段二中发现障碍时使用。
• references/evaluation-framework.md — 评估框架：五维度评分标准、盈利模式参考、获客渠道对比、MVP 验证方法论。阶段二评分时使用。
• references/build-mvp.md — MVP 实现指南：用户技术背景适配、范围确认、技术方案设计、编码实现流程、分层运行指引、部署方案。阶段三使用。
• references/frontend-design.md — 前端设计规范：设计思考流程、字体/色彩/动效/构图/背景的视觉标准、实现原则。阶段三涉及前端界面时使用。
• references/report-template.md — 可行性评估报告模板。阶段二最终输出使用。

scripts/

• scripts/producthunt_trending.py — 通过 Product Hunt 官方 API v2 获取热门产品。需在 .env.idea2mvp 配置 PRODUCTHUNT_TOKEN。若用户设置了 SKIP_PH_API=true 则跳过脚本，改用 web_search。
• scripts/github_trending.py — 通过 GitHub Search API 搜索近期热门工具类项目。支持按天数、星数、语言、主题过滤。无需 Token。阶段一搜索 GitHub 时优先使用。
• scripts/v2ex_topics.py — 通过 V2EX 公开 API 获取热门/最新话题。无需认证。支持关键词过滤和工具话题筛选。阶段一搜索中文社区时优先使用。
• scripts/xiaohongshu_search.py — 使用 Playwright 自动化浏览器搜索小红书笔记。模拟真人操作（搜索 → 逐个点入详情页提取完整内容），需首次扫码登录。若用户设置了 SKIP_XHS_PLAYWRIGHT=true 则跳过脚本，改用 web_search。
• scripts/sspai_search.py — 通过少数派搜索 API 获取工具/产品相关文章。无需认证。支持单/多关键词搜索，自动去重、按点赞数排序。还支持 --detail <id> 获取文章完整正文内容。阶段一搜索中文社区时优先使用。
• scripts/indiehackers_search.py — 通过 Indie Hackers 内置的 Algolia 搜索 API 获取独立开发者产品。无需认证。返回产品名称、月收入、领域标签、商业模式等。支持 --min-revenue 过滤低收入产品。阶段一搜索英文独立开发者社区时优先使用。