)
看完你能带走:3 条万能提问公式、10 个立刻能用的提效技巧、5 个大多数人都会踩的坑。全文干货,建议先收藏再看。 先说结论:大部分人的 AI 编程,一开始就用错了我观察身边同事用 AI 编程助手,80% 的人是这么用的:“帮我看看这个报错”“这个代码什么意思”“写一个 xxx 功能”然后得到一个平庸的回答,感慨一句AI 也就这样。问题不在工具,在用法。AI 编程助手不是搜索引擎,它更像一位坐在你旁边、随叫随到的程序员搭档——你负责说清目标,它负责动手干活。你交代任务的水平,直接决定它的输出水平。我最近把日常工作大量迁到了 ZCode(智谱推出的 AI 编程助手,对话式操作,能读写代码、跑命令、查资料),沉淀了一批心得。这篇把这些经验整理成体系,公式和模板全部可以直接照抄。 60 秒认识 ZCode如果你还没接触过,先用一句话建立认知:ZCode 住在你电脑里的 AI 程序员搭档。你用日常语言下达任务,它读写你的项目文件、执行终端命令、联网查资料,每一步实际操作前都会请求你的许可。它和普通 AI 聊天工具的本质区别是三个字:能动手。普通 AI:给你代码,你自己复制粘贴、自己调试;ZCode:直接在你的项目里定位问题 → 给出方案 → 经你确认 → 动手修改 → 跑测试验证 → 汇报改了哪些文件。理解了搭档这个定位,下面的技巧才好消化。 3 分钟上手:从安装到第一次对话通过官方渠道下载安装包,像普通桌面软件一样下一步装完;打开 ZCode,按提示完成登录、选择模型服务;选择一个文件夹作为工作区——它就是 ZCode 的施工现场:想让 AI 处理哪个项目,就打开哪个文件夹。然后直接说人话开始第一次对话,比如:“这个文件夹里有什么?帮我大致介绍一下。” 试试看,你会回来继续往下读的。 核心心法:三条黄金提问公式80% 的AI 不好用,都是提问姿势不对。这 3 条公式加上后面的 10 个技巧,正是标题里说的 13 个用法——覆盖了我 90% 的日常场景,建议直接背下来:公式一:修 Bug(最高频)运行【某个功能】时报错,完整报错信息是【贴全】, 帮我找到原因并修复,改完列出修改的文件。⚠️ 关键动作:把完整报错贴全,不要只截半句。报错信息从第一行到最后一行是一个整体,截半句等于让医生看半张化验单。公式二:加功能在【某模块】里加一个【某功能】,参考【某现有代码】的写法, 先给方案再动手。⚠️ 关键动作:“先给方案再动手”这七个字,能帮你拦掉 80% 的跑偏。方案确认了再放行,比自己事后回滚便宜太多。公式三:求解释解释一下【某文件/某函数】是干什么的,用通俗的话。适合接手别人的项目、读祖传代码。别不好意思问基础问题,AI 没有自尊心。⚡ 10 个提效技巧(按上手难度排序)1. 用好权限弹窗,别当无脑允许党ZCode 每次写文件、跑命令前都会请求许可。新手觉得烦,老手当保险:允许一次:只批当前操作,新手默认选这个;本会话内总是允许:确认任务可信后选,减少打扰;拒绝:看不懂它要干嘛?先拒绝再追问这条命令是做什么的。️ 踩坑点:来路不明的项目不要随便打开——项目配置里声明的扩展工具会被自动加载。2. 第一件事:生成项目说明书(AGENTS.md)每次新开会话,AI 对你的项目一无所知。在 ZCode 里输入/init,它会自动阅读项目结构,生成一份AGENTS.md项目须知,以后每次对话自动生效——相当于给新同事的交接文档。强烈建议手动补充四块内容:## 技术栈 - 前端:Vue 3 Vite - 后端:Python FastAPI ## 规范约定 - 注释和提交信息用中文 - 每次提交前跑一遍 pytest ## 禁区 - config/legacy/* 只读,不许改有了它,你不用每次对话都重复我们用的是 Vue3“注释要写中文”,一劳永逸。3. 大任务,先进计划模式要改 3 个以上文件的任务,直接开写容易翻车。在请求里加一句:“先给我实现方案,确认后再动手。”它会只读代码、只出方案、不改一行,等你拍板后再按计划执行。这个习惯是AI 编程不翻车的最大保险。4. 让它列任务清单,随时掌握进度多步骤任务开始时,要求一句:“先列个任务清单再开始。” 它会把工作拆成带勾选的清单,完成一项勾一项。想知道进度,随时问现在到哪一步了。5. 耗时操作,丢到后台跑装依赖、跑全量测试、启动开发服务器——这类几分钟的活,一句放到后台运行,它不阻塞对话,跑完通知你。等待时间拿来干别的,这才是并行的快乐。6. 每次满意的修改,让它自己复述一遍列出这次改动的所有文件,以及每一处改动的原因。这个动作只要 10 秒,能帮你发现它顺手改了不该改的东西。AI 也会好心办坏事,核对清单是对双方的保护。7. 版本管理是保底手段再聪明的助手也可能改错方向。重要项目动手前先提交一次 Git,任何时刻可整体回退。不会 Git?直接说帮我用 Git 提交这次的改动,写清楚提交说明。8. 常用 MCP,给 AI 外接USB 设备MCP 是个开放协议,作用类似电脑的 USB 口:接入数据库、浏览器、内部系统等外部工具后,ZCode 就能直接操作它们。接入后直接用自然语言指挥:“用刚接入的数据库工具查一下 xxx 表”。⚠️ 安全提醒:MCP 以你的身份访问数据,密钥走环境变量,绝不写进会提交的文件。9. 重复性工作,交给定时任务每天早上的数据汇总、每周的报告,在对话里直接说:“每天早上九点,帮我做一次 xxx,结果保存到 xxx。” 到点自动执行,做一个甩手掌柜。10. 把调教成果沉淀下来每次你纠正 AI(比如说过了注释用中文),值得把这条规则写进AGENTS.md。纠正一次、沉淀一条,一个月后你会得到一个完全贴合团队习惯的定制助手——这比换工具管用得多。️ 5 个高频踩坑(我全踩过)坑 1:配置改了不生效先自检三连:位置对吗(用户级~/.zcode/还是项目内.zcode/)?被覆盖了吗(同名配置先到先得)?开关开了吗(配置文件里的 Hooks 必须设hooks.enabled: true才生效)?坑 2:对话越长,它越变笨超长对话会稀释重点。开新会话前,让它把当前进展整理成一段笔记,带着笔记轻装上阵。坑 3:一句话把大任务全压给它“帮我做一个电商网站”——这种任务它只能给你一个平庸的脚手架。正确姿势是拆:先要架构方案 → 确认 → 逐个模块实现 → 逐个验证。AI 时代的核心竞争力,是拆解任务的能力。坑 4:敏感信息直接贴进对话密钥、密码、生产库连接串,永远不要出现在对话里。用环境变量管理,让 AI 通过环境变量名引用。坑 5:对输出全盘信任AI 的代码能跑 ≠ 代码正确。让 AI 自证三件套:跑测试、列改动清单、解释实现思路。三者齐全再合入。❓ 快问快答Q:必须会编程才能用吗?不需要。它支持用日常语言交互,非程序员也能用它整理数据、生成文档、做自动化脚本。Q:它会乱改我的文件吗?不会乱改——所有写入操作都要你批准。真正的风险是你批准了但没看,所以养成看改动清单的习惯。Q:和网页版 AI 聊天有什么区别?核心区别是能不能动手:它直接操作你的项目文件和终端,闭环完成任务;网页版只输出文字,动手的还是你。Q:团队规范怎么让它遵守?写进项目根目录的AGENTS.md,随代码一起提交,全队共享同一套调教成果。 写在最后AI 编程助手的能力上限,正在快速逼近你说不清楚的事,它就做不好这个瓶颈。工具在变强,但说清目标、拆解任务、验收结果这三项能力,永远是你自己的。ZCode 把重复劳动接走了,把判断和决策留给了你——这才是它正确的打开方式。️ 声明:本文为个人使用经验总结,属第三方独立教程,非 ZCode 官方文档;ZCode名称及相关商标归其权利人所有;软件功能以实际版本为准。 你在用 AI 编程助手时踩过什么坑?评论区聊聊。觉得有用的话,点赞收藏,下篇写「用 MCP 给 AI 接上数据库和浏览器」的实战。
