ARTICLE · 1299880
我把两套 AI 开源工具搬上了 GitHub小白也能看懂从「我有个想法」到发布一个 App
摘要：本文详细介绍刚开源的两套零依赖命令行工具——vague-to-product（把一句模糊想法挖成可验收的需求，并直接产出成品）和fuzzy-reverse-flow（事前推演「能不能做、要办什么证、最短多久能上线」）。全文包含功能清单、真实运行输出、小白十分钟上手路径，以及它们如何互相配合堵住「质量满分但合规翻车」的漏洞。 |
一、为什么做这两样东西
几乎所有「我想做个App / 小程序」的项目都死在同样的三个坑上：
1.需求没挖清就动手——做出来才发现用户要的不是这个，返工；
2.只做了「顺利态」——一切正常时很漂亮，断网、没数据、连点提交就露馅；
3.合规最后才发现——功能全做完了，提审时才知道缺证，一拖一两个月。
这两套工具就是冲着这三个坑来的。它们不做代码生成，而是做动手之前和交付之前的那两段最容易被跳过的工作：把模糊变清晰，把侥幸变checklist。
工具 | 一句话定位 | 解决什么 |
fuzzy-reverse-flow（rfe） | 模糊问题逆流程推理工具 | 假设目标已达成，反推合规红线、资源底线、致命风险、倒排里程碑；坑库越用越准 |
vague-to-product（v2p） | 模糊需求挖掘与产出生成器 | 把「我想做个XX」挖成可验收需求并直接产出成品；六道质量闸门 + 合规闸门 |
两个仓库都在GitHub 上，MIT 许可证，署名张勇鑫，纯 Python 标准库实现，零第三方依赖：
lhttps://github.com/zhangyongxin-1124/vague-to-product
lhttps://github.com/zhangyongxin-1124/fuzzy-reverse-flow
二、rfe：动手前先回答「这事能不能干」
rfe 的核心方法是逆流程推理：不问「我想做什么」，而是假设「这件事已经做成了」，然后往回倒推每一层硬性条件。
2.1 四步闭环
步骤 | 干什么 | 产出 |
① 目标锁定 | 把模糊目标改写成可判定的达成标准 | 目标卡 |
② 逆向排雷 | 六层反推：主体资质→备案许可→专项许可→内容合规→数据合规→资源底线 | 合规红线表+ 死亡点清单 |
③ 里程碑拆解 | 从交付日往回扣，每项资质的办理周期就是工期约束 | 倒排期任务书 |
④ 规则自演化 | 踩坑与验证过的经验写回知识库（先进待审区，人工确认才入库） | 坑卡+ 规则卡 |
2.2 知识库里有什么
目前内置105 条规则，覆盖 13 个领域（通用合规、软件与小程序、电商平台、招聘与人力、餐饮食品、内容传媒等），每条规则都带「如果…那么必须…」结构、法律依据、办理提前期和核实网址。另有一条「常见误传」清单，专门纠正诸如「小程序不用备案」「平台不碰钱就不用管税」这类流传很广的错误认知。
一条规则长这样（真实数据）：
[红线] RULE-ECOM-0001 电商平台/许可资质如果平台含多商户入驻并提供在线交易处理，那么必须同时持有ICP 经营许可证（B25）与 EDI 许可证（B21），仅有 ICP 备案不够。提前期：1-3 个月（省级通信管理局受理）依据：《电信业务分类目录》B21/B25；《互联网信息服务管理办法》 |
2.3 坑库：越用越准的关键
rfe 附带一个踩坑库，当前已回填 19 条真实项目踩坑。每条坑卡包含：现象、触发词、预防方案、降级方案。例如：
l「长列表页弹窗未锁滚动」→ 打开弹窗时锁 body 滚动并补滚动条宽度；
l「招聘类小程序提审才发现缺人力资源服务许可，上架延期一个月」→ 办证与开发并行启动，提审前先自查类目资质。
所有新沉淀先进待审区，人工approve 才转正入库——错误经验污染不了知识库。另有季度复核机制：知识库超过 90 天未复核，统计命令会亮黄灯提醒。
三、v2p：从一句模糊想法到可交付成品
3.1 四阶段流水线与动态深度
歧义捕捉→ 追问挖掘 → 需求定型 → 直接产出。最有特色的是动态深度：不是把所有问题都问一遍，而是按五个信号（影响半径、不可逆性、未知量、复杂度、复用性）打分，自动决定挖多深——
lD0：改个文件名、写个便签，直接做，不问；
lD2：要交给别人的小程序，3-5 轮追问，覆盖对象、质量、边界维度；
lD4：涉钱涉人涉数据的项目，不限轮次分批深挖。
3.2 一条命令的联合推演（v2.2.0 新增）
这是v2p 最值得说的能力。输入一条命令：
v2p plan -t "我想做一个社区团购小程序，团长开团邻居接龙下单" |
它在几秒内同时完成：判定形态与深度→ 生成第一轮挖掘问题 → 在后台静默调用rfe召回合规红线与历史坑预警→ 生成倒排里程碑。真实运行输出：
【联合推演】我想做一个社区团购小程序，团长开团邻居接龙下单形态：软件应用（app） 深度：D2（4/10）合规侧：召回红线10 条（全部阻断），其中资质提前期 10 条含工期约束坑预警：5 条历史坑命中 |
用户全程不需要知道rfe 的存在。两套工具的分工被严格定义为单向调用：v2p 是主人，rfe 只提供数据、不反向调用，但两者也都可以完全独立使用。
3.3 六道质量闸门 + 一道合规闸门
v2p 内置 65 项交付检查，按「完整态 / 交互 / 布局 / 数据 / 工程 / 可维护」六道闸门组织，强制覆盖空态、错误态、边界、并发、权限——专治「只做顺利态」的业余感。v2.2.0 又加了第0 道合规闸门：rfe 召回的红线直接注入核查卡，全部为阻断项——合规不满足，交付直接判不通过。
配套的还有三道「不放行」：
l手测不留痕不放行：手测清单必测五条（空态、错误态、返回丢状态、重复提交、极端量），每条必须填截图路径，校验缺一样就退出码1；
l沉淀不放行：交付收尾必须执行settle，把本次踩坑/经验写回待审区，没沉淀就标记交付会被直接拒绝；
l变更不重查不放行：需求一变，一条命令自动重跑合规推演——真实演示里，「要加会员付费」四个字立刻触发 3 条新红线，旧交付标记自动作废。
3.4 其他实用能力
l多产物交付包：支持App+文档+表格同时交付，深度自动取最大值加一，并生成功能/数字/品牌/口径/版本五类一致性对账清单——专治「BP 承诺的功能和原型对不上」；
l多项目隔离：不同项目的口味档案互不串数据；
l轻量可视化：一键生成深度雷达图和闸门分布图（SVG）；
l溯源与可复现打包：完整的PROVENANCE 来源声明 + 固定时间戳打包，两次构建 SHA256 完全一致；两套工具的自测套件合计 133 项断言全部通过。
四、小白十分钟上手
不需要会编程，会复制粘贴就够了。
第1 步：安装Python（python.org 下载，安装时勾选 Add python.exe to PATH）。
第2 步：从GitHub 下载两个仓库（Code → Download ZIP），解压到任意文件夹。
第3 步：打开命令行窗口（Win+R 输入 cmd），进入 vague-to-product 文件夹：
cd /d 你的解压路径\vague-to-product |
第4 步：说出你的想法（换成你自己的）：
python scripts\v2p.py plan -t "我想做一个小区邻居互相借东西的小程序" |
第5 步：打开生成的report.md，先回答第一轮 4 个问题——答不上来的那题，就是你还没想清的地方；再看合规红线表和倒排里程碑，最长的那项证照时间决定你最早哪天能上线。
第6 步：把需求交给AI 助手、外包或自己做出来，然后按核查卡逐项打勾、跑手测清单留截图、settle 沉淀经验、标记交付。
模糊评估场景（还没有需求，只想先看看能不能干）可以单独用rfe：
python ../fuzzy-reverse-flow/scripts/rfe.py recall -q "社区团购 预售" |
五、适用边界（诚实地说）
规则库是经验总结，每条都给了法律依据，但不构成法律意见；政策会变，知识库需要按季度复核，重要决策请咨询主管部门或专业人士；自动化检查只是必要条件，替代不了人工测试——所以工具把「手测留痕」做成了交付强制项，而不是假装扫描能发现一切；合规红线覆盖中国大陆监管环境为主，出海项目需要补充目标市场规则（欢迎通过 Issue 或 PR 补充规则卡，仓库里有规则卡模板与字段说明）。
六、写在最后
这两套工具的完整开发过程——包括需求逆向推演、开源查重、脱敏发布——本身就是用它们自己的方法论跑通的。仓库里每一份规则卡、坑卡都标注了来源与依据，欢迎审阅、引用和贡献。
仓库地址（求Star ⭐）
vague-to-product：https://github.com/zhangyongxin-1124/vague-to-product
fuzzy-reverse-flow：https://github.com/zhangyongxin-1124/fuzzy-reverse-flow
