認識 Noea Code

Noea Code（簡稱 Noea）協助你在使用 AI 開發時，理解並決定軟體的行為。你寫下需求，由程式開發 Agent 修改程式碼，再透過實作說明、依據和注意事項，檢查結果是否符合預期。

從現有專案中的一條規則開始即可。產品行為、架構限制或演算法需求，都可以成為你的第一個意圖。

意圖是你希望軟體持續滿足的需求。功能完成後，它們依然有效。當你決定改變行為時，就修改對應的文字。不必描述整個應用程式，先寫你在意的部分。

連結意圖與實作

假設你正在開發每日簽到應用程式，寫下：

使用者連續簽到 7 天後，發放一份獎勵。

這句話設定了獎勵條件，但仍留下幾個選擇：一天如何計算、漏簽後如何處理，以及發放什麼獎勵。Agent 實作規則時，仍須做出這些選擇。

Noea 將這句話連結到實作說明。你可以閱讀程式碼如何計算天數、開啟說明引用的程式碼或測試資料，找出未滿足的需求或值得討論的選擇。若你決定一天必須依使用者所在地的日曆日期計算，就把這項決定加入意圖，讓後續工作也必須遵守。

認識三種內容

意圖文件是 Markdown 檔案，可以用 Git 追蹤，也可以在其他編輯器修改。Noea 另外儲存實作說明，並以側註呈現。部分英文介面將意圖文件稱為 Source（源文件）；它與實作資料夾中的程式碼不同。

日常使用流程

1. 釐清意圖。直接撰寫，或與 Agent 討論後審閱提議的文字。
2. 實作並理解。讓 Agent 完成工作，再調查實作，閱讀說明、依據及注意事項。
3. 記錄決定。針對段落提問，補充希望保留的需求，繼續實作與檢查。

若程式碼已存在，寫下想檢查的需求並執行解釋。若仍需實作，使用對話或實作操作。

你可以接受已理解的選擇，不必將每個實作細節都變成長期需求。參閱閱讀說明與依據，判斷哪些內容應納入意圖。

了解 Noea 與 Agent 的分工

Noea 提供工作台，讓你撰寫文件、討論決策、審閱變更及閱讀說明。Agent 負責讀取專案、呼叫工具及修改程式碼。選擇支援的 Agent，使用它提供的模型與登入方式。

在 Noea 的提議流程中，意圖文件的變更需要你決定。你可以編輯並接受提議，或忽略提議。程式碼變更與命令執行則取決於 Agent 的能力及權限設定。

實作說明不能取代測試或實際使用。對重要行為，應檢查依據並視需要驗證。

從小而有意義的問題開始

選擇範圍明確、結果可觀察的問題，例如獎勵何時發放、庫存不足時如何處理，或 API 必須遵守的限制。專案其餘部分仍可沿用原本的開發流程。

接著安裝與準備，再完成第一個工作流程。