iT邦幫忙

2025 iThome 鐵人賽

DAY 3
0
自我挑戰組

30 天工程師雜學之旅系列 第 3

Kiro-3 用 Kiro Spec 系統打造有脈絡的開發流程 — 規劃到執行全攻略

  • 分享至 

  • xImage
  •  

1. 前言:從 Vibe Coding 到有結構的開發習慣

我當初看到Kiro就躍躍欲試,就是因為它主打的 spec-driven development 概念非常吸引人 —— “思考先於編碼” 的開發流程不是新概念,但在 AI 工具堆裡,Kiro 能讓這流程看起來自然而不是強迫。
今天,就想跟大家聊聊本人實測後對 Kiro Spec 功能的使用體驗與思維流。


2. Spec 是什麼?Kiro 對開發流程的結構化定義

根據 Kiro 官方的說法,**Specs(規格)**是將複雜功能拆解為可執行計畫的核心資產,能幫助你:

  • 把任意概念化想法轉化為結構化的 user stories 和 acceptance criteria
  • 建立包含架構圖與流程圖的設計文件
  • 透過 tasks.md 跟進實作進度與任務拆解
  • 跨 prod-team 提供可追蹤與協作的美好開發體驗

快速入門:

  1. 在 Kiro 側邊欄 Specs 區點擊「+」,或在 chat 面板選擇 Spec 模式
  2. 輸入你的專案目標描述
  3. 跟著 Requirements → Design → Implementation 三階段流程前進

3. 三階段 Workflow 大解析

3.1 Requirements 阶段:從 Prompt 到 structured user-stories

Kiro 會把你的需求轉成 EARS 格式的 user stories,像是:

WHEN a user submits a form with invalid data  
THE SYSTEM SHALL display validation errors next to the relevant fields

這種寫法具備清晰性、可測性與可追蹤性,讓需求靠得住又有用。像 Jira tickets 一樣,這些 markdown 檔也可被 commit 作為 repo 一部分,保留完整思考歷史。

3.2 Design 階段:系統藍圖初見端倪

在你批准需求後,Kiro 會掃描原始碼,生成 design.md,內容包含:

  • 架構概覽
  • 元件與介面定義
  • 資料模型與錯誤處理設計
  • 測試策略與決策依據

這部份讓整體方向一目瞭然,避免寫完一堆 code 卻不知道為何這樣設計。

3.3 Tasks 階段:落實規劃的任務清單

之後進入 tasks.md,Kiro 把設計拆成可點擊啟動的 task,比如:

  • 實作某個 api endpoint
  • 寫測試/文件/health check
  • …等等

每完成一項,它會更新狀態、生成 diff,等待你 review,再繼續下一步。


4. 規格的進化與協作

4.1 Iterative Refinement(規格也會進化)

Kiro 允許你在進行開發時回來調整 requirements.mddesign.md,並自動同步更新 tasks.md 任務列表,實現 iterative development 還能保持一致性。

4.2 專案分割合作多人協作

若多人分工開發,你可以透過 Splitting SPEC,把 Specs 分析成不同模組(如 UI、核心邏輯、整合測試等),避免多人衝突,也能更靈活維護。

4.3 與外部成果同步

即使你手動完成部分功能,也能讓 Kiro 辨識已完成的內容並更新 task 狀態,避免重工。


5. 外部評論與技術觀察

外部報導也提到 Kiro 的 Spec 方法跳脫「vibe coding」的雜亂,讓想法有脈絡可循,最終產出更穩定、可維護的程式碼(官方介紹)。

TechTarget 評論指出:Kiro 的差異在於提供導向 spec 的工具,讓你可以作「導航員」而不是「放手讓 AI 作最終決定」,強調的是「你主導設計,而不是 prompt 控制一切」。


6. 實戰心得分享

我的規劃流程長這樣:

  1. 開 Spec → 輸入「我要做 XXX 功能」prompt
  2. 审核生成的 Requirements,確保 EARS user stories 覆蓋 edge cases
  3. 审核 Design,確認架構與 components 合理,適時調整
  4. 在 Implementation 階段逐一點擊 task 實作,review diff 再走下一步
  5. 如果中途 scope 更改,隨時回去 refine Specs 並同步更新 task

這樣開發中少了很多補救時間與重工,也讓每一步都有脈絡可追。


7. 圖像說明

  • llm spec
    使用自然語言開始創造新專案/設計/功能
  • task demo
    模組化的工作項目

8. 結語:Specs 讓計劃和執行貼得更近

在我實際用 Spec 做 FastAPI MCP server 這個功能時,最大的感受是——它讓我在「計劃」和「執行」之間沒有斷層。

以前就算腦子裡有規劃,也常常在寫到一半才發現漏了什麼步驟,或者改 scope 時很難同步更新到整個計畫。
用 Kiro Spec 的時候,每個步驟都被拆成 AI agent 能執行的單位,Kiro 會記住完成進度、知道下一步要幹嘛,甚至 scope 改了也能馬上更新任務列表。

對我來說,這種開發方式不只是「AI 幫我寫 code」,更像是「AI 幫我管理專案,還會自己動手幹活」。
下一篇我會用一個完整案例,帶你從第一行需求開始,到最後任務完成,看看 Spec 在實戰中是怎麼運作的。


上一篇
Kiro-2 用 Kiro Hook 一鍵自動化日常任務 — 安裝、設定與實戰技巧
下一篇
Kiro-4 用 Kiro Spec 打造 FastAPI MCP Server — 從需求到實作的真實案例
系列文
30 天工程師雜學之旅21
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言