用AI写代码,真正卡住你的不是技术,是翻译层

打开 Claude Code,对话框空空的。光标在闪。你盯着它,想了半天,打了一句话,AI 回了一大堆看不懂的东西,然后就关掉了。这不是 AI 不够聪明。现在的 AI 已经很强了,Claude、GPT随便一个,让它给你写一个完整的 Web 应用,它能写。问题出在起点。你不知道该告...

文章

No.015 / 深度文章 / 发布于 2026.03.04

用AI写代码,真正卡住你的不是技术,是翻译层

打开 Claude Code,对话框空空的。光标在闪。你盯着它,想了半天,打了一句话,AI 回了一大堆看不懂的东西,然后就关掉了。这不是 AI 不够聪明。现在的 AI 已经很强了,Claude、GPT随便一个,让它给你写一个完整的 Web 应用,它能写。问题出在起点。你不知道该告...

查看 X 原帖 ↗

图像

打开 Claude Code,对话框空空的。

光标在闪。

你盯着它,想了半天,打了一句话,AI 回了一大堆看不懂的东西,然后就关掉了。

这不是 AI 不够聪明。

现在的 AI 已经很强了,Claude、GPT随便一个,让它给你写一个完整的 Web 应用,它能写。

问题出在起点。

你不知道该告诉它什么,它不知道你到底想要什么,于是双方鸡同鸭讲,什么也做不成。

有很多人想用 AI 做点东西。

他们有想法,有热情,甚至有很具体的需求。

然后他们就卡住了。

不是因为没钱,不是因为没时间,是因为不知道怎么开口。他们不知道应该跟 AI 说什么,不知道 AI 能不能做这件事,也不知道做出来之后自己能不能看懂、能不能维护。

这是真正的门槛。

技术门槛被压得很低了,但认知门槛还在。

PS:文末有一键配置,如果你觉得很难,放心大胆的交给你的AI开发软件吧!

dev-planner-skill 是什么

简单说,这是给 AI 装的一个技能文件。

把它装进你使用的 AI 编程工具,AI 的行为就会发生变化。

当你跟它说"我想做个东西"的时候,它不会直接开始写代码。

它会先跟你聊,通过一系列选择题,把你脑子里那个模糊的想法,变成一份清清楚楚的开发计划。

整个流程分五个阶段。

五个阶段是什么

第一阶段:对话收集需求

AI 会问你一系列问题,都是选择题,选项都是大白话。

项目是网站还是 App?功能需不需要登录?想要什么风格?部署在哪里?

每道题都有"让 AI 帮我决定"这个选项。

你可以全程什么都不懂,照样完成规划。

第二阶段:生成开发文档

确认规划之后,AI 会自动生成三份文档。

开发文档(含架构图、数据库设计、流程图)、API 接口文档(含请求/响应示例)、代码规范文档(含命名规范、目录结构)。

这三份文档是后续所有开发的"宪法",AI 必须严格按照它们来写代码。

第三阶段:检测工具链

AI 会扫描你的环境里有哪些可用的工具。

GitHub 接口、数据库连接、Docker、网络搜索等,能用的都用上,不依赖任何一个工具,用不了就换方案。

第四阶段:编排 Agent 团队开发

这是最酷的部分。

AI 会把自己分裂成几个"子 Agent":后端工程师、前端工程师、测试工程师、文档工程师。

各自负责自己的部分,能并行推进,每个节点完成都要自我测试,测试通过才能提交代码。

第五阶段:交付报告和使用手册

全部做完之后,AI 会输出一份最终报告。

包含完整的项目结构、代码提交历史,以及三个版本的使用说明——技术人员版、普通用户版、手把手部署教程版。

新手怎么用

很多人看到"安装技能文件"就已经犹豫了。

第一步:选一个 AI 编程工具。如果你什么都没装,我推荐从 Claude Code 开始。

第二步:安装技能文件

如果你用 Claude Code:

打开终端,把下面这行命令复制粘贴进去,回车:

curl -L https://raw.githubusercontent.com/cat9999aaa/dev-planner-skill/main/SKILL.md -o CLAUDE.md

这行命令会把技能文件下载到当前目录,命名为 CLAUDE.md。Claude Code 启动时会自动读取这个文件,技能就生效了。

第三步:直接开口说你想做什么

不需要想太多,就像跟朋友说话一样,把你脑子里的想法说出来就行。

比如:

"我想做一个帮我管理读书笔记的网站" "帮我做个微信机器人,能自动回复关键词" "我想爬取京东上某个商品的价格变动,做成图表"

第四步:回答选择题,完善规划

AI 会开始问你问题,全部都是选择题,大概八轮左右。

每道题都有"让 AI 帮我决定"。

如果你完全不懂,每题选这个就行,AI 会根据你的项目类型做出合理推荐。

第五步:确认规划,生成文档

回答完所有问题,AI 会给你一份完整的规划总结。

包括技术栈、功能模块、开发节点明细。

你确认没问题,回复"确认",AI 就开始生成三份开发文档。

文档生成之后,你可以看看,也可以直接回复"开始开发"让 AI 开干。

第六步:等待,偶尔回答问题

AI 开始开发之后,大部分时间不需要你做任何事。

它会一个节点一个节点地往前推进,每个节点完成都会告诉你:完成了什么、生成了哪些文件、测试是否通过。

遇到真正需要你决策的问题——比如你的付款 API 密钥是什么、某个功能你到底要不要——它会停下来问你。

除此之外,放着让它跑就好。

实际使用中的关键经验

第一,需求描述越具体,结果越好。

"我想做个网站"和"我想做一个给我的读书俱乐部用的网站,成员可以记录自己读过的书、写评分和笔记,管理员能看到所有人的动态"——这两句话触发的规划质量天差地别。

不需要懂技术,但你得想清楚:这个东西给谁用,用来干什么,最核心的功能是什么。

想得越具体,AI 在对话阶段需要问的问题就越少,规划出来的东西也越符合你的预期。

第二,规划阶段多花时间,开发阶段省很多麻烦。

很多人想快,规划刷刷过了就让 AI 开始开发。这是最容易踩的坑。

规划是整个流程的地基。规划阶段没有确定清楚的东西,到了开发阶段会变成一个个"这个要改"、"那个不对"。

而每次返工,AI 都要重新理解上下文,成本是指数级增长的。

我建议在规划确认之前,认真检查几件事:功能列表里有没有漏掉你真正需要的功能、技术方案有没有你不满意的地方、开发节点的顺序是否合理。

第三,文档是你最重要的资产,不要跳过它。

很多人对"生成开发文档"这一步无感,觉得自己又不是团队开发,要什么文档。

这个想法是错的。

文档不是给团队看的,是给未来的你和 AI 看的。三个月后你想修改这个项目,如果没有文档,AI 需要从头理解整个项目——这会花掉大量时间,而且容易出错。

有了文档,AI 可以直接对照文档做精确修改,效率完全不一样。

更重要的是,文档是约束 AI 的"宪法"。这个 Skill 设计的一个核心约束是:AI 必须严格按照已生成的文档开发,不能擅自更改技术栈,不能跳过测试。这个约束只有在文档存在的前提下才能生效。

第四,遇到错误不要慌,让 AI 自己处理。

开发过程中一定会遇到错误。这是正常的,不是你的问题,也不是 AI 的问题,是软件开发本来就会有这些。

这个 Skill 的设计原则是:遇到问题必须记录、必须解决,不能跳过,不能掩盖。所以当你看到 AI 说"遇到了一个问题,正在处理"——这是好事,说明它在认真工作,不是在糊弄你。

你不需要懂那个错误是什么意思。等它处理完就好。如果它问你某个具体的问题(比如某个配置的密钥),你提供信息就行。

第五,部署这一步可以单独处理。

很多新手做出来之后卡在"怎么让别人也能访问"这一步。

dev-planner 最后会生成一份手把手的部署教程,但部署涉及到服务器、域名、HTTPS 这些东西,有一定门槛。

我建议:

如果是个人工具、只有自己用,先在本地跑,不用急着部署。

如果是前端项目(纯网页),用 Vercel,免费,三分钟搞定。

如果有后端和数据库,可以考虑 Railway 或者国内的轻量级云服务器。

这个工具能做什么,不能做什么

能做的:各种规模的 Web 应用、自动化脚本、API 服务、Telegram/Discord Bot、桌面工具、接入 AI 大模型的应用。

不太适合的:游戏、iOS/Android 原生 App、特别依赖硬件的嵌入式系统、对性能有极端要求的底层系统。

最后说一句

软件开发在过去是一件需要专业门槛才能入场的事。

你要学编程语言,要懂数据库,要理解网络协议,要会用版本管理工具——每一项都是单独的知识体系,光是把这些东西都学会就要好几年。

现在不一样了。

AI 把这个门槛压低了很多,但没有压到底。

还差一截。

差在哪里?差在普通人和 AI 之间缺少一个"翻译层"——一个能把人话变成 AI 能精确理解的需求的东西。

dev-planner-skill 想做的就是这个翻译层。

技能包地址:https://github.com/cat9999aaa/dev-planner-skill

把下面的内容复制给你的AI编程软件,然后 开始你的第一个项目吧!
阅读这篇文章。学习怎么使用并安装这个skill给我。
https://dashen.wang/article/8818.md

来源与更新

  1. X 原帖