本 skill 覆盖产品从 0 到 1 的完整流程：发现灵感 → 验证想法 → 实现 MVP。全程使用中文输出。
用户可以从任意阶段切入：
本 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 目录下。因此必须显式传入。
目标：通过多平台搜索，发现近期流行的实用小工具和独立产品，提炼痛点并生成可拓展的产品 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 替代PROJECT_ROOT=<项目根目录> python3 scripts/seen_tools.py read 获取最近 90 天已推荐工具列表，筛选时跳过这些工具PROJECT_ROOT=<项目根目录> python3 scripts/seen_tools.py add 将本次推荐的工具追加到去重记录阶段输出：工具探索报告（含工具推荐 + 产品 Ideas + 趋势洞察）。
阶段过渡：报告输出后，与用户深入讨论感兴趣的 Idea 方向。沟通完成后，询问用户是否生成一份灵感确认文档（Markdown 文件），内容包括：
此文档作为阶段二的输入上下文，确保验证阶段能延续阶段一的沟通成果，避免有价值的对话信息丢失。文件保存至 .skills-data/idea2mvp/data/idea-brief/{YYYY-MM-DD_HHmm}.md，文件名即时间戳，方便后续回溯查看。
目标：通过结构化的多步骤流程验证想法的可行性，以交互式咨询的方式逐步推进。
执行：先读取 .skills-data/idea2mvp/data/user-profile.md（如存在），了解用户的行业背景、技术经验和认知水平，据此调整沟通深度和验证侧重点。然后读取 references/validate-ideas.md，按照其中的七步验证流程执行，每个环节都需要和用户确认信息，让用户参与评价和决策。评分时参考 references/evaluation-framework.md。沟通过程中持续将用户表现出的认知水平、行业见解、技术倾向等信息更新到 .skills-data/idea2mvp/data/user-profile.md。
七步流程概览：
关键机制：
references/idea-expansion.md），不简单否定，而是提出替代方向阶段输出：可行性评估报告（参考 assets/report-template.md）。
若建议推进，询问用户是否进入阶段三。
目标：基于验证结果，用用户能理解和维护的技术方案，规划并实现最小可行产品。
执行：读取 references/build-mvp.md，按照其中的 MVP 实现流程执行。必须先读取 .skills-data/idea2mvp/data/user-profile.md，根据用户技术背景选择技术栈和沟通方式。涉及前端界面开发时，读取 references/frontend-design.md，按照其中的设计规范产出有辨识度的界面。
核心步骤：
.skills-data/idea2mvp/data/user-profile.md，如信息不足则主动询问用户的技术经验，确认用户能接受的交付形式阶段输出：可运行的 MVP 代码 + 用户能看懂的启动/部署指引
web_search：阶段一搜索工具/趋势，阶段二搜索竞品/社区讨论/市场数据agent-browser：深入访问产品页面、社区帖子、用户评价。（如未安装，先执行：npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser 安装 skill）.在三个阶段的对话过程中，持续维护一份 .skills-data/idea2mvp/data/user-profile.md 文件，记录从对话中了解到的用户信息：
信息采集方式：
使用规则：
.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）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/report-template.md — 可行性评估报告模板。阶段二最终输出使用。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 获取文章完整正文内容。阶段一搜索中文社区时优先使用。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）。阶段一生成报告前后使用。共 4 个版本