工程開發
blueprint-document-reference avatar

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
在 GitHub 查看