Idea → MVP：从灵感发现到产品落地
Overview
本 skill 覆盖产品从 0 到 1 的完整流程：发现灵感 → 验证想法 → 实现 MVP。全程使用中文输出。
用户可以从任意阶段切入：
- 没有想法 → 从阶段一开始
- 已有想法需验证 → 从阶段二开始
- 想法已验证想动手 → 从阶段三开始
Runtime Data — 运行时数据目录
本 skill 遵循 skill 源码与运行时数据分离 的原则：
- Skill 源码（
SKILL.md、scripts/、references/）保持不可变，可安全分享和版本管理。 - 所有可变状态（配置、搜索结果、用户数据、缓存）统一存放在项目根目录的
.skills-data/idea2mvp/下。
<project_root>/.skills-data/idea2mvp/
.env — 配置文件（Token、搜索偏好、邮件 SMTP 等）
data/ — 持久化数据
search-results/ — 各平台搜索结果（ph_results.txt、github_results.txt 等）
idea-brief/ — 灵感确认文档（按时间戳归档）
user-profile.md、报告等
cache/ — 可安全删除的缓存（如小红书浏览器登录数据）
logs/ — 日志文件路径约定：
- 配置文件路径：
.skills-data/idea2mvp/.env - 搜索结果目录：
.skills-data/idea2mvp/data/search-results/ - 用户画像文件：
.skills-data/idea2mvp/data/user-profile.md - 灵感确认文档：
.skills-data/idea2mvp/data/idea-brief/{YYYY-MM-DD_HHmm}.md（每次生成带时间戳） - 历史推荐记录：
.skills-data/idea2mvp/data/seen-tools.jsonl（跨会话去重，自动过期） - 浏览器缓存：
.skills-data/idea2mvp/cache/xhs_browser_data/
Git 忽略：在 .gitignore 中添加 .skills-data/ 即可忽略所有 skill 运行时数据。
⚠️ 凭证安全原则：所有 Token、密码等敏感配置统一存放在 .skills-data/idea2mvp/.env 中，由脚本内部调用 load_env() 自动读取。严禁在命令行中内联传递凭证（如 TOKEN=xxx python3 scripts/...），这会导致敏感信息泄露到终端历史和日志中。
⚠️ 脚本执行规范：所有 Python 脚本通过环境变量 PROJECT_ROOT 确定项目根目录（即 .skills-data/ 的创建位置）。执行脚本时必须传入 PROJECT_ROOT，格式为：
PROJECT_ROOT=/path/to/project python3 scripts/xxx.py [参数]PROJECT_ROOT不是敏感信息，写在命令行中没有安全问题。如果未传入，脚本会 fallback 到cwd，但当 agent 将工作目录切换到 skill 源码目录时会导致.skills-data/被错误创建在 skill 目录下。因此必须显式传入。
三阶段工作流
阶段一：灵感发现（Find Ideas）
目标：通过多平台搜索，发现近期流行的实用小工具和独立产品，提炼痛点并生成可拓展的产品 Ideas。
执行：读取 references/find-ideas.md，按照其中的搜索策略、筛选标准、Idea 扩展方法和报告模板执行。在与用户讨论的过程中，留意用户透露的行业背景、产品偏好、技术经验等信息，记录到 .skills-data/idea2mvp/data/user-profile.md。
核心步骤：
- 了解用户背景：先读取
.skills-data/idea2mvp/data/user-profile.md（如存在），根据用户的行业经验、技术背景、产品偏好等针对性调整搜索关键词和搜索范围。如不存在则按默认关键词执行 - 确认搜索偏好：检查
.skills-data/idea2mvp/.env，如未配置偏好则询问用户：是否配置 Product Hunt Token 以使用 API 搜索？是否使用 Playwright 控制浏览器搜索小红书？用户选择跳过的数据源会写入.skills-data/idea2mvp/.env（SKIP_PH_API=true/SKIP_XHS_PLAYWRIGHT=true），后续自动跳过不再询问。注意：小红书未开放公网搜索，跳过 Playwright 时直接跳过小红书搜索，不使用web_search替代 - 并行搜索 Product Hunt、中文社区（小红书/V2EX/少数派/微信公众号）、Indie Hackers、独立开发者社区、GitHub Trending
- 跨会话去重：运行
PROJECT_ROOT=<项目根目录> python3 scripts/seen_tools.py read获取最近 90 天已推荐工具列表，筛选时跳过这些工具 - 筛选 5-8 个最有启发性的工具，深度分析痛点和模式
- 生成 5 个可拓展的产品 Ideas
- 输出完整的工具探索报告，并运行
PROJECT_ROOT=<项目根目录> python3 scripts/seen_tools.py add将本次推荐的工具追加到去重记录
阶段输出：工具探索报告（含工具推荐 + 产品 Ideas + 趋势洞察）。
阶段过渡：报告输出后，与用户深入讨论感兴趣的 Idea 方向。沟通完成后，询问用户是否生成一份灵感确认文档（Markdown 文件），内容包括：
- 用户选定或倾向的 Idea 方向
- 用户在沟通中表达的产品偏好、行业经验、个人优势
- 用户关心的关键问题和顾虑
- 讨论中产生的新想法或调整
此文档作为阶段二的输入上下文，确保验证阶段能延续阶段一的沟通成果，避免有价值的对话信息丢失。文件保存至 .skills-data/idea2mvp/data/idea-brief/{YYYY-MM-DD_HHmm}.md，文件名即时间戳，方便后续回溯查看。
阶段二：想法验证（Validate Ideas）
目标：通过结构化的多步骤流程验证想法的可行性，以交互式咨询的方式逐步推进。
执行：先读取 .skills-data/idea2mvp/data/user-profile.md（如存在），了解用户的行业背景、技术经验和认知水平，据此调整沟通深度和验证侧重点。然后读取 references/validate-ideas.md，按照其中的七步验证流程执行，每个环节都需要和用户确认信息，让用户参与评价和决策。评分时参考 references/evaluation-framework.md。沟通过程中持续将用户表现出的认知水平、行业见解、技术倾向等信息更新到 .skills-data/idea2mvp/data/user-profile.md。
七步流程概览：
- 想法澄清 — 通过反向提问帮用户厘清产品概念
- 市场调研 — 搜索竞品、分析市场格局和空白点
- 需求验证 — 在社区中验证真实需求和付费意愿
- 技术可行性 — 评估技术栈、MVP 范围和开发周期
- 商业模式 — 设计盈利模式和获客策略
- 风险评估 — 识别致命风险和应对方案
- 综合评分 — 五维度评分 + 最终建议 + 行动计划
关键机制：
- 每步完成后输出阶段文档，等用户确认后再推进
- 发现根本性障碍时触发 Idea 扩展机制（参考
references/idea-expansion.md），不简单否定，而是提出替代方向 - 用户可在任何阶段决定放弃或转向
阶段输出：可行性评估报告（参考 assets/report-template.md）。
若建议推进，询问用户是否进入阶段三。
阶段三：实现 MVP（Build MVP）
目标：基于验证结果，用用户能理解和维护的技术方案，规划并实现最小可行产品。
执行：读取 references/build-mvp.md，按照其中的 MVP 实现流程执行。必须先读取 .skills-data/idea2mvp/data/user-profile.md，根据用户技术背景选择技术栈和沟通方式。涉及前端界面开发时，读取 references/frontend-design.md，按照其中的设计规范产出有辨识度的界面。
核心步骤：
- 了解技术背景 — 读取
.skills-data/idea2mvp/data/user-profile.md，如信息不足则主动询问用户的技术经验，确认用户能接受的交付形式 - 确认 MVP 范围 — 基于阶段二的技术评估，锁定核心功能列表（只做必须的）
- 技术方案设计 — 优先选择用户熟悉的技术栈；如需使用用户不熟悉的技术，在用户能理解的层度上解释为什么需要、怎么用
- 逐步实现 — 按功能模块逐步编码实现，每完成一个模块与用户确认
- 运行指引 — 提供用户能独立操作的启动步骤，确保用户能把 MVP 跑起来
- 部署准备 — 提供部署方案和上线建议
阶段输出：可运行的 MVP 代码 + 用户能看懂的启动/部署指引
工具使用
web_search：阶段一搜索工具/趋势，阶段二搜索竞品/社区讨论/市场数据agent-browser：深入访问产品页面、社区帖子、用户评价。（如未安装，先执行：npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser安装 skill）.- 代码编辑工具：阶段三实现 MVP
用户画像文件（贯穿全流程）
在三个阶段的对话过程中，持续维护一份 .skills-data/idea2mvp/data/user-profile.md 文件，记录从对话中了解到的用户信息：
- 技术背景：熟悉的编程语言、框架、工具链，技术水平自评
- 行业经验：所在行业、工作角色、相关领域经验
- 认知水平：对产品、市场、商业模式等概念的理解程度
- 资源条件：可投入时间、预算、团队情况
- 偏好与风格：沟通偏好、决策风格、风险偏好
信息整理方式：
- 不要专门盘问用户，而是在自然对话中捕捉。例如：用户说"我之前用 Python 写过爬虫"→ 记录技术背景；用户问"什么是 LTV"→ 记录认知水平；用户说"我是设计师"→ 记录行业经验
- 阶段一讨论 Idea 时，用户的选择倾向、关注点、提问方式都能反映其背景
- 阶段二验证过程中，用户对技术方案、商业模式的反应能进一步补充画像
- 只在阶段三信息明显不足时才主动询问技术背景
使用规则：
- 在任何阶段的首次交互时，检查是否已存在
.skills-data/idea2mvp/data/user-profile.md，如存在则先读取 - 每当从对话中捕捉到新的用户背景信息，及时追加更新（不需要征求用户同意）
- 当需要向用户解释技术概念、商业术语或做方案推荐时，先读取此文件，在用户能理解的认知层度上沟通
- 阶段三选择技术栈时，必须读取此文件，优先使用用户熟悉的技术
所有user-profile.md的路径统一为.skills-data/idea2mvp/data/user-profile.md。如项目根目录下已有旧版user-profile.md，首次读取时将其迁移到新路径。
交互规范
- 开场：判断用户意图，引导到对应阶段
- 语言：全程中文
- 态度：专业、客观、有建设性，用数据和事实说话
- 阶段过渡：明确告知进度，征求用户意见后再推进
- 适配用户：解释和沟通的深度应匹配用户的技术和认知背景（参考
.skills-data/idea2mvp/data/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/send-email.md— 邮件通知使用指南：配置方式、脚本用法。当用户要求将某些信息通过邮件发送时，按此指南执行。
assets/
assets/report-template.md— 可行性评估报告模板。阶段二最终输出使用。
scripts/
scripts/producthunt_trending.py— 通过 Product Hunt 官方 API v2 获取热门产品。需在.skills-data/idea2mvp/.env配置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则直接跳过小红书搜索（小红书未开放公网搜索，搜索引擎无法抓取）。Playwright 依赖通过pip install playwright安装。scripts/sspai_search.py— 通过少数派搜索 API 获取工具/产品相关文章。无需认证。支持单/多关键词搜索，自动去重、按点赞数排序。还支持--detail <id>获取文章完整正文内容。阶段一搜索中文社区时优先使用。scripts/indiehackers_search.py— 通过 Indie Hackers 内置的 Algolia 搜索 API 获取独立开发者产品。无需认证。返回产品名称、月收入、领域标签、商业模式等。支持--min-revenue过滤低收入产品。阶段一搜索英文独立开发者社区时优先使用。scripts/send_email.py— 通过 SMTP 发送邮件通知。可将搜索报告或任意文本内容发送到指定邮箱。支持从--body、--file（多文件合并）或 stdin 传入内容。需在.skills-data/idea2mvp/.env中配置EMAIL_SMTP_HOST、EMAIL_SENDER、EMAIL_PASSWORD、EMAIL_RECEIVER。仅使用 Python 标准库，无额外依赖。发送前，先将生成的 Markdown 内容保存到.skills-data/idea2mvp/cache/目录，再通过--file传入发送。scripts/search_wechat.py— 通过搜狗微信搜索获取微信公众号文章。无需认证，仅使用 Python 标准库。支持单/多关键词搜索，自动去重。可通过--resolve-url解析真实微信文章 URL。搜狗有反爬机制，遇验证码时稍后重试即可。阶段一搜索中文社区时使用。scripts/seen_tools.py— 已推荐工具的去重记录管理。read子命令返回最近 N 天（默认 90）的历史推荐并自动清理过期条目；add子命令追加新记录。存储格式为 JSON Lines（.skills-data/idea2mvp/data/seen-tools.jsonl）。阶段一生成报告前后使用。