G4:規格識別
「登入規格」在多個版本存在時是模糊的。基於檔案路徑的引用在規格重新命名或移動時會斷裂。AI 代理也無法可靠地連結相關規格。
唯一識別碼解決這個問題。無論規格檔案如何重組,ID 保持不變,交叉引用不會斷裂。工具可以自動建立相依性圖,變更某個規格時立即識別所有受影響的規格。
原則
- 所有規格應該 (SHOULD) 以唯一識別碼區分,並得 (MAY) 使用基於領域的命名空間進行組織。
無論規格檔案如何重組,ID 保持不變,交叉引用不會斷裂。工具可以自動建立相依性圖,變更某個規格時立即識別所有受影響的規格。建議格式:[領域]-[類型]-[序號],例如 AUTH-SPEC-001、PAY-API-003。識別碼應儲存在 frontmatter 的 id 欄位,中央註冊表對應 ID 到當前檔案位置。