SmallSteps｜AI 排錯回報與修正驗收
學域 Realms 編輯團隊｜2026-09-30
搭配：https://course.ray-realms.com/blog/vibe-coding-ios-app#first-run-troubleshooting

先保留目前專案副本或版本紀錄。只填確實看到的結果，未測就寫未測。
請勿貼入密碼、簽名憑證、API 金鑰或真實使用者資料；敏感值以 [已遮蔽] 代替。

一、目前卡在哪裡（選一項）
[ ] 開啟專案／找不到 scheme
[ ] 沒有執行目的地或 runtime
[ ] Build Failed
[ ] 實機 signing／provisioning
[ ] 建置成功但 App 沒出現或 crash
[ ] 畫面能操作，但資料結果不對

二、環境（照畫面填，不知道就留未知）
macOS 版本：
Xcode 版本：
打開的專案名稱：
Scheme：
執行目的地（具體模擬器／實體裝置與 iOS 版本）：
最近改動的檔案或設定：
最後一次正常版本（有才填）：

三、最短重現步驟
起始狀態（新安裝／原安裝、目前有幾筆資料）：
1.
2.
3.
預期結果：
實際結果：
是否每次發生／重現次數：
Issue navigator 第一個相關 error 完整文字、檔名與行號：
必要的前後訊息或 crash 紀錄（已遮蔽敏感資料）：

四、交給 AI 的指令
請先根據以上實際資料判斷問題層級。缺關鍵證據時，先告訴我要查看哪個畫面或檔案，不要猜成已確認原因。
提出最小修正，說明要改哪個檔案、為何有關；不要重建整個 App、刪除原資料、換 Bundle ID 或引入新服務來掩蓋問題。
保留原本新增、同名資料各自獨立、切換完成、刪除與 JSON 保存功能。
修正後列出要重跑的步驟與預期結果。你沒實際跑過的檢查標記未測，不要宣稱通過。

五、填寫示例（虛構錯誤案例，不代表下載版存在此 bug）
階段：App 能開啟，但資料行為不對。
起始：原安裝，空清單。
步驟：新增「讀 10 頁書」兩次，只點第一筆。
預期：第一筆完成，第二筆仍未完成，計數 1 / 2。
實際：兩筆都變成完成，計數 2 / 2。
交辦：請查每筆 ID 及 toggle 的尋找條件，確認不是依 title 批次更新。保留新增與 JSON 讀寫，先解釋原因再給最小修改。

六、修正後回歸紀錄（預設全部未測）
項目 | 預期 | 實際結果 | 狀態
原本失敗步驟 | 符合上面的預期結果 | 待填 | 未測
新增一筆 | 清單多一筆且輸入清空 | 待填 | 未測
空白輸入 | 不能新增且資料不變 | 待填 | 未測
兩筆同名，只完成一筆 | 另一筆狀態不變 | 待填 | 未測
重開同一安裝 | 資料與完成狀態保留 | 待填 | 未測
刪除其中一筆，再重開 | 只留下另一筆 | 待填 | 未測

狀態填：通過／失敗／未測。Build 成功不等於以上操作都通過。
重開測試需維持同一目的地、Bundle Identifier 與安裝；刪 App／重置模擬器會改變測試條件。
原檔讀不到時先保留；本地保存不是備份，也不代表跨裝置同步。

本文件是離線整理工具，不會執行指令、讀取專案或上傳資料。
Apple 官方執行／錯誤與簽名說明：https://developer.apple.com/documentation/xcode/running-your-app-on-simulated-or-physical-devices

七、拿自己的結果對照已驗證的參考版
網站2026-09-30使用公開原版ZIP，在Xcode26.3、iOS26.2、iPhone17Pro模擬器驗證：
空白不新增、新增清空輸入、同名項目狀態獨立、停止後重開保留、刪除後重開不復活、81個英文字母被長度限制阻擋。
操作畫面：https://course.ray-realms.com/blog/vibe-coding-ios-app#simulator-validation
這是該次模擬器的結果，不是你的修改版已通過；不代表實機、左滑手勢或無障礙驗收。
原ZIP仍為09-12版本；README保留最初檢查範圍，上方網址是後續補驗收收據。

你的驗收（全部從未測開始）
下載/修改版本與日期：
Xcode / 裝置 / iOS：
是否同一安裝重開、沒有刪App或清資料：待確認
新增第一筆：未測
完成第一筆，再新增同名第二筆，計數1/2：未測
停止App程序再開，兩筆狀態保留：未測
刪掉完成項目再重開，只剩另一筆且0/1：未測
證據檔名／實際與預期差異：