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 開發者、安全研究人員進行程式碼審計和逆向分析。