Community程式設計與開發github.com

個人專案

明確採用個人專案的強制性當前解決方案與比例工程規則。

個人專案 是什麼?

此技能定義了一套強制性規則,適用於明確採用「personal@tj-agents」的個人專案。其核心目的是強制執行「保持一個當前支援的解決方案」原則,避免因保留已取代的行為(如舊名稱、別名、相容性分支等)而增加維護負擔。規則要求開發者完成完整的系統遷移,包括更新所有已知的呼叫者、專案配置、已安裝的註冊資訊、生成的工件和運行時入口點,並在每個支援的平台上(如 Windows 和 Linux)驗證入口點。此外,它強調「最小可行實施」,反對為了不存在的需求引入抽象層、依賴項或過度設計,並主張以與變更規模相符的方式驗證行為與失敗路徑。此技能最適合用於個人實驗性專案或嚴格控制範圍的個人工具,幫助開發者將注意力集中在解決當前實際問題上。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tj-agents/personal/tree/HEAD/.agents/personal/policy/current-solution

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

個人專案 是做什麼的?

這些規則適用於明確採用 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 層級並不能證明已載入此規則。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能