### [用AI写代码，真正卡住你的不是技术，是翻译层](https://dashen.wang/article/79)

**Published:** 2026-03-04T02:45:04

**Author:** 大神

**Excerpt:** 把模糊想法转成可执行需求：先用选择题梳理目标，再生成开发文档、接口约定和代码规范，讨论AI编程中常被忽略的翻译层。

打开 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](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](https://github.com/cat9999aaa/dev-planner-skill)

> 把下面的内容复制给你的AI编程软件，然后 开始你的第一个项目吧！

```text
阅读这篇文章。学习怎么使用并安装这个skill给我。
https://dashen.wang/article/8818.md
```

来源：[https://x.com/dashen\_wang/article/2029025303880974736](https://x.com/dashen_wang/article/2029025303880974736)

**Categories:** AI 实践

---