AI编程神器spec-kit保姆级教程:从0到1,让你的代码不再跑偏

666 阅读6分钟

我是小虎,浙江大学计算机本硕,专注AI编程 + AI教育。

AI****写代码,最怕的不是它不会,而是它自作主张,一路狂飙到沟里。

Hello,大家好,我是小虎。

昨天发了篇关于spec-kit的文章,我的AI编程学习群里一下子就热闹起来了。🚀

[CodeBuddy配套:如何配置AI编程总工程师spec-kit]

有位做系统架构师的学员还特地私聊我,说他之前后端代码自己写,前端都靠外包。现在有了AI,心思活络了,想自己把前端也给包了,毕竟自己做的项目,可控性高。

他看到我介绍的spec-kit,很激动,但感觉还没完全明白怎么上手。

行!那今天,我就拿一个我自己正准备开发的小项目当例子,给大家掰开揉碎了,讲清楚这个 spec-kit 到底该怎么玩。

我的小痛点:文章分发的重复劳动

大家都知道,我的主战场在公众号,但为了让更多朋友看到,我写的文章还会同步到某乎、小某书等7个平台。

虽然只是复制粘贴,但架不住平台多啊,每个平台点点点,配图、调整格式,一套下来也得20多分钟。

这种高度重复、没啥技术含量的活,简直就是为AI量身定做的!

以前得找各种效率工具,现在咱自己就是开发者,直接撸一个!💪

开干!三步让AI为我写代码

提醒一下:因为CodeBuddy插件暂时还不支持/specify命令,所以我这次用的是claudeCode CLI这个命令行应用来演示。

第一步:初始化项目环境

首先,我得给这个项目安个家。

我建了个目录叫 1002ArticlePost,然后在命令行工具(我用的是PowerShell)里进入这个目录,敲下这行命令:

specify init .

回车后,AI就开始“哐哐”一顿操作,很快,你会看到目录里多了两个新文件夹:.claude.specify

为了方便查看,我用VSCode打开了目录。.specify 文件夹里有三个子目录:

  • memory: 里面有个 constitution.md,这是整个项目的最高宪章,规定了AI写代码的规则。英文很多,看不懂没关系,咱们先不用管它。
  • scripts: 存放了一些脚本文件。
  • templates: 存放了spec(规格)、plan(计划)、tasks(任务)的模板。

记住,现在这些文件和目录,我们一个字都不用改!知道有它们就行。✅

第二步:用“人话”给AI下指令

环境搭好了,接下来就是最关键的一步:告诉AI你想做什么。

在刚才的命令行里,输入 claude,回车,就进入了claudeCode的交互界面。

在这个界面里,我们输入斜杠 /,就会看到很多命令,我们选择 /specify

看到上图,表明claude支持specify了,别直接用。

然后,就在后面跟上我们详细的需求。这就是所谓的“提示词”,你描述得越清楚,AI干活就越到位。

看我是怎么写的:👇

/specify 做个单一的网页,把其他地方的文章(包含图片和文字),能复制粘贴到这个网页里,图文顺序不变,还能编辑,另外能通过chrome devtools MCP扫码或者快捷登录等方式登录某乎平台,能通过chrome devtools MCP知道某乎平台发布文章的必选项和可选项,能手工在网页输入这些参数,能记住这些参数,能通过chrome devtools MCP自动一键登录、一键提交文章,只要做最小mvp,保证上述功能可用

看,我没写一行代码语言吧?全都是大白话,就像跟一个产品经理提需求一样。

第三步:AI的自动化“三部曲”

指令下达后,AI就开始它的表演了。整个过程分为三步:spec -> plan -> tasks -> implement

  1. 生成规格 ( spec )

AI首先会在项目里新建一个specs目录,并在里面生成一个 spec.md 文件。

这个文件,就是AI根据我刚才那段“人话”梳理出来的详细功能规格说明书。

这时候,先不着急进行下一步!点开 spec.md 文件,仔细看看AI理解的对不对。

如果发现有偏差或者遗漏,你完全可以用自然语言继续和它对话,让它修改这个文件,直到你满意为止。

  1. 制订计划 (plan)

我检查了一下,觉得AI理解得八九不离十,就直接在命令行里输入 /plan,让它开始制订开发计划。

这一步会非常详细,AI会把整个开发过程分解成好几个阶段,比如研究阶段、设计阶段、前端开发、后端逻辑等等,俨然一个项目经理附体。🧐

  1. 分解任务 & 开始执行 (tasks & implement)

计划有了,下一步就是把计划分解成可以执行的具体任务。

不用检查计划,直接输入 /tasks

AI“刷刷刷”地给我列出了10个阶段,总共46个具体的开发任务。

任务列表也出来了,同样不做检查,直接开干!输入终极命令:/implement

AI就开始一行一行地敲代码了。这个过程你什么都不用做,喝杯茶静静看它表演就行。🤖

最后,AI提示我,10个阶段它先完成了3个,主要是前端界面的部分,让我可以先看看效果,再决定是否继续。

我打开它生成的页面,效果是这样的:

虽然还很简陋,但一个文章编辑器的架子已经出来了!

左边是编辑器,右边是登录和发布的区域,完全符合我的初步设想。🎉

因为后面还有7个阶段没开发,登录、发布这些核心功能暂时还不能用,这里也就不多展示了。

但从这个流程走下来,spec-kit的用法是不是已经非常清晰了?

specify -> plan -> tasks -> implement,你只需要在第一步用大白话说清楚需求,并在中间环节进行确认和微调,一个软件的雏形就诞生了。

纸上得来终觉浅,不如自己上手练一练。如果你在操作过程中遇到任何问题,欢迎加入我的学习群,我们一起交流进步。


Hey,大家好!我是小虎,浙江大学计算机本硕,专注AI编程 + AI教育。

每天2条朋友圈,分享AI编程干货。(很多不方便公开讲的都在朋友圈里)