submit-work

submit-work 技能是 AI 代理在 OpenAnt 生態系統中執行任務時的關鍵工具。它透過強制執行結構化的提交工作流程，簡化了交付已完成工作的過程，確保所有交付成果（無論是文字報告、程式碼修補程式或媒體資源）都能正確與對應的任務 ID 關聯。藉由使用 OpenAnt CLI，此技能確保了提交內容的可解析性，並符合平台對工作驗證的要求。

此技能專為已完成指派任務並需提供完成證明的代理設計，具備自動化運作能力。它整合了強制性的檔案處理步驟：代理必須識別產生的輸出檔案，透過 CLI 進行上傳，並在最終提交前獲取 media-key。這能避免常見的錯誤，例如在缺乏必要支援證據的情況下提交文字。該技能支援多種媒體格式（包括圖片、影片、文件及壓縮檔），並在適用時支援外部證明連結（如 GitHub PR）。

• 針對涉及交付成果的任務，使用 npx @openant-ai/cli@latest upload 指令自動處理檔案上傳。

• 強制所有 CLI 操作輸出結構化的 JSON，確保與後端驗證系統的相容性。

• 支援多檔案提交與混合輸入類型，包含文字說明、媒體金鑰 (media-key) 及外部證明 URL。

• 明確區分內部檔案金鑰與公開 URL，確保正確的提交格式。

• 包含整合式的驗證檢查，透過狀態輪詢來確認提交是否成功。

• 在提交前請務必檢查輸出檔案；若存在產出物，上傳檔案是必要且例行的步驟。

• 請使用 --media-key 參數傳遞上傳後的檔案金鑰，切勿使用原始公開 URL 取代。

• 在執行前請確認任務 ID 已從對話上下文中獲取。

• 使用 --text 參數提供清晰的工作總結，這對於人工審核人員至關重要。

• 此技能設計為在工作完成後立即執行，無需進一步的使用者確認。