個人專案 是做什麼的?
這些規則適用於明確採用 personal@tj-agents 的專案。採用行為記錄了專案的個人範圍;家目錄、作者姓名或雇主關聯並不能建立此範圍。除非 Tommy 明確變更範圍,否則雇主專案仍在此設定檔之外。
保持一個當前支援的解決方案。在取代行為時,移除被取代的名稱、別名、備用實作、適配器、配置格式與相容性分支。在同一時間點協調並遷移所有已知的呼叫者、專案宣告、已安裝的註冊資訊、生成的工件以及即時執行入口點。不要為了假設的外部使用者保留已淘汰的行為;請與實際合作的開發者協調升級。
驗證使用者在每個支援平台上實際使用的入口點,包括 Windows 和 Linux 的啟動路徑(若支援)。僅靠原始碼編輯、成功的生成、通過的單元測試和版本指令並不足以證明遷移已完成。檢查已安裝的綁定以及全新的運行時行為。將任何未經驗證的入口點記錄為「不完整」,並附上其解析器與可觀察的接受條件。
例如,將 old-launch 取代為 launch 意味著遷移已註冊的 shell 指令、專案配置和實際呼叫者,刪除舊入口點,然後在每個支援的作業系統上從新的終端機階段呼叫 launch。僅執行 launch --version 並不能驗證遷移是否完成。
將 old-launch 取代為 launch:
1. 遷移已註冊的 shell 指令、配置和實際呼叫者。
2. 刪除舊入口點並重新生成已安裝的設定。
3. 從新的支援 Windows/Linux 階段呼叫 launch 並檢查其實際行為。
結果:僅執行 launch --version 會使此遷移狀態標記為不完整。
不要獨立新增向後相容性例外。將明確的相反使用者需求呈現為蓄意的政策決定,識別受影響的支援行為,並在實施前協調此設定檔的範圍。絕不要將例外隱藏在備用實作或適配器中。
以最小的合適實作來解決已證明的問題。僅為具體的當前需求新增抽象層、依賴項、配置開關、重複路徑或處理機制。優先使用專案已選用的能力。根據變更規模驗證行為與有意義的失敗路徑;不要新增僅重複實作或無具體好處的檢查清單的測試。
此政策在此處一次性撰寫。個人採用會從本文生成其標記的原生命令區塊,並檢查是否有漂移。僅選取外掛程式或 always 層級並不能證明已載入此規則。