團隊實測燒600億Token 總結AI Agent 7大黃金開發心法 Copy&Paste就用得【須注意1致命陷阱】

Vercel 軟件工程師 Marcos Hernanz 分析約 600 億個 Token 的 AI 交互數據後，於社交平台發布「AGENTS.md」核心指令集。該文件列出 AI Agent 進行程式碼生成時的七大行為規範，強調極簡實作與移除冗餘代碼，同時提醒開發者相關指令僅適用於個人項目，切勿直接應用於生產環境。

即刻【按此】，用 App 睇更多產品開箱影片

開發者耗費600億Token 實測歸納AI Agent七大核心指令

隨著人工智能（AI）程式碼生成技術普及，如何精準引導 AI Agent（智能代理）進行高質素編程，成為軟件工程領域的新焦點。開發者 Marcos Hernanz 近日在社群平台 X（前稱 Twitter）發文，分享其在處理約 600 億個 Token（代幣）的 AI 交互經驗後，總結出的「AGENTS.md」核心指令集，隨即引發網絡熱議。

Marcos Hernanz 現為著名前端開發框架平台 Vercel（Next.js 團隊）的軟件工程人員，同時亦是腦力訓練產品 Cogniba 的創辦人兼行政總裁。他專注於 AI 編程代理、評測基礎架構及機器學習系統的開發。

極簡提示詞引發開發者熱烈討論

Marcos Hernanz 首於 7 月底公開其 AI Agent 系統指令，最初僅涵蓋三項基本原則。其後於 8 月初，他進一步擴充並發布完整版「AGENTS.md」文件，指出這是經過約 600 億 Token 實測訓練後所獲得的精煉指令。

該貼文發布後迅速獲得數百萬次瀏覽及大量轉載，引來眾多工程師及 AI 創作者圍觀。許多開發者認為該指令集精準切中 AI 編程時常見的過度設計與冗餘代碼問題，具備直接複製應用的實用價值。

AI Agent 開發七大核心心法

Marcos Hernanz 整理的「AGENTS.md」內容，為 AI 在編程時的行為規範設定了明確界限。以下為其原版英文指令與中文詳細解析：

 AI Agent 開發心法完整指令解析

1. 拒絕向後兼容性（Do not preserve backward compatibility）

• 原文：Do not preserve backward compatibility. Remove obsolete paths instead of adding compatibility layers, fallbacks, or migrations.

• 中文解析：切勿維持向後兼容性。遇到廢棄或舊有的代碼路徑時應直接移除，而非添加額外的兼容層、後備方案（fallbacks）或遷移邏輯。

2. 採用最簡單實作（Choose the simplest implementation）

• 原文：Choose the simplest implementation that fully meets the current requirements. Avoid speculative abstractions, configuration, and indirection.

• 中文解析：選擇能夠完全滿足當前需求的極簡實作方式。避免不必要的推測性抽象、複雜配置及間接呼叫。

3. 分層漸進式擴充（Grow the system in layers）

• 原文：Grow the system in layers. Start from the smallest version that works end to end, and add each new capability on top of a product that already works. Never trade a working product for unfinished complexity.

• 中文解析：以分層方式擴建系統。從能端到端（end-to-end）運行的最小可行版本開始，並在已穩定運作的產品基礎上逐一添加新功能。絕不應為了尚未完成的複雜功能，而犧牲已可運作的產品。

4. 保持模組化與職責分離（Keep components modular separated）

• 原文：Keep components modular and concerns clearly separated.

• 中文解析：保持組件的模組化，並確保各項功能職責明確分離（Separation of concerns）。

5. 優先使用成熟第三方庫（Prefer established libraries）

• 原文：Prefer established, well-maintained libraries when they reduce overall complexity or improve reliability. Do not reimplement common functionality without a clear reason.

• 中文解析：當成熟且維護良好的第三方庫能降低整體複雜度或提升可靠性時，應優先採用。無明確原因下，切勿重新實作常見功能。

6. 充分利用既有依賴項（Lean on existing dependencies）

• 原文：Lean on the dependencies already in the project before writing your own implementation or adding packages. Do not assume a library lacks a capability without checking its documentation and types.

• 中文解析：在自行編寫代碼或添加新套件之前，應先充分利用項目中現有的依賴項。在查閱官方文件和型別定義前，切勿任意假設既有套件缺乏某項功能。

7. 堅持長期架構決策（Make long-term architectural decisions）

• 原文：Make architectural decisions for the long term. Do not accept a stopgap that only works for now and is meant to be replaced later.

• 中文解析：進行架構決策時須著眼於長遠發展。切勿接受僅能解決燃眉之急、日後仍需替換的臨時過渡方案。

補充原則：參考成熟產品設計模式

在發布完整版的「AGENTS.md」後，Marcos Hernanz 隨後於同一討論串中發布補充指令：

設計解決方案前的必備步驟

• 原文：Study how established products solve the problem before designing a solution. Adopt their proven patterns and conventions rather than inventing an approach from scratch.

• 中文解析：在設計解決方案之前，先研究成熟產品如何解決相同問題。採用經過驗證的模式與慣例，而非從零開始憑空發明新方法。

關鍵提醒：生產環境應用的致命陷阱

儘管這套指令集受到廣泛關注，Marcos Hernanz 發出明確免責聲明與警告，提醒開發者切勿盲目應用。Marcos Hernanz 特別指出，這套「AGENTS.md」規則僅適用於個人副業項目（Side projects）。

他強調：「如果你不想毀掉你的代碼庫（codebase），切勿在生產環境（production）中使用它。」（Don't use it in production if you don't want to destroy your codebase.）

由於該指令集要求 AI 直接移除舊有路徑且不保留向後兼容性，若將其應用於大型企業或生產環境系統，AI 在迭代代碼時可能會直接刪除既有介面或數據結構，導致正式環境的數據庫連接斷裂或數據結構破壞，進而引發嚴重的系統崩潰。

Source： ezone.hk、X@MarcosHernanz

【相關報道】

【相關話題】新手玩AI代理唔知點開始？Gemini Spark 36個日常實用指令詞 Copy&Paste即刻用到

Google正式在香港推出個人AI代理服務Gemini Spark。該服務基於Gemini 3.6 Flash模型與雲端基礎架構，可在裝置鎖定或離線狀態下於背景持續運作，並原生整合Gmail、Google文件、Google試算表及Google日曆等Google Workspace工具以執行跨平台任務。現時香港Google AI Ultra及AI Pro訂閱用戶已陸續獲得存取權限。本文整理36個涵蓋生活管理、理財追蹤、電郵處理、專案協作及數據整理的具體應用範例與提示詞指令。

↓點擊圖片放大↓

+2

Source: ezone.hk