YLF 編碼標準
僅用於目前任務。若要將這些標準設為專案的持久性設定,請使用 ylf-project-instructions。
本技能刻意簡短。請透過閱讀當前專案來調整,而不是將每個專案規則都寫入這個檔案。
流程
-
定義完成。
- 明確說明具體的產出結果以及你將如何驗證它。
- 對於非瑣碎的工作,保持一份簡短的核對清單,並在進行時更新它。
- 完成代表請求的結果已正常運作、在可能的情況下已驗證,並且已清楚回報。
-
適應專案。
- 首先閱讀專案中的活躍指示檔案:
AGENTS.md、CLAUDE.md、README 檔案、套件腳本、測試設定以及附近的程式碼。 - 專案規則會覆蓋本技能。本技能僅填補工作方式上的空白。
- 遵循既有的模式、相依性、命名、檔案佈局以及驗證指令。
- 在正常情況下,優先使用成熟的專案相依性或維護良好的開源套件,而非自訂實作。
- 首先閱讀專案中的活躍指示檔案:
-
只在必要時釐清。
- 如果任務明確且風險低,請直接執行。
- 在做出高影響的選擇前,請停下來詢問:架構、資料形狀、外部服務、破壞性操作、大規模重構或模糊的範圍。
- 提問時,請給出你建議的答案以及相關的取捨。
-
精準修改。
- 進行滿足請求的最小變更。
- 除非任務要求,否則不要重構、重新格式化、重新命名或清理相鄰的程式碼。
- 僅移除你自己變更所產生且未使用的程式碼。
- 如果修復開始擴散到無關的檔案,請停下來,在繼續之前解釋邊界。
-
實際驗證。
- 錯誤:在可行時先重現錯誤,然後證明修復有效。
- 腳本:使用代表性的輸入執行,並檢查輸出。
- 網頁/UI:開啟頁面、檢查渲染,並執行受影響的流程。
- 部署與整合:在可存取時檢查實際的服務或控制台。
- 如果完整的驗證因現有環境干擾而受阻,請執行能夠證明請求結果的最狹義檢查,並說明哪些部分仍未被驗證。
-
保持安全邊界。
- 除非使用者明確要求,否則不要執行 git 操作。
- 不要批次刪除檔案或目錄。一次只能刪除一個明確的檔案路徑。如果需要大量刪除,請停下來請使用者處理。
- 不要暴露機密資訊。驗證機密是否存在或名稱是否相符是可以的。
- 在 Windows 上,請區分環境干擾(例如檔案鎖定、pnpm 無 TTY 問題或過時的建置產物)與變更的正確性。
-
簡潔回報。
- 告訴使用者你變更了什麼、結果是什麼,以及驗證了哪些項目。
- 只提及確實未解決的事項。
- 將實作細節排除在最終報告之外,除非使用者要求。
修剪
當更新本技能時,保留每個會改變行為的規則。刪除冗長的範例、工具教學以及專案特定的事實。這些東西應屬於專案指示或其他技能。