top of page

intent.md 是什麼?Claude Code 團隊公開的「AI 原生開發流程」,把你的意圖也變成一份檔案

23小时前
讀畢需時 9 分鐘

半小時做完的事,為什麼專案還是卡住

深夜十一點,你盯著終端機。Agent 剛剛把一個功能的程式碼寫完、測試也一併跑完,訊息跳出來的時候你看了一眼時間戳記——半小時。同一件事,上禮拜你的團隊排了整整三天。

你正想關電腦收工,手機卻跳出一則通知:待整理的需求清單裡還躺著八張沒人碰過的單子,昨天那個 Pull Request 也還沒有人看。你突然意識到一件事——變快的只有「寫程式」這一段,其他每一段都還是老樣子。

這正是 Claude Code 創造者 Boris Cherny 與 Anthropic 團隊,最近公開一份「AI 原生軟體開發生命週期(SDLC)playbook」時,想直接點名的問題。YouTuber Rob Shocks 在他的頻道上把這份文件拆解了一遍,核心的一句話是:程式碼已經不是瓶頸了,你的流程才是。

「兩倍速」是真的,但只發生在一個地方

傳統的軟體開發生命週期,長得像這樣:規劃、設計、建置、測試、部署上線、維運,做完一輪再回到起點迎接下一個功能、下一個 bug、下一次發版。

在 Agent 出現之前,「建置」這一段幾乎永遠是耗時最長、也最貴的一段。Agent 出現之後,這一段被大幅壓縮——按 Rob Shocks 的說法,等於快了兩倍。問題是,規劃、設計、測試、審查、維運,沒有一個跟著一起變快。 Anthropic 這份文件想回答的,正是這個問題:Agent 幫我們把「建置」壓縮了,那其他每一個階段,要怎麼一起用 Agent 重新設計?

從「開會蒐集需求」到「跟 Agent 吵到彼此都同意」

先看規劃階段。傳統做法是坐下來開會、蒐集需求、寫 PRD、辦工作坊、跟利害關係人一輪一輪對焦。

在 Anthropic 描述的新流程裡,第一步反過來了:先讓 Agent 反覆訪問你,把你要做的功能、要修的 bug、或整個產品的樣貌問清楚,藉此建立起完整的上下文。Rob Shocks 提到他自己用的是一套叫「Switch Dimension Discovery」的探索式 skill,也提到市面上還有 Matt Pocock 做的「Realm」、或是 Cursor 內建的「Requirements Discovery」——工具可以不同,但目的一致:讓 Agent 一路追問,直到它真正搞懂你要的是什麼為止。你要做的,是把自己的經驗、對這個領域的理解、還有各種背景脈絡,盡量倒進這場對話裡。

Agent 接著把這些對話裡萃取出來的痛點整理、彙整,寫成一份檔案——intent.md。這份檔案的特別之處在於:人看得懂,機器也能直接拿去動作(human-readable and machine-actionable)。

傳統 SDLC 裡,一個想法會先變成待辦清單裡的一則使用者故事、算上故事點數、經過幾次交接才輪到人動手。而在 Anthropic 描述的世界裡,任何一個提出議題的人——不管是回報 bug 的客戶、有新功能想法的產品經理,還是想記錄流程優化點子的工程師——都可以直接跟 Claude 腦力激盪,把結果寫成一份 intent.md。實際做法很單純:專案裡開一個叫 `intent` 的資料夾,每一份 intent.md 就存在裡面。

這份檔案寫完後,工作還沒結束。提出這個意圖的人(Anthropic 稱之為 originator)需要回頭檢查 Agent 寫下的內容,確認彼此的理解一致——originator 不必是團隊裡的專家,任何人都可以扮演這個角色。之後,這些散落的 intent.md 會被匯集成類似待辦清單的東西,可能是一份份 markdown 檔,也可能整理進 Notion 或 Linear,由產品負責人來排序,甚至也可以交給 Agent 做初步分類——標上前端/後端、任務大小、功能類型、優先層級這類標籤。

intent.md 只是第一步:一條叫「artifact chain」的生產線

一旦 intent.md 拍板,流程就往下一站走——spec(規格)。Anthropic 建議,intent 一旦確認,就用一個 hook 或固定流程自動觸發 spec 的產生,並給出一個範例提示詞:讀取附上的 intent.md,產出一份需求與設計規格,套用你手上可用的 skill 去規劃並符合品牌規範,完整寫進 spec.md。這裡沒有標準答案——你可以直接用 Cursor、Claude Code 或 Codex 內建的 plan mode,也可以自己動手做一個專屬於團隊風格的 spec 產生 skill。

再往下走一步是 plan:工程師把 intent 與 spec 一起餵給 Agent 進入 plan mode,產出一份 plan.md。Anthropic 建議在這一步反過來質問這份計畫——問它「哪些改動可能會出錯」。目標是讓 plan.md 完整到一個地步:就算把它單獨交給另一位工程師,對方不用回頭看 intent 或 spec,也能直接照著執行。這一點特別重要,因為 Rob Shocks 特別提醒:這整條流程從來不是靠同一個 Agent 從頭做到尾——不同階段會由不同的 Agent、甚至不同的對話串(context window)接手,所以你要把 intent、spec、plan 這些「產物」當成正式的交接文件,讓下一個 Agent 能夠不帶著前面的對話記憶,直接從文件本身重新開始。

