軟體工程
跨 UI、API、資料、作業與設定追蹤功能
單一功能的端到端追蹤,把使用者動作連到介面、API、領域邏輯、資料、非同步作業、設定與可觀察結果。
流程
照這個順序做。
- 說明功能、使用者或系統成果、版本、環境、進入事件,以及範圍內與鄰近行為的界線。
- 從介面狀態與路由追蹤互動,經過驗證、API 驗證、領域命令、查詢與資料寫入。
- 追蹤事件、佇列、排程作業、Webhook、第三方呼叫、重試,以及設定或功能開關分支直到消費者。
- 把成功、失敗、空值、權限、逾時、重複與復原狀態對應到使用者回饋、記錄、指標、追蹤與稽核資料。
- 用原始碼、測試、schema 或授權執行期證據驗證每一跳,標記未知連結,不把合理路徑當成事實。
- 辨識合約、版本、擁有權、隔離與失敗邊界,避免某一層改變時破壞功能。
- 發布順序圖或追蹤表,附原始碼位置、證據信心、缺少連結、下一步檢查與未解決風險。
先準備
貓會向你要的輸入。
- 功能定義與使用者成果
- 儲存庫版本與環境
- 介面、API、資料與作業邊界
- 必要證據與負責人
路由器 + 一份 playbook
先路由。只選一份。
Cat Paw 每次任務只載入一份 playbook,不合併多份。先走這個路由器;其餘路徑是此 workflow 可檢查的候選。
- 路由器:
code-graph-pack skills/code-graph-pack/cross-layer-feature-trace/SKILL.md
界線
界線跟著提示一起走。
- 開始前先核實實際的工具、帳戶、權限與工作區;絕不聲稱擁有不可用的工具、帳戶、來源或能力。
- 私有程式碼、成品、即時探測或非公開資料請使用 Latch/target-workspace;若無法存取,就在邊界停下並回報阻礙,不可改用猜測。
- 任何有後果的外部行動前先暫停並取得明確核准;回傳證據、未解決風險、假設,以及仍在等待核准的行動。
完成代表
一個可核對的終點。
跨層功能追蹤把使用者動作連到介面、API、領域、資料、作業、設定與可觀察性,並附原始碼證據與明確缺口。
來源
這個流程從哪來。
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- c4model.com/
- github.com/open-telemetry/semantic-conventions-genai
來源確立 workflow 的模式。若有 Reddit 或社群貼文,視為實務軼事,不是普遍事實。