營運
記錄並限定刻意的技術捷徑
有界限的清單,將每個刻意妥協連到負責人、觸發、遏制、到期與驗證,而不是把它藏成一般清理。
流程
照這個順序做。
- 記錄捷徑、它促成的決策、日期、系統邊界、接受它的人,以及當時可用的證據。
- 將債務分類為安全、可靠性、可維護性、合規、成本或交付壓力,並描述它造成的具體故障或成本。
- 定義遏制、監控、替代方案、資料或服務上限,以及會使捷徑變得不安全的可觀察訊號。
- 指定負責人、複核日期、退役條件、依賴,以及尚無法償還的風險之接受路徑。
- 追蹤捷徑如何影響未來變更、事件回應、導入與合規,再依主動風險而非一般整潔優先排序。
- 安排清償、替換或明確接受,記錄決策與證據,不把妥協悄悄轉成要求。
- 複核清單,標示逾期或累積項目,將現況、證據、已接受風險與未解決風險交給負責人。
先準備
貓會向你要的輸入。
- 捷徑說明與理由
- 受影響的服務或儲存庫
- 風險負責人與接受權責
- 監控與複核證據
路由器 + 一份 playbook
先路由。只選一份。
Cat Paw 每次任務只載入一份 playbook,不合併多份。先走這個路由器;其餘路徑是此 workflow 可檢查的候選。
- 路由器:
minimal-code-pack skills/minimal-code-pack/technical-shortcut-debt-ledger/SKILL.md
界線
界線跟著提示一起走。
- 開始前先核實實際的工具、帳戶、權限與工作區;絕不聲稱擁有不可用的工具、帳戶、來源或能力。
- 私有程式碼、成品、即時探測或非公開資料請使用 Latch/target-workspace;若無法存取,就在邊界停下並回報阻礙,不可改用猜測。
- 任何有後果的外部行動前先暫停並取得明確核准;回傳證據、未解決風險、假設,以及仍在等待核准的行動。
完成代表
一個可核對的終點。
清單為每個刻意捷徑提供有界限的風險、遏制、負責人、到期或接受條件、驗證訊號,以及有證據支持的現況。
來源
這個流程從哪來。
- github.com/DietrichGebert/ponytail/tree/e3ba2aa6f1e6f0bc4d69eb09c9f0d0a93af56156/
- martinfowler.com/bliki/TechnicalDebt.html
- sre.google/sre-book/release-engineering/
來源確立 workflow 的模式。若有 Reddit 或社群貼文,視為實務軼事,不是普遍事實。