git:20260824.a77ebbb to git:20260914.479df21

1 added, 74 removed. Audit A to A.

---

name: artifact-storage-policy

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

---

# 交付物儲存政策

## 目的

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

## 觸發條件

- 產出或保存工作報告、設定改版、稽核結果或其他正式成果。

- 使用者要求保存到 Google Drive、GitHub，或同時保存到兩者。

- 需要選擇新 repository、專案資料夾或交付目錄。

- 需要判斷是否沿用既有專案、分支或版本。

## Input Schema

- ```yaml

- storage_request:

- task: ""

- project_key: ""

- aliases: []

- destinations: [google_drive|github]

- artifacts: [{purpose: "", filename: ""}]

- date: "YYYY-MM-DD"

- user_authorized_write: false

- ```

+ 需要建立完整 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`，不得報告為完成。移動、重新命名、覆蓋、刪除或權限變更需另有明確授權。

- ## Output Schema

- ```yaml

- routing:

- task: ""

- date: ""

- lane: fast|slow

- workflow: project-delivery-orchestrator

- skills_invoked: []

- agents_invoked: []

- storage:

- project_key: ""

- relationship: new|continuation|branch|related|needs_review

- platform: google_drive|github|both

- drive:

- expected_root: CODEX

- expected_project_folder: ""

- expected_parent_id: ""

- actual_parent_id: ""

- actual_path: ""

- root_leak_detected: false

- reused_existing_project_folder: false

- duplicate_project_folders_found: []

- top_folder_date_before: ""

- top_folder_date_after: ""

- placement_verified: false

- github:

- expected_repo: ""

- actual_repo: ""

- reused_existing_repo: false

- new_repo_reason: ""

- duplicate_or_related_repos_found: []

- placement_verified: false

- artifacts:

- - purpose: ""

- expected_filename: ""

- actual_filename: ""

- local_path: ""

- url: ""

- storage_path: ""

- parent_id: ""

- repository: ""

- branch: ""

- status: created|updated|not_saved|needs_repair|failed

- verification: ""

- created_at: ""

- filename_language: zh-TW

- project_in_filename: false

- purpose_in_filename: false

- creation_date_in_filename: false

- naming_verified: false

- validations:

- routing_ledger: pass|fail|not_applicable

- content: pass|fail|not_run

- format: pass|fail|not_run

- remote_exists: pass|fail|not_run

- permission: pass|fail|not_run

- storage_location: pass|fail|not_run

- project_reuse: pass|fail|not_run

- filename_policy: pass|fail|not_run

- top_folder_date: pass|fail|not_run

- unresolved: []

- ```

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

- 每次產出、修改、上傳或寄送檔案，都要建立可直接放入最終回覆與工作報告的「交付物索引」；每個檔案一列，不得只列來源或工具名稱。

- 索引至少包含：檔名、用途、本機完整絕對路徑、實際 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、四層驗證結果、未解決項目。