軟體工程
繪製程式碼變更的影響半徑
變更影響圖,沿著呼叫端、依賴、資料、部署、測試與客戶路徑追蹤擬議差異,在實作前揭露隱藏後果。
流程
照這個順序做。
- 界定擬議變更、基準與目標版本、預期成果、範圍內檔案、假設,以及地圖必須支援的決策。
- 檢查差異與直接相依者,使用可用工具搜尋呼叫端、匯入、介面、產生程式碼、設定與測試。
- 以靜態證據追蹤 API、資料讀寫、佇列、作業、權限、功能開關、部署設定與客戶可見路徑的影響。
- 對應負責人、測試涵蓋、可觀察性、依賴與遷移限制,將每個受影響面分類為直接、可能、尚可能或未知,並把靜態證據與執行期假設分開。
- 找出驗證、無障礙、相容性、回復與可觀察性缺口,提出最小且安全的檢查,但不要在此執行測試、套件指令或執行期路徑。
- 彙整影響與可逆性,標示敏感資料與不可信程式碼;若需要測試或套件指令,另行取得執行核准。
- 把地圖與不含秘密的原始證據存到 Latch 目標工作區,回報涵蓋限制與未解決風險,映射本身不得改變儲存庫或遠端狀態。
先準備
貓會向你要的輸入。
- 基準與目標版本或差異
- 預期變更與範圍
- 執行期與部署脈絡
- 風險容忍度與複核負責人
路由器 + 一份 playbook
先路由。只選一份。
Cat Paw 每次任務只載入一份 playbook,不合併多份。先走這個路由器;其餘路徑是此 workflow 可檢查的候選。
- 路由器:
code-graph-pack skills/code-graph-pack/code-change-blast-radius-map/SKILL.md
界線
界線跟著提示一起走。
- 開始前先核實實際的工具、帳戶、權限與工作區;絕不聲稱擁有不可用的工具、帳戶、來源或能力。
- 私有程式碼、成品、即時探測或非公開資料請使用 Latch/target-workspace;若無法存取,就在邊界停下並回報阻礙,不可改用猜測。
- 任何有後果的外部行動前先暫停並取得明確核准;回傳證據、未解決風險、假設,以及仍在等待核准的行動。
完成代表
一個可核對的終點。
靜態證據地圖追蹤指定差異經過程式碼、資料、依賴、部署、測試與使用者,並列出排序風險、建議檢查、涵蓋限制與未解決風險,且不改變儲存庫或遠端狀態。
來源
這個流程從哪來。
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review
- c4model.com/
來源確立 workflow 的模式。若有 Reddit 或社群貼文,視為實務軼事,不是普遍事實。