treeturtlefall-arch/skill

film-date-agent

為 AI 代理程式提供從指令到結果的完整流程，將底片相機的石英日期（日期戳記）以物理光學曝光方式燒印到圖片上。物理繪圖由物理光學模擬引擎（FilmDateStamp）執行，此技能定義了「一經要求，便毫不猶豫地使用最佳預設值與日期進行燒印，並正確回報結果」的準則。

工具

• 命令：film-date-agent（或 python -m film_date_agent）
• 安裝確認：film-date-agent doctor 所有項目皆為 [OK]
• 預設值：預設使用 favorite（最愛）。實際內容由 favorites.json 決定（預設為 Japanese Snap (Disposable)：仿寫ルンです風格、橘色發光、5x7 膠囊點陣、同時顯示時分）。

未安裝或找不到命令時

• 若 film-date-agent 不存在，或 doctor 未通過，請先進行安裝。若已克隆儲存庫（https://github.com/treeturtlefall-arch/FilmDateStamp-agent），請執行 bash scripts/install_agent.sh，接著執行 bash scripts/install_skill.sh 重新部署此技能。
• 安裝完成後再次執行 film-date-agent doctor --json，確認 "ok": true 後再回到本程序。

觸發詞（遇到以下指示即觸發）

• 「在照片上加上日期戳記」「加入底片風格的日期」「加入復古日期」
• 「弄得像寫ルンです一樣」「加入 90 年代風格的日期」「弄成 80 年代單眼相機風格」
• 「燒印拍攝日期」「加入 EXIF 的日期」
• 「也加入日期和時間」
• 在圖片生成或編輯完成後，若被要求「壓上日期戳記」，也適用此技能。

執行步驟

1. 確認目標圖片：

   • 找出對話中提及的圖片，或剛生成／編輯過的圖片。若不清楚，請勿擅自猜測，應向使用者確認。

2. 選擇預設值與參數：

   • 若無特別指定：使用預設的最愛（favorite）。

     film-date-agent apply <目標圖片> --json
     

   • 若有指定世界觀、時代或風格：
     • 「寫ルンです風格」「拋棄式相機風格」：--preset japanese-snap-disposable（橘色發光・5x7 膠囊點陣・同時顯示時分）
     • 「90 年代日本」「東京快照」：--preset japanese-tokyo-90s（琥珀色發光・80s 7 段顯示器）
     • 「美國風格」「西海岸」：--preset american-west-coast（金黃色・月日年順序）
     • 「80 年代汽車旅館」「紅色 LED」：--preset american-80s-red-quartz（石英紅・單眼相機直立 7 段顯示器）
     • 「歐洲」「巴黎/柏林」：--preset european-classic-parisberlin（點分隔・低調曝光）
     • 「2000 年代初期」「早期數位相機」：--preset y2k-digicam-early-2000s（等寬液晶字體）
     • 「70 年代」「經典相機」：--preset monochrome-70s-canodate-e 或 --preset vintage-70s-color-datematic（機械式雕刻字體）
     • 「賽博」「科幻電影」：--preset cyber-telemetry-80s-sci-fi（賽博綠 HUD）
     • 「平成復古」「大頭貼風格」：--preset y2k-pop-heisei-fancy（霓虹粉圓體）

3. 組合日期與時間選項：

   • 若無指定（預設）：在最愛模式下，依 favorites.json 的 date 設定（初始值為 photo）自動決定，優先順序為 EXIF 拍攝日期 → 檔案產生／更新時間 → 目前時間。其他預設值則使用各預設值本身的預設日期。
   • 若想使用照片的拍攝日期：
     • 「用拍攝日期」「用 EXIF 的日期」→ 指定 --date photo（自動從 EXIF 提取拍攝日期）。
   • 若指定特定日期：
     • 「設為 1998 年 12 月 24 日」→ -d "'98 12 24" 或 --at 1998-12-24
     • 「2004 年 8 月 15 日 14:30」→ --at 2004-08-15T14:30 --show-time
   • 若想使用今天的目前時間：
     • 「用今天的日期」「用現在的時間」→ --date auto
   • 顯示／隱藏時間（HH:MM）：
     • 「也顯示時間」「顯示幾點幾分」→ --show-time
     • 「只要日期」「不需要時間」→ --no-time
   • 若想要隨機的復古日期：
     • 「隨便一個過去的日期」「隨機」→ --date random

4. 回報結果：

   • 解析 --json 的輸出，若 ok 為 true，則將 output 中的圖片路徑提供給使用者並回報。
   • 附帶說明實際燒印的日期字串（date_text）及套用的風格（preset_resolved）。
   • 例如：「已使用 90 年代東京快照風格（Japanese Tokyo 90s），燒印拍攝日期 '03 10 02 17:49。」

5. 錯誤處理：

   • 結束代碼 2（設定錯誤）：執行 film-date-agent presets list 查看可用預設值並重新選擇。
   • 結束代碼 3（輸入檔案不存在）：檢查輸入圖片的路徑。
   • 結束代碼 4（輸出檔案重複）：預設會自動產生連續編號（_stamped_1），但若需覆蓋，請加上 --overwrite。
   • 結束代碼 5（引擎失敗）：檢查 film-date-agent doctor 的結果並向使用者回報。

若被問到「能做到什麼？」時

1. 執行 film-date-agent capabilities --json，根據最新功能列表回答。
2. 說明範本：
   • 這是一個模擬將光線燒印到底片乳劑（物理光學曝光、中心過曝、光暈擴散）的工具。
   • 提供 12 種依時代和地區區分的預設風格（90s 東京快照、寫ルンです風格、西海岸、80s 紅色 LED、早期數位相機等）。
   • 日期可選擇照片的 EXIF 拍攝日期、目前日期時間、隨機復古日期，或任意指定的字串。
   • 可建立使用者偏好的設定並儲存為「最愛（favorite）」。

注意事項

• 請勿直接覆蓋原始圖片（不要在 -o 中指定與輸入圖片相同的路徑）。
• 回報時應以 JSON 中的 output 為準，請勿猜測檔名。