plan.md 本身也有固定寫法:列出需要改動的檔案、工作順序或待辦清單、風險與限制,以及「證明」——某種可驗證的成功標準,可能是 lint 檢查、可能是測試通過與否。Anthropic 也建議把 intent、spec、plan 每個版本、每次由誰異動都存下來,這是很多企業覺得最難落地、卻對追蹤成效(例如 DORA 指標)最關鍵的一塊。

進入 build(建置)之後,Anthropic 建議用「auto mode」加速——但 Rob Shocks 提醒這高度取決於你的組織:先在權限收緊的環境裡跑一陣子,逐步放寬,等你摸清楚哪些工具、哪些外部套件、哪些網路來源是可以放行的「合理使用範圍」,再把這套權限鎖進 Cursor 或 Claude 的設定裡,Agent 才能在你不必時刻盯著的情況下加速前進,同時把「炸裂半徑」控制住。團隊也建議搭配 worktree,讓多個 Agent 同時處理不同任務;而串起這一切、讓流程保持在軌道上的,是 hook——例如在建置完成後自動更新 plan、擋住 Agent 碰某些資料夾、或阻止它安裝一個還沒核准的 npm 套件。好一點的 Agent 執行環境還能把 plan 拆成多個獨立任務,交給多個 sub-agent 平行處理。

到了 test(測試)階段,Anthropic 的原則是:讓 Agent 在人類工程師或 QA 出手前,盡可能把測試做完——寫測試、跑 lint、跑建置確認沒有錯誤;如果團隊用到 Playwright 這類工具,甚至能讓 Agent 實際跑起服務、截圖、錄下操作過程再交回來。Anthropic 也建議每次 skill 更動或換模型時都跑一輪 evals:先收集個二十來個曾經處理過的真實案例與預期結果,每次有新模型、新規模、或工作方式有根本性改變時,就拿這組案例回測,確認整條 SDLC 有沒有退步。

進入 deploy(部署),Agent 依照人類已經完成的審查結果,開出一個 Pull Request;Anthropic 建議讓另一個 Claude 實例依照團隊的政策與安全規範,非同步地審查這個 PR——如果它不同意,還會有另一個 Claude 實例專門處理這些審查意見的往返。治理層面,你可以設計 hook,讓部署非得經過特定人核准、或滿足某個發版關卡才會放行;PR 通過後,還會有另一個 Agent 跑一輪安全與 CI 檢查,可能是決定性的 lint 與門檻檢查,也可能是像 Cursor Bugbot 或 Claude 的安全審查這類 Agent 幫你再抓一次錯。

最後是 maintenance(維運)——Rob Shocks 直言,這是整份文件裡「最有野心」的一段。傳統維運是被動的:你在吃午餐、你在待命、也可能是凌晨三點收到伺服器掛掉的警報,一張工單躺在堆積如山的待辦清單裡被徹底忽略。而在 AI 原生 SDLC 裡,一次資安事件、一張新工單、Slack 上的一則訊息,或是排程本身,都可以在完全沒有人參與的情況下喚醒 Claude,讓它非同步地去診斷、處理——而且它會依照發現的日誌或收到的訊息,自己生出一份 intent.md。實際運作上,你可能會先設好一些要守住的指標,一旦頁面掛掉或 API 流量突然衝高,就觸發 Agent 去診斷、寫出 intent、提出建議方案——全部發生在你還沒碰到電腦之前。

轉折:真正被考驗的不是 Agent 聰不聰明,是你有沒有把治理做好

看到這裡,很容易把這份 playbook 讀成「只要每個階段都塞進 Agent,流程就會自動變快」。但整理下來,真正撐起這條 artifact chain 的,其實是一堆不那麼性感的東西:把 intent、spec、plan 每個版本都存下來、標清楚誰動過;先在收緊的權限裡試跑再逐步放寬;用 hook 擋住不該碰的資料夾與套件;每次換模型都跑一輪回歸評估;PR 要有獨立的審查與安全門檻。少了任何一塊,「讓 Agent 接管整條 SDLC」很容易變成「讓 Agent 用更快的速度,把混亂複製到更多階段」。

Rob Shocks 自己也坦言,他在頻道上教的工作流跟 Anthropic 這份文件不完全一樣,市面上還有 Superpowers、BMAD 這類不同流派的做法——沒有一體適用的標準答案,重點是團隊要選定一套,並且盡量不要三天兩頭換。

從今天起,你要先寫的不是程式碼,是一份 intent.md

如果只能從這整套流程裡帶走一個習慣改變,大概是這個:下一次要做一個功能或修一個 bug 之前,先讓 Agent 反覆問你、把你腦子裡的上下文倒出來,寫成一份 intent.md,再往下走。

這也是為什麼這套流程對我們在意的另一件事特別有意思:一旦一個功能要經過 intent、spec、plan、build、test、deploy、maintain 七道關卡,每一道都可能是不同的 Agent、不同的模型在跑,跑的次數也遠比「一個 Agent 從頭寫到尾」多得多。流程標準化之後,用量會變得可預測,但也會變得更分散——這正是 AI Token King 想幫團隊解決的事:不管背後串了幾個 Agent、切了幾個模型,每一次呼叫用了哪個模型、花掉多少 Token、實際扣了多少錢,都能一次查清楚。

常見問題(FAQ)

Q1:intent.md 到底是什麼?

根據 Rob Shocks 轉述 Anthropic 團隊的做法,intent.md 是一份由「originator(提出議題的人)」跟 Claude 腦力激盪、整理出來的意圖文件,特色是「人看得懂、機器也能直接拿去動作」。它取代傳統待辦清單裡零散的使用者故事,成為後續 spec、plan 等產物的起點。

Q2:誰可以寫 intent.md?

任何人。可以是回報 bug 的客戶、想加功能的產品經理、或想記錄流程改善點子的工程師——不需要是團隊裡的專家。寫完之後,Anthropic 建議由提出議題的本人回頭檢查 Agent 整理的內容,確認雙方理解一致。

Q3:intent.md 跟 spec.md、plan.md 是什麼關係?

三者組成 Rob Shocks 所說的「artifact chain(產物鏈)」:intent.md 先確立要解決的問題與脈絡;一旦 intent 拍板,用 hook 或固定流程觸發產生 spec.md(需求與設計規格);再由工程師把 intent 與 spec 一起餵給 Agent 進入 plan mode,產出 plan.md(具體改動的檔案、順序、風險與驗證標準)。

Q4:這是不是代表整條流程都可以無人值守?

不是。逐字稿裡多次強調人要留在關鍵審查點上:originator 要核對 intent、工程師要確認 plan 才能執行、部署前需要人核准或滿足發版關卡。Anthropic 談的是減少每一階段花掉的人力時間,而不是完全移除人的判斷。

Q5:這套流程一定要照抄 Anthropic 的版本嗎?

不用。Rob Shocks 自己在影片裡就說,他實際教學的工作流跟 Anthropic 這份文件並不完全一樣,市面上也有 Superpowers、BMAD 等不同流派。重點是團隊要選定一套並盡量標準化,而不是每個專案都換一套玩法。

資料來源聲明

本文內容整理自 YouTube 頻道 Rob Shocks 於 2026 年 9 月發布的影片《Claude Codes New INTENT.MD, What is It?》,內容為該頻道對 Anthropic(Claude Code 創作者 Boris Cherny 所在團隊)公開之「AI 原生軟體開發生命週期 playbook」的口語拆解與轉述,並非本文作者直接查閱 Anthropic 官方原始文件逐字引用;文中流程步驟、工具名稱(如 Switch Dimension Discovery、Realm、Cursor Requirements Discovery)均忠實反映影片內容,非逐字翻譯,為重新組織與論述後的整理。若你的團隊要正式導入類似流程,建議自行查閱 Anthropic 官方發布的原始文件以核對細節。

延伸閱讀

立即行動

當一個功能要跑過 intent、spec、plan、build、test、deploy、maintain 七道關卡,背後可能是好幾個 Agent、好幾個模型輪番上陣,Token 帳單也會跟著散落在一次次呼叫裡。免費試用 AI Token King,把每一次呼叫花掉的 Token、用的模型、實際扣的費用一次攤開來看,不管你的 AI 原生 SDLC 串了多少個 Agent 與模型,都能看得懂錢花去哪。

最新文章

查看全部
AGENTS.md 是什麼?一份給 AI 看的 README,為什麼 Codex、Claude Code、Copilot 都在用

AGENTS.md 是一個開放、極簡的 Markdown 檔案格式,作用是把「怎麼在這個專案裡正確工作」的細節——像是建置指令、測試指令、程式碼風格、PR 規範——集中寫在一個固定位置,讓 AI 程式碼代理(coding agent)在動手改程式碼之前,能自己讀到這些脈絡,而不需要你在每次對話裡重新交代一遍。它由 OpenAI 於 2025 年 8 月釋出,2025 年 12 月 9 日與 Ant

 
 
 
AP2 是什麼?AI Agent 自動付款的標準協定,Google 捐給 FIDO Alliance 後對企業採購代表什麼

AP2(全名 Agent Payments Protocol,以下直接稱 AP2)是 Google 在 2025 年 9 月 16 日發布的開放協定,目的是讓 AI Agent 可以代替使用者完成「授權、驗證、付款」這一整條鏈路,而不是只停留在幫你找資料、寫程式。2026 年 4 月 28 日,Google 進一步把 AP2 捐給國際標準組織 FIDO Alliance,交由跨產業的技術工作小組共

 
 
 

留言


bottom of page