guideme: 用AI指引代码修改,而非直接生成

guideme: 用AI指引代码修改,而非直接生成

Sophia Bennett
28
original

一位资深开发者分享了如何用自制的AI技能guideme来辅助手写代码。guideme不生成补丁,而是输出代码修改指引,帮助高级工程师聚焦架构问题。文章探讨了AI编程中“最短路径”偏好的弊端,以及如何通过人机协作写出更稳健的代码。

过去两年,AI 编程助手从“玩具”变成了许多团队的标配。自动补全、生成函数、甚至整段模块,都能在几秒内完成。但在代码生成越来越廉价的今天,一位资深工程师的自白式文章,给出了不同的观察:他仍然坚持手写核心代码,并且找到一种方式让 AI 帮忙,而不是代劳。

AI 的“最短路径”偏好

作者从大量“vibecoding”项目中总结出一个规律:AI 几乎总是更愿意新增代码,而不是重构现有代码。这种方式虽然能避免“AI 把我的代码库清空”这类极端事故,却带来另一个隐患——它把架构问题悄悄推迟到了未来。

比如,工程师让 AI 实现一个功能,忘记交代某个细节,AI 会自行补上。它可能拼接一段重复逻辑,或者堆上多层 if-else,但几乎不会主动说:“这个需求不改接口根本没法干净地做。”有经验的工程师通常在动手实现时就能察觉这一点,意识到小范围重构能让方案清晰得多。这种判断,恰恰是当前 AI 最欠缺的。

更棘手的是,AI 生成的代码往往格式规范、注释完整,看起来赏心悦目,但它真正存在的问题——架构错位、冗余代码、边界情况没处理——都藏在表层之下。在代码评审中,这些缺陷是最容易被忽略的。

guideme:把“怎么写”变成“改哪里”

为了对冲 AI 的“短视”,作者给自己设计了一个叫 guideme 的 SKILL.md。它的工作方式与 Claude 的 Learning Mode 有些类似,但目标用户是高级工程师,而不是新人。

这个技能不生成可直接粘贴的代码块,而是像交接入职任务一样,告诉工程师:改动涉及哪些文件、应该改什么、为什么这样改,并附上相关模块的架构概览。实现部分则完全交给工程师自己。

  • 明确改动范围,提供上下文
  • 解释设计动机,避免说教式的基础讲解
  • 要求手工实现,让架构问题暴露出来

作者强调,亲手实现指南,正是发现审查漏掉的架构捷径的关键时刻。机器生成的代码不会“卡住”,也不会告诉你这里有个设计矛盾,但人会。

AI 编程工具的下一步

这个案例对 AI 编程工具的演进很有参考价值。它说明,AI 的价值不限于补全代码,也可以是帮助你更深刻地理解代码。与其让 AI 当“自动补全器”,不如让它当一个“带路向导”。

对团队而言,这也提醒我们:审查 AI 生成的代码时,别被表面的整洁迷惑,要额外关注结构是否合理、是否走了不必要的绕路。也许未来,更成熟的工具会在生成之前主动评估“是否应该重构”这个选项。

文章结尾的观点很务实:AI 能帮你写很多代码,但“怎么写更好看”这件事,至少目前,还是得靠人。

AI编程经验代码重构代码审查手写代码编程辅助guideme高级工程师AI生成代码陷阱

分享

评论

0
0/500 字符

暂无评论

成为第一个评论的人

探索更多

相似工具

Cursor

Cursor

一款基于 VS Code 二次开发的智能代码编辑器,以“原生内置 AI”为核心卖点。它不依赖插件,而是将 AI 深度植入编辑器底层,能够理解整个项目的上下文代码库,支持无缝迁移 VS Code 的所有配置和插件。

Google Antigravity

Google Antigravity

Antigravity 支持多模型,包括 Gemini 3 Pro、Claude Sonnet 4.5、GPT-OSS,开发者可以在同一环境中选择最适合任务的模型。

Codex

Codex

OpenAI Codex 是由 OpenAI 开发的 AI 编程模型和助手,可将自然语言指令翻译成对应的源代码,为开发者提供智能补全、代码生成等功能。它最初于 2021 年作为 OpenAI API 的代码模型推出,曾为 GitHub Copilot 提供核心支持。随着 OpenAI 技术的迭代,Codex 在 2025 年以“AI 编程智能体”的全新姿态回归,能够理解复杂需求并自动编写、调试代码,显著提升开发效率和软件交付速度。

Kiro

Kiro

Kiro 是由 AWS 推出的 AI 编程 IDE,采用规范驱动的开发模式,将自然语言需求转化为明确的规格文档和任务,再由内置 AI 代理生成代码并调试优化,全流程辅助大型项目开发。

Trae

Trae

Trae(官网 trae.ai)是由 字节跳动(ByteDance)推出的一款 AI 原生集成开发环境(IDE)。它不是简单地作为一个编程助手,而是一个「协作伙伴」,通过深度整合大型语言模型(LLM),帮助开发者从需求、构建代码,到调试和部署,实现更智能化、自动化的软件开发。

Claude

Claude

Claude 是由美国人工智能公司 Anthropic 打造的智能语言交互平台,它融合了深度文本理解、信息整理、代码辅助和任务分析等能力,能在聊天对话之外应对更复杂的问题,例如长文摘要、图像解析、逻辑推理及编程协助等。相比一些单一问答机器人,Claude 更像一个具备推理逻辑、可扩展功能的智能工具。

开源项目

guidellm: 评估和优化 LLM 部署性能

guidellm 是一个开源工具,专为评估和优化大语言模型(LLM)在生产环境中的推理性能而设计。它支持压力测试、延迟分析、吞吐量评估等,帮助开发者识别瓶颈并调整部署配置。基于 vLLM 团队开发,适合需要精细化调优 LLM 服务的团队。

Kun: 将 AI Agent 工作区嵌入你的应用

Kun 是一个开源的 AI Agent 工作空间,内置代码与写作模式,可无缝集成到你的应用程序中。基于 TypeScript 开发,为开发者提供可定制的智能交互环境,支持多轮对话、工具调用和上下文管理。

ai-gateway: 统一管理生成式 AI 服务的访问网关

ai-gateway 是基于 Envoy Gateway 构建的开源项目,提供统一的 API 网关来管理对多种生成式 AI 服务的访问,支持负载均衡、缓存、限流等功能,简化 AI 应用的集成和运维。

go-micro: 为 AI 智能体打造的 Go 微服务框架

go-micro 是一个用 Go 语言编写的微服务框架,专门为构建 AI 智能体而设计。它提供服务发现、负载均衡、消息编码、事件驱动等核心能力,让开发者能快速搭建可扩展的分布式 AI 系统。GitHub 星标超 2.2 万,社区活跃,适合 Go 语言开发者入门微服务和 AI agent 架构。

terax-ai: 7MB终端优先AI开发工作台

terax-ai 是一个轻量级(仅7MB)的终端优先AI原生开发工作台,专为命令行爱好者设计。它集成了AI辅助能力,提供极快的启动速度和极小的资源占用,让开发者在熟悉的终端环境中高效编码、调试和实验。开源且易于安装,适合追求简洁与效率的开发者。

jar-analyzer: JAR包GUI分析工具内置AI助手

Jar Analyzer 是一个开源的 JAR 包 GUI 分析工具,内置 AI 助手辅助分析,支持 JAR DIFF、方法调用关系搜索、DFS 调用链分析、污点分析、CFG 程序分析、JVM 栈帧分析等功能,适合 Java 开发者、安全研究人员进行代码审计和逆向分析。