第 0 章 · 入門
認識 Cursor：它是 AI Editor，不是 CLI
Cursor 把 AI 放在程式編輯器的檔案樹、編輯區、終端機與 Diff 附近。它能協助理解與改動專案，但你仍要決定範圍、核對變更並執行驗證。
開始前／前置：Cursor、VS Code 與 CLI agent 的分工
| 工具 | 最適合先做什麼 | 你要保留的責任 |
|---|---|---|
| Cursor | 看著檔案、局部編輯、查看 Diff、在同一工作區討論修改。 | 選檔案、審查改動、決定能否執行。 |
| VS Code | 一般編輯、擴充功能、除錯與原始碼瀏覽。 | 同樣由你管理專案與版本控制。 |
| CLI agent | 終端機導向、腳本化或既有命令列流程。 | 設定權限、命令邊界與工作目錄。 |
它們可搭配，卻不是彼此的別名。當你需要一邊讀檔一邊看修改，Cursor 很合適；當任務涉及不可逆操作、機密或公司流程時，先確認該流程允許的工具與權限。
本章目標與操作步驟：用可逆性選第一個任務
- 寫下小任務。例如說明 README 的啟動步驟，或把一個按鈕文字改得更清楚；不要以重構整個專案開始。
- 標出不可碰範圍。例如不改 lockfile、不碰 secrets、不送出 commit、不部署。
- 指定驗收。例如 Diff 只出現在一個檔案、既有測試通過，或你能在瀏覽器看見文字。
預期結果
你得到一個可描述、可檢查、可復原的任務，而不是把「幫我做完」交給不明確的代理。
卡住時／失敗與復原
若你不知道專案是什麼、哪些檔案能改，先不要開 Agent。改成請它只讀取與摘要，或回到第 1 章建立練習場。若已產生不確定的修改，先看 Diff；不能判斷就不要接受，回復該變更或在乾淨工作樹重新開始。
官方 Cursor 的Quickstart以了解 codebase、小型安全任務、查看 diff 與檢查為起點。