artifact-tracking

Artifact Tracking 技能為透過 Token 高效能文件管理軟體開發工作流程提供了強大的架構。此技能專為 Claude 等 AI 代理設計，以 YAML 與 Markdown 混合格式取代冗長的純 Markdown 追蹤記錄。透過利用機器可讀的 Frontmatter，系統使代理程式能夠進行精確的欄位層級更新與查詢，與傳統的全檔案解析相比，Token 使用量可降低 95-99%。對於旨在維護複雜、多階段專案結構而又不會觸及上下文限制或產生不必要成本的工程團隊與自主代理程式而言，這是一項必備工具。

• 透過標準化指令介面啟用 CREATE、UPDATE、QUERY、VALIDATE 與 ORCHESTRATE 操作。

• 具備結構化元資料，用於自動化的任務狀態更新、相依性管理與進度報告。

• 支援基於階段的專案文件，包含進度追蹤器、技術背景說明以及與 PRD 對齊的實作計畫。

• 透過允許代理程式僅讀取必要的機器可讀 YAML 狀態而非整個專案日誌，簡化了工作階段移交的流程。

• 與專屬代理程式（tracker, query, validator）整合，確保在整個開發生命週期中符合結構規範並產出高品質成果。

• 適用於處理長期功能開發或複雜重構任務的軟體工程師、專案負責人以及 AI 編排人員。

• 輸入要求：必須遵循特定的檔案路徑模式，例如 .claude/progress/[prd-name]/phase-N-progress.md。

• 最佳實踐：每個階段維護一個進度檔案，並使用嵌入式的 Task() 函數語法來執行一致的狀態變更。

• 限制：必須嚴格遵守文件政策規範；必須使用提供的工具驗證結構描述（Schema），以確保符合編排需求。

• 請始終呼叫合適的代理程式（例如用於更新的 artifact-tracker，或用於檢索的 artifact-query）以最大化效能並維護紀錄檔的完整性。