Intent

Intent 是什麼？

Intent 是開發者工作區，用於協調 agents，讓您在實作變更時保持規格與程式碼庫同步。其核心目的是將規格視為真相來源，並在 agents 完成工作時更新它，幫助防止專案在需求演進時偏離軌道。

除了通用工作流程，Intent 被描述為透過跨服務 JWT 認證示範來支援 agent 協調。在該範例中，不同 agents 處理系統不同部分，一個 agent 在認證服務中處理 token 發行、更新與撤銷，另一個 agent 在 API 閘道中新增 JWT 驗證中介軟體及相關行為。頁面也提到工作區是隔離的，且 Intent 適用於 Apple Silicon 的 macOS。

主要功能

• 規格優先開發工作流程： Intent 以活文件規格作為真相來源設計，保持其與演進中程式碼庫一致。
• 開發者工作區中的 agent 協調： 多個 agents 可共同實作變更，而非視為斷開步驟。
• 活文件規格同步： agents 完成工作時，規格會更新，避免專案隨時間偏離需求。
• 隔離工作區： 每個工作區皆為隔離，有助分隔並行工作流程。
• 基於 agent 的實作範例 (JWT 認證)： 示範說明跨服務協調實作—認證服務中的 token 生命週期工作，以及 API 閘道中的 JWT 驗證行為。

如何使用 Intent

1. 以規格作為真相來源開始。 使用規格定義欲實作的功能或變更。
2. 使用工作區協調 agent 工作。 agents 在同一工作區承擔不同實作責任，其輸出保持與規格連結。
3. 實作變更同時保持規格同步。 工作完成時，活文件規格會更新以反映程式碼庫中已實作內容。
4. 驗證協調元件間行為。 如跨服務 JWT 認證情境，即確保 token 生命週期責任 (發行/更新/撤銷) 及閘道驗證責任皆由協調工作涵蓋。

使用情境

• 管理演進需求而不偏離： 規格變更時，Intent 幫助在實作進展中保持程式碼與規格一致。
• 跨服務功能實作： JWT 認證示範顯示認證服務與 API 閘道間變更協調。
• 依子系統分割工作： agents 可分配不同區域 (例如一服務中的 token 管理，另一服務中的請求驗證)，同時維持單一同步規格。
• 不同任務的隔離工作流程： 隔離工作區支援多變更並行時的分隔。

常見問題

問：Intent 解決什麼問題？
答：它透過將規格視為真相來源，並在 agents 完成工作時保持規格與程式碼同步，解決專案「偏離」問題。

問：在此脈絡中「活文件規格」意味什麼？
答：實作完成時規格會更新，讓需求保持與目前程式碼庫一致，而非過時。

問：Intent 可否協調多服務工作？
答：可以。跨服務 JWT 認證示範中，一個 agent 在認證服務處理 token 發行/更新/撤銷，另一個在 API 閘道新增 JWT 驗證中介軟體及支援行為。

問：工作區是否隔離？
答：頁面指出每個工作區皆為隔離。

問：Intent 是否適用 macOS？
答：頁面提到適用 Apple Silicon 的 macOS。

替代方案

• 使用傳統開發者工具的規格與實作工作流程： 團隊可以透過手動方式或文件工具，將活文件或需求檔案與程式碼同步，並採用標準版本控制實務進行協調。
• 代理協調框架： 團隊可使用代理協調工具來管理自主工作者，而非專屬「開發者工作區」產品，並搭配自有的規格同步流程。
• AI 輔助程式碼生成搭配人工審核： 從提示生成程式碼的工具可協助實作功能，但規格同步需透過團隊的審核與文件實務處理。
• 使用 CI/CD 與程式碼審核的手動跨服務實作： 對於如 JWT 認證等協調功能，團隊可在各服務中實作變更，並以標準工程工作流程確保元件間一致性。