開始使用03 / 16
第一個工作流程
本頁內容
本教學以簽到獎勵為例，帶你撰寫第一個意圖、檢查或實作需求，並記錄新的決定。你將學會依專案的實際程式碼與驗證結果，判斷需求是否滿足。
你需要已安裝 Noea、至少一個狀態為就緒的 Agent，以及要處理的本機專案。若專案沒有簽到功能，可換成另一條同樣具體的規則。
開啟程式碼專案
在工作台選擇打開資料夾…，或檔案 → 打開實作資料夾…，再選取程式碼所在的資料夾。
首次開啟時，Noea 會建立連結專案。若已有專案則直接開啟；若連結多個專案，會請你選擇。其他開啟方式請參閱開啟與管理專案。
撰寫第一個意圖
點選側邊欄的新增意圖，命名為「每日簽到」。Noea 會補上 .noea.md 副檔名並開啟文件。輸入：
# 每日簽到
使用者每天可以簽到一次。連續簽到 7 天後，發放一份獎勵。
macOS 使用 ⌘S，Windows / Linux 使用 Ctrl+S 儲存。先寫已決定的內容，不必立刻列出所有邊界情況。
選擇調查或實作
解釋會檢查專案中說明需要處理的內容；段落的調查只檢查該段內容。兩者都會檢視實作，產生或更新說明，不會修改程式碼。
若已有簽到功能，點選側邊欄的解釋。若只想檢查這一段，將游標移到段落上，再點選左側的調查。
若規則仍需實作，開啟新對話，在輸入框輸入 @ 選取意圖文件，再傳送：
依引用的意圖，在這個專案實作簽到獎勵。先檢查既有程式碼，遵循專案結構，並驗證連續 7 天簽到與漏簽兩種情況。
側邊欄的實作按鈕可用時，也可使用該操作，參閱與 Agent 協作實作。Agent 工作時，對話會顯示回覆、工具呼叫及檔案變更。
實作後若未自動開始，請點選解釋。一般對話中並非每次程式碼變更都會觸發說明更新。
閱讀實作說明
返回意圖文件，點選段落內文字以外的空白處開啟側註。閱讀以下區塊：
- 實作：程式碼如何計算連續天數及發放獎勵。
- 依據：說明引用的程式碼、命令輸出或測試資料。
- 注意事項：需要你判斷的缺口、實作選擇、風險或建議。
例如，你可能發現實作以裝置時區界定日曆日。確認專案實際如何運作，以及是否符合需求。開啟引用，了解依據能支持說明到什麼程度。
說明完成不代表重新執行過測試。請區分測試程式碼、歷史結果及本次執行的驗證，參閱閱讀說明與依據。若實作未滿足原需求，應修正實作，而不是改寫規則來配合程式碼。
提問並記錄決定
將游標移到段落上，點選左側的詢問這段。Noea 會在對話輸入框插入引用。補上問題並傳送：
目前實作如何處理跨時區旅行？在兩個地點簽到會影響連續天數嗎？請根據程式碼說明。
理解行為後，決定是否限制計算方式。若要限制，傳送：
將「一天依使用者目前所在地的日曆日期計算」加入這段意圖。請先提出意圖變更讓我審閱。
Agent 提交提議後，點選查看變更，閱讀新增及替換的文字。必要時編輯新文字，再選擇接受我的編輯；不需修改時則選擇接受。
若提議需要實作，接受後會在同一對話繼續工作。若既有實作已滿足提議，則不必再次實作。之後檢查解釋任務的結果，或視需要手動調查。
確認理解的內容
結束前，儲存文件並確認說明涵蓋目前文字。試著用自己的話回答四個問題：
- 這項需求如何實作？有哪些依據支持這個結論？
- Agent 做了哪些意圖未指定的重要選擇？
- 我理解並接受這些選擇嗎？它們是否應成為長期限制？
- 下次想改變這個行為時，應修改哪一句話？
例如，你應能說明一天如何界定、找到支持依據，並指出「連續 7 天」是獎勵條件。若答案不清楚，請針對相關段落提問。
第一次使用不必記錄所有規則。遇到下一個值得保留的決定時再補上。