討論與審閱意圖變更 — Noea Code 文件

討論產生新的產品決策時，請 Agent 將它轉為意圖提議。審閱文字、視需要調整，再決定是否寫入文件。

從具體上下文開始

將游標移到相關段落上，選擇左側的詢問這段。Noea 會將引用插入輸入框，並在對話旁顯示文件，不會自動傳送訊息。

也可在輸入框輸入 @ 搜尋文件、段落或說明。選取內容會顯示為引用標籤，隨訊息提供給 Agent。

例如：

這條獎勵規則未說明漏簽後如何處理。請根據實作解釋目前行為，再討論是否應允許補簽。

做出決定後，再要求提議：

將「每月允許補簽一次」加入這條規則。請提出意圖變更讓我審閱。

意圖與實作不一致時，先問原需求是否仍成立。假設文件要求連續簽到 7 天發獎，但程式碼在第 6 天就發放：

你的決定	下一步
需求仍是 7 天。	保留意圖，請 Agent 修正實作並驗證邊界。
討論後決定改為 6 天。	修改意圖，審閱新的觸發條件並檢查實作。

不要只為遷就現有程式碼而改寫意圖。先確認 Agent 理解需求，再檢查程式碼是否滿足。釐清誤解、修正實作錯誤，只有決定改變規則時才修改意圖。

要求修正時，請明確說：

保留 7 天的需求。修正提早發獎，驗證第 6 天不發、第 7 天才發，不要為配合目前程式碼而修改意圖。

建議卡片記錄 Agent 認為值得加入意圖的內容。採納會在目前對話開始工作，將它轉為既有實作已滿足的提議，不會直接寫入意圖。忽略則記錄你不採用這項建議。

提議包含待審閱的具體文件變更。Agent 提交後，卡片會在目前回合完成、停止或失敗時出現。選擇查看變更即可檢查。

審閱畫面保留文件版面。新增文字有淡綠背景，刪除文字有淡紅背景與刪除線。替換會同時顯示舊、新文字，適合時突出顯示詞語層級的差異。

使用底部審閱列在變更間移動，或選擇檔名切換文件。一次決定適用整份提議及其所有檔案，無法個別接受段落或檔案。

你可以編輯新增文字及替換中的新文字。原文字、刪除內容及未受影響段落在此狀態不可編輯。編輯後，主要操作會改為接受我的編輯。

決定前，不只看哪些字改了，也要檢查它們要求什麼：

不清楚的地方，請返回對話要求 Agent 解釋或修訂提議。

希望決策指導未來開發時，請接受已審閱的內容。直接實作不會將要求記錄為意圖。

忽略提議不會撤銷已完成的程式碼變更。例如，Agent 可能先完成工作，再提議將現有行為記錄下來。

Agent 可在同一對話修訂提議。新版會取代待審閱版本，舊卡片保留版本提示。舊審閱中尚未接受的編輯不會自動帶入。

若目前文件不再符合提議的起始文字，接受會停用。請使用請 AI 代理依目前版本重新提議，讓 Agent 重讀文件並產生可套用的變更。

仍需實作的提議會在目前對話繼續。若未完成，可用卡片上的繼續實作。之後返回文件檢查說明，未更新時手動執行解釋。

若不想自動開啟審閱，關閉設定 → 目前專案 → 自動化 → 自動打開審閱，再從提議卡片進入。此設定只控制開啟審閱，不控制接受提議。