程式設計
將此技能作為軟體工作的入口點。保持此文件的上下文,然後載入任務所需的最小相關參考集。
路由
- 如需編寫新程式碼或擴展行為,請閱讀
./references/implementation.md。 - 如需重構、清理、簡化、提取、重組或重寫工作,請閱讀
./references/refactoring.md。 - 如需程式碼審查、PR 審查、差異評論或風險評估,請閱讀
./references/review.md。 - 如需除錯、測試失敗、回歸、執行時期錯誤、CI 失敗或錯誤修復,請閱讀
./references/debugging.md。 - 如需架構、API 設計、模組邊界、依賴方向或純設計討論,請閱讀
./references/design.md。 - 如需共享程式碼品質規則,請在撰寫或修改程式碼時閱讀
./references/standards.md,並在審查/設計期間按需閱讀。 - 如需斷言策略(不變量檢查、除錯與生產斷言決策以及快速失敗契約),請在撰寫或審查驗證內部假設的程式碼時閱讀
./references/assertions.md。
僅載入使用者當前請求所需的參考資料。如果任務有多個階段,請在該階段開始時載入下一個參考資料。
基準規則
- 正確性、安全性和使用者意圖優先於風格偏好。
- 專案格式化工具、linter、測試、建置系統、框架慣例以及系統性的本地模式優先於此技能的預設標準。
- 當一個本地模式在多個相鄰檔案中出現、由工具強制執行、或是某個明確的框架/應用慣例的一部分時,它即為系統性模式。請勿僅僅因為相鄰而複製一次性的弱程式碼。
- 當不存在系統性的專案模式時,請使用
./references/standards.md。 - 保留公開行為、API、資料合約、遷移和操作語義,除非使用者明確要求更改。
- 保持修改範圍限定在任務內。改善所觸及的程式碼,使其達到足夠連貫的結果,但不要規範化無關的舊版程式碼。
範例查詢
僅在規則決策不明確時使用範例。
./examples/README.md索引了重點範例。- 一次開啟一個匹配的範例檔案。