blueprint-document-reference
用於創建、編輯和維護 Adobe 數位體驗藍圖的指南,包含標準架構、技術文檔規範及內容結構。
簡介
此技能作為技術寫作者與架構師管理 Adobe 數位體驗藍圖(Blueprints)儲存庫的權威參考。它提供了生產高品質、可重複實作藍圖所需的結構標準與編輯指南,以解決 Adobe Experience Platform 生態系統內複雜的業務與技術挑戰。此技能確保所有內容均遵守儲存庫慣例,包括 frontmatter 要求、章節排序、圖表標準以及連結至 Adobe Experience League 文件的一致性做法。
-
標準化藍圖結構,包括 H1 標題、應用程式列表、使用案例、先決條件、護欄(Guardrails)與實作步驟。
-
定義技術 frontmatter 要求,例如標題、描述、解決方案分類、exl-id 管理與 doc-type 指派。
-
執行外部文件最佳實踐,明確規範針對 API、教學與產品護欄連結至 Adobe Experience League,而非重複編寫長篇內容。
-
管理內容階層,包括儲存庫結構、TOC.md 更新以及總覽頁面與特定情境藍圖之間的區分。
-
提供架構圖模板,確保技術一致性與複雜系統及資料流整合的視覺清晰度。
-
當啟動新的藍圖文件或修改現有的技術架構頁面時,請使用此技能。
-
遵循定義的 frontmatter 架構,以確保正確的發布流程與搜尋索引。
-
請務必對照儲存庫中提供的 reference.md 檔案,了解特定的 URL 模式與連結慣例。
-
確保所有架構圖皆包含描述性替代文字(Alt Text)並遵守無障礙設計規範。
-
新增頁面時,請記得更新 help/blueprints/TOC.md 以維護儲存庫導覽的完整性。
-
優先連結至官方文件,而非撰寫自訂的技術程序,以確保資訊與產品版本更新保持同步。
倉庫統計
- Star 數
- 1
- Fork 數
- 8
- Open Issue 數
- 11
- 主要語言
- 未提供
- 預設分支
- main
- 同步狀態
- 閒置
- 最近同步時間
- 2026年5月3日 下午08:31