乐于分享
好东西不私藏

开源,开源,融合多个AI工具的AI规范化编程项目发布了!!

开源,开源,融合多个AI工具的AI规范化编程项目发布了!!

假期发了一个宣传,网友一直在催,赶紧整理发出来,不多说先放地址,希望各位大佬勿喷,给个⭐
项目地址:github.com/rihebty/flow-kit


上篇说了 flow-kit 是什么、怎么来的。这篇补几个我自己用着觉得缺了的点。

清窗这件事

AI 对话长了会打转,这个大家都知道。但光”新开个窗口”没用——新会话的 AI 不知道之前试过什么,大概率重走一遍刚失败的路。

flow-kit 的做法:打转了就清窗,清窗前必须写一份 PROGRESS.md,里面有个段叫”已排除方案”。新会话恢复之后第一件事就是读这个段,如果接下来要试的路子跟已排除的一样,得先解释”这次有什么不同”,说不出来就不许动手。

另外,如果一个任务做到一半就撑不下去要清窗,说明任务本身拆得太大了。恢复之后先拆小再干,不硬续。


失败知识库

项目跑久了总有些坑会反复踩。我有段时间隔三差五就忘记给 Prisma 写迁移文件,每次都是集成阶段才炸。

LESSONS.md 就是存这种教训的。每次 change 归档的时候,AI 会把这轮里踩过的有代表性的坑提名进去。之后每个任务开工前,AI 得先拿当前任务的关键词 grep 一遍这个文件。命中了就得在计划里写清楚”看过了,这次怎么避”。

不复杂,但确实管用。


架构知识往哪放

做了十几个 change 之后有个问题:第三个 change 引入了 Redis,第七个加了消息队列,第十二个拆了模块——这些决策分散在各自的 DESIGN.md 里,半年后谁翻?

flow-kit 分了三层:CONTEXT.md 记规则(技术栈、命名约定、禁用清单),ARCHITECTURE.md 记结构(模块图、依赖规则、ADR),DESIGN.md 记单次变更。

每个 DESIGN.md 里有一段叫”架构沉淀建议”,记了这次 change 对项目级的影响。攒几个 change 之后跑一次 A-evolve,它会把这些沉淀拎出来让你挑,你批准的才写进 CONTEXT 和 ARCHITECTURE。AI 不能自己偷偷改项目级文档。

小项目不用管 ARCHITECTURE 那层,CONTEXT.md 够用。


主流程之外的几个命令

除了 0-7 这条主线,还有几个按需用的:

M-health——给代码库做体检。跑一遍出个健康分,顺带扫重复代码块、没人用的导出和依赖(调 jscpd / knip / vulture 这些工具,没装也有个 grep 兜底)。严重的直接开修复任务,中等的记进技术债清单。

L-restyle——项目视觉想换个风格但功能不动。它会识别当前调性,引导你选新的,生成改造计划。

A-architect——首次建架构文档或者大重构时用。

这些都是 @flow-kit/GO.md 加一句话触发,不用记命令名。


两条硬规则

RULES.md 里规则不少,大部分一看就懂。有两条我觉得值得提:

一条是改数据库 schema 必须同一个 commit 里带迁移文件。AI 很爱只改 model 不写 migration,本地能跑但生产必炸。加了这条之后这个问题再没出现过。

另一条是删代码有门槛。AI 觉得”没人用”就想删,但动态 import、反射、mock 这些它看不到。flow-kit 要求删 ≥ 5 行代码或者改公共 API 之前,先 grep 全库列出所有调用点给你看,你说删才能删。


小项目也能用

8 步全走对小东西来说太重了。flow-kit 有个 MVP 模式:需求 → 任务 → 开发,三步完事,产物就三个文件。成本大概是完整模式的三分之一。觉得靠谱了再切完整版。


项目地址:github.com/rihebty/flow-kit

欢迎各位大佬完善!!!。上篇可以看一下↓

每个ide都可以使用!!我融合了superpowers、OpenSpec、spec-kit、GSD、gstack、claude-task-master写一套可控Ai开发规范流程