開始執行任務之前,請先閱讀相關的開發指南。
請執行以下步驟:
-
讀取當前任務成品:
prd.md:了解需求和驗收標準design.md(如存在):了解技術設計implement.md(如存在):了解執行順序與驗證計畫
-
探索套件及其規範層:
python3 ./.trellis/scripts/get_context.py --mode packages -
根據以下條件,判斷哪些規範適用於你的任務:
- 你正在修改哪個套件(例如
cli/、docs-site/) - 工作類型為何(後端、前端、單元測試、文件等)
- 任務成品是否引用了任何 spec/research 路徑
- 你正在修改哪個套件(例如
-
讀取每個相關模組的規範索引:
cat .trellis/spec/<package>/<layer>/index.md請遵循索引中的 「Pre-Development Checklist」(開發前檢查清單) 部分。
-
讀取開發前檢查清單中所列、且與你任務相關的特定規範檔案。索引本身並非目標——它會指向實際的規範檔案(例如
error-handling.md、conventions.md、mock-strategies.md)。請閱讀這些檔案以了解編碼標準與模式。 -
務必閱讀共享指南:
cat .trellis/spec/guides/index.md -
對於非簡單的任務,請在撰寫程式碼之前,先陳述變更邊界 (change boundary)。 非簡單任務指的是會觸及一個以上的檔案、跨越層級、變更公開介面,或修改非你剛撰寫的程式碼。請寫下:
- 當前行為與預期行為之間最小的行為差距
- 該行為實際存在的位置(而非最容易攔截的位置)
- 你預計會變更哪些檔案,以及為什麼需要變更這些檔案
- 你在本次任務中明確不處理的事項
- 如果需要在本地進行重構,你將如何證明重構並未改變行為
一個小範圍、邊界明確的變更不需要這麼做 —— 直接進行即可。
如果實際範圍明顯大於上述預估,請先說明情況及原因,再繼續進行。請不要自行擴大變更範圍。
-
了解你需要遵循的編碼標準和模式,然後繼續你的開發計畫。
此步驟在撰寫任何程式碼之前,皆為強制性。