on
一天实现个人博客
纯 Cursor vibe 的 Flutter 博客(限时一天内),可点击 daweibayu.top 查看 web 版。
- 因为是纯 MVP,外加时间限制(一天内),所以各种细节经不起考究;
- Flutter Web 目前还很有局限性,这里纯粹是为了个人学习;
- 移动端可以正常运行,等稳定后我再 release 吧。
前言
当前的博客 daweibayu.fun,使用的是 tale。本来自己就是工程师,所以一直想自己写一个,后边断断续续也尝试过,一直没有完整版出来。再后来就 AI 了,也断断续续尝试 vibe 一个,也一直没有跑顺整个流程。前段时间继续尝试 spec-kit,陷入各种细节处理导致需要时间太长所以也没跑通,但期间收获颇多。
前几天刚从非洲滚回来,就想着不完全套用 spec-kit,仅取其设计思路,然后尝试一下,发现异常的顺利,所以就有了 github - yuBlog1Day 这个项目。
(个人)最佳实践
先说结论,最重要的是如下三部分,必不可少:
- 架构文档
- cursor rules(规范文档类)
- roadmap
小项目三个文件就行,但如果是商业项目,三个部分需要各自再做细拆。最核心的肯定还是架构文档,只有合理的架构,才有可落地性。以当前项目为例,这三部分的时间配比大概为 8:1:1,而文档性的工作与真实编码的时间配比大概为 8:2。
架构文档
含两部分,业务架构文档与技术架构文档。这部分内容不应该包含具体的业务细节,保证架构文档的“架构性”。
但是在每个大任务的完成后,需要同步更新架构文档,保证过程反哺架构,形成闭环。
roadmap
根据业务迭代内容与现有架构生成的 roadmap。 如果是小项目或练手项目(类似当前工程),一个 markdown 就可以了,不要使用多文件,不然会像 spec-kit 一样,很重。 但如果是商业项目,则需要细化,叠加多人协作,此文件夹则需要按照迭代(或功能)为二级目录,其下才是具体的具体功能 roadmap。
规范文档
- cursor rules
- git 分支规范(含访问控制)
- commit 规范
- (自动)生成文档规范
- 工程目录规范(比如 Docs、scripts 等文件夹)
所有规范类的文档都可以存放此文件夹
将来
从 copilot 到 chatgpt,再到目前的 Cursor,使用 AI 已经两年的时间了,都是使用 AI 完成一个局部的功能或 bug fix 等,直到最近,才完成了第一个(较完整的)纯 vibe 项目。深刻的感受到时代已经变了,整个 AI 的崛起是生产力层面的变革,其对生产关系等的变革要远超人们的想象,现在其实还是在起步阶段。后续人机的交互更多会从代码转为文档,这会把编程的入门门槛降到很低的水准,这也可以看作是一轮技术平权运动。一方面,降低编程从业人员的门槛,另一方面,也释放了人们的想象力,使更多的普通人可以通过 AI 编程得到自己想要的工具。
可以预见:
- 纯编程会变成类似满清遗老遗少的工种;
- 最近这几年的“软件”会比之前极大的丰富,这是供给端的改革,消费端会变得越来越珍贵;
- RD、PM、QA、UI 等之间的隔阂会越来越小,前互联网时代的工种划分会被重构;
- 目前可以预见的是人机交互会从代码转为文档,所以之前针对代码的各种迭代与规范会逐步过渡给文档,整体的协作流会被重构;
- 不同工种间的协作会按照模块、功能等被划分,而不是目前的技术栈,即由横向变为纵向(类似到业务群的升级);
大的时代已经来临,只能迎面而上。