artifact-storage-policy git:20260914.4f9978aA

Immutable. This exact content is served forever at /api/v1/blob/6b64e12c5a76e4cd.

---
name: artifact-storage-policy
description: 管理 Codex 交付物的專案識別、Google Drive／GitHub 路由、檔名、儲存位置與回讀驗證；凡工作報告、外部保存、交付成果或新 repository 選擇涉及遠端儲存時使用。
---

# 交付物儲存政策

## 目的

先確認專案、目的地與既有位置，再建立或寫入外部交付物。此 Skill 是工作報告、Google Drive 保存與 GitHub repository 選擇的共同政策；不負責搬移歷史檔案，也不取代平台專用工具。

## 觸發條件

- 產出或保存工作報告、設定改版、稽核結果或其他正式成果。
- 使用者要求保存到 Google Drive、GitHub，或同時保存到兩者。
- 需要選擇新 repository、專案資料夾或交付目錄。
- 需要判斷是否沿用既有專案、分支或版本。

## 外部平台分流

- Codex 交付物放在 Google Drive 的 `CODEX/<project folder>/`；Antigravity 交付物放在其指定 Drive folder；兩者不得互相覆寫。
- GitHub 交付物沿用既有專案 owner/repository 與非保護分支；不要因單一任務建立重複 repository。
- 正式交付、多檔案成果或外部上傳才建立完整交付物索引；單一本機小改且沒有交付要求時，簡短回報即可。

## Input Schema

需要建立完整 routing ledger 或交付物索引時，讀取 [references/storage-contract.md](references/storage-contract.md)。一般單一目的地工作不必載入 schema。

## Resolution Workflow

1. 搜尋既有專案名稱、別名、近期交付物、Drive 資料夾與 GitHub repository；不得只依任務標題猜測。
2. 確認 Google Drive 的 `CODEX` 根資料夾 ID、專案資料夾 ID、完整路徑與寫入權限；Drive 根目錄或 `My Drive` 根目錄不是合格目的地。
3. 確認 GitHub owner、repository、目前分支與既有相關 repository；同一專案優先沿用既有 repository，不因日期或單一任務建立新 repo。
4. 判斷關係：`new`、`continuation`、`branch` 或 `related`。若無法判斷，標記 `needs_review`，不得自行建立新位置。
5. 檔名使用繁體中文，至少包含專案／功能、用途與建立日期；避免只用 `report.md`、`final.docx`、`output.txt`。
6. 寫入後必須讀回 metadata／內容，核對實際 parent、完整路徑、檔名、URL、MIME／大小與 repository／分支。
7. 發現錯放、重複、檔名不合規或無法回讀時，狀態為 `needs_repair` 或 `failed`，不得報告為完成。移動、重新命名、覆蓋、刪除或權限變更需另有明確授權。

## 交付物索引與摘要錨點

- 每次產出、修改、上傳或寄送檔案，都要建立可直接放入最終回覆與工作報告的「交付物索引」；每個檔案一列，不得只列來源或工具名稱。
- 索引至少包含：檔名、用途、本機完整絕對路徑、實際 URL、Drive 完整路徑／parent ID 或 GitHub repository／branch、狀態與驗證結果。
- 本機不存在、尚未保存或無法驗證的欄位必須明確標示 `不適用`、`尚未保存` 或 `未驗證`；不得推測路徑、組合未回讀的 URL 或把來源資料當成交付物。
- 長任務、上下文壓縮或交接摘要時，優先保留這份索引與未完成項目。若平台摘要 UI 只顯示來源，主要回覆仍必須保留完整索引。

## Date and historical-file rules

- 新交付物的檔名使用實際建立日期。
- 同一專案的既有頂層資料夾應沿用；若需要更新頂層日期，先提供舊名／新名／影響範圍並取得明確核准。
- 本 Skill 不自動搬移、重新命名、刪除或覆蓋歷史檔案；錯放項目只列為候選清單，另案處理。
- 新資料夾只有在已確認 `CODEX` 根、專案不存在、關係為 `new` 且使用者授權寫入時才能建立。

## Fail-closed conditions

任何一項無法確認時停止遠端寫入：`CODEX` 根、專案識別、目標 parent、repository、沿用／新建關係、寫入權限、寫入後 metadata／URL／內容回讀。

## Audit fields

每次交付至少保留：實際使用的 Skill／Workflow／Agent、Drive 完整路徑與 parent ID、GitHub owner/repository/branch、每個 artifact 的檔名與 URL、四層驗證結果、未解決項目。