AI 寫 Code 寫出一座垃圾山？2026 意圖驅動開發 (IBD) 實戰：拒絕技術債的 Prompt 工程學

嗨，我是 Eric，浪花科技的資深工程師。如果你的 2026 年跟我一樣，每天早上打開 IDE（現在可能已經是 Google Antigravity 或 Cursor 的進化版了），看著那些由「AI 輔助」生成的程式碼，心中卻只有無限的想死，那麼這篇文章就是為你寫的。

在 2026 年的今天，生成式 AI 已經強大到可以秒產整個 WordPress 外掛或 Laravel 模組。但是，我們發現了一個恐怖的現象：軟體開發的速度變快了，但「技術債」累積的速度卻是指數級暴增。

很多開發者（甚至是資深工程師）陷入了「Vibe Coding」的陷阱——感覺對了就 Commit，反正 Code 能跑。結果三個月後，當你要維護時，才發現那是一坨邏輯不通、變數命名混亂、甚至充滿資安漏洞的義大利麵程式碼。今天要聊的，就是如何用「意圖驅動開發」(Intent-Based Development, IBD) 來拯救你的專案，讓 AI 成為你的頂級架構師，而不是製造垃圾的實習生。

什麼是意圖驅動開發 (Intent-Based Development)？

在 2024 年以前，我們習慣叫它 Prompt Engineering，但在 2026 年，這個詞已經不夠精確了。IBD 的核心哲學是：不要告訴 AI 「寫這段程式碼」，而是告訴它「為什麼要寫」、「在什麼情境下寫」以及「有哪些不可跨越的邊界」。

AI 模型（無論是 GPT-6 還是 Claude 4.5）本質上是機率模型，它們傾向於給出「最常見」的答案，而不是「最適合你專案架構」的答案。如果你只給指令 (Command)，AI 就只會吐出程式碼片段；如果你給的是意圖 (Intent)，AI 才能生成符合系統思維的解決方案。

IBD 的黃金三角架構

要在 2026 年寫出高品質、無技術債的 AI 指令，你必須遵循這個架構：

• Context (脈絡)：這段程式碼住在原本系統的哪裡？現有的架構模式是什麼？（例如：我們使用 Repository Pattern，不要把邏輯寫在 Controller 裡）。
• Intent (意圖)：業務邏輯的目標是什麼？（例如：我要做一個防止超賣的機制，而不是單純的庫存扣除）。
• Constraints (邊界/約束)：什麼是絕對不能做的？（例如：必須使用 WordPress 的 $wpdb->prepare 防止注入，禁止使用原生 PHP $_POST）。

實戰演練：從「垃圾 Prompt」到「IBD Prompt」

讓我們直接看一個 WordPress 開發的例子。假設我們要寫一個「取得最新文章並顯示」的短代碼。

❌ 導致技術債的 Prompt (The Lazy Prompt)

幫我寫一個 WordPress Shortcode，顯示最近 5 篇文章的標題和連結。

AI 可能產出的結果 (災難現場)：

// 這段程式碼在 2026 年簡直是犯罪
function recent_posts_shortcode() {
    $posts = get_posts('numberposts=5');
    $output = '
';
    foreach ($posts as $post) {
        // 直接輸出，沒有 escape，沒有快取，沒有樣式類別
        $output .= '
' . $post->post_title . '
';
    }
    $output .= '
';
    return $output;
}
add_shortcode('recent_posts', 'recent_posts_shortcode');

這段程式碼有什麼問題？沒有快取 (效能殺手)、沒有 HTML 跳脫 (XSS 風險)、直接在函式內組字串 (難以維護)。這就是技術債的源頭。

✅ 意圖驅動開發 (IBD) 的 Prompt

身為資深工程師，你的 Prompt 應該長這樣：


Context: 我們正在開發一個高流量的企業級 WordPress 網站，嚴格遵守 WordPress Coding Standards (WPCS)。
Intent: 我需要一個 Shortcode `[roamer_latest_news]`，用於在首頁顯示最新消息。這是一個高頻讀取的區塊。
Constraints:
1. 必須使用 WordPress Transients API 進行快取 (快取時間 1 小時)，避免每次都查詢資料庫。
2. HTML 輸出必須嚴格使用 `esc_html()` 和 `esc_url()` 進行跳脫。
3. 使用 `WP_Query` 而不是 `get_posts`，以便未來擴充。
4. 請將 HTML 結構與 PHP 邏輯盡量分離，或者使用 output buffer。
5. 如果沒有文章，不回傳任何 HTML。


AI 在 IBD 引導下產出的結果：

function roamer_latest_news_shortcode( $atts ) {
    // 1. 設定預設屬性 (防呆)
    $atts = shortcode_atts( array(
        'limit' => 5,
    ), $atts, 'roamer_latest_news' );

    // 2. 處理快取 Key，確保不同參數有不同快取
    $cache_key = 'roamer_latest_news_' . intval( $atts['limit'] );
    $query     = get_transient( $cache_key );

    if ( false === $query ) {
        $args = array(
            'post_type'      => 'post',
            'posts_per_page' => intval( $atts['limit'] ),
            'post_status'    => 'publish',
            // 優化效能：只查詢需要的欄位
            'no_found_rows'  => true,
        );
        $query = new WP_Query( $args );
        // 設定快取 1 小時
        set_transient( $cache_key, $query, HOUR_IN_SECONDS );
    }

    // 3. Output Buffer 與安全處理
    if ( $query->have_posts() ) {
        ob_start();
        ?>
        

            have_posts() ) : $query->the_post(); ?>