Communitygithub.com

Memento

將真實照片轉換為角色參考表、基礎影格以及可直接貼到Dreamina (Seedance) 的影片提示,專為Codex設計的技能。

Memento 是什麼?

Memento 是一個專為 AI 代理(如 Codex、Claude Code)設計的技能,能將使用者的真實照片轉變為結構化的參考素材、角色/物品/環境設定表、基礎影格,以及可直接用於 Dreamina (Seedance) 影片生成的提示。此技能的核心價值在於為個人回憶或受訪者提供一個完整的、具隱私意識且可重複執行的「回憶轉影片」工作流程。它支援的階段包括 S0(專案啟動)、S1(照片清點)、S2(訪談與劇本討論)、S3(參考表生成,包含影像生成能力探測)、S3.5(微編輯循環,支援 Cowart 或對話式迭代)、S4(Dreamina 提示撰寫,包含字數限制與上傳表),以及 S5(根據使用者反饋進行迭代微調)。技能強調狀態持久化,所有資料都儲存在 `memento/<slug>/memento.yaml` 中,便於中斷後繼續。它嚴格遵守操作合約,保障使用者隱私,並在使用者同意前不會複製或上傳任何照片。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add Lego1997/memento

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Memento 是做什麼的?

操作合約

  • 將呼叫視為自然語言,包括符合描述的隱含請求。
  • 將所有持久性狀態保留在 memento/<slug>/memento.yaml 中,以便任何階段都可以恢復或跳過。
  • 預設情況下就地引用來源照片;在將任何照片複製到 sources/ 之前,需取得明確同意。
  • 在將選定的照片傳送給 OpenAI 生成圖像之前,需取得明確同意。
  • 說明 Dreamina 會收到使用者之後上傳的任何內容。
  • 僅將此技能用於使用者自己的回憶或已取得同意的參與者。
  • 除非使用者更改,否則保留已說明的身份、服裝、道具、關係和地點事實。
  • 如實報告平台或內容審查的拒絕;切勿為了繞過拒絕而悄悄替換事實。
  • 除非使用者明確要求,否則生成英文提示和檔案。
  • 如果缺少所需的參考檔案,請報告確切路徑,並避免憑空捏造其事實。

參考路由

狀態結構

使用以下形狀作為最小清單;僅在需要時添加簡潔的備註。

memory:
  title: ""
  slug: ""
  created_at: ""
  current_stage: "S0"
  status: "in_progress"
  treatment_confirmed: false
privacy:
  copy_sources_consent: false
  render_upload_consent: null
interview:
  treatment: ""
  boundaries: ""
sources:
  - id: "src01"
    path: "/absolute/or/user-provided/path.jpg"
    handling: "referenced"
    notes: ""
assets:
  - id: "asset01"
    type: "raw_photo"
    path: "/absolute/or/project/path.png"
    role: "identity reference for..."
    source_ids: ["src01"]
    approval_state: "proposed"
    dreamina_tag: ""
    prompt_char_count: null
clips:
  - id: "clip01"
    title: ""
    model: "Seedance 2.0"
    ratio: "16:9"
    duration: "15s"
    spatial_law: ""
    first_frame_asset: ""
    last_frame_asset: ""
    prompt_char_count: null
rendering:
  capability_probe:
    session_id: ""
    status: "unknown"
    checked_at: ""
    notes: ""

使用 approval_state: proposed | rendered | approved | rejected | skipped。 使用 type: raw_photo | character_sheet | item_sheet | environment_sheet | base_frame | match_frame | micro_edit。 在有用時記錄參考表提示的字元數,並為每個 Dreamina 片段提示記錄。

S0 開始

  1. 決定是開始一個新的回憶還是恢復現有的 memento/<slug>/memento.yaml。
  2. 根據使用者的短語、資料夾名稱、日期或簡潔標題為回憶建立 slug。
  3. 使用小寫 ASCII、連字符分隔,並在衝突時添加數字後綴。
  4. 在當前工作空間中建立專案骨架:
memento/<slug>/
  memento.yaml
  .gitignore
  sources/
  sheets/
  1. 必要時在 sources/ 和 sheets/ 內建立 .gitkeep 檔案。
  2. 寫入 .gitignore:
sources/*
sheets/*
*.jpg
*.jpeg
*.png
*.heic
*.webp
*.mov
*.mp4
!sources/.gitkeep
!sheets/.gitkeep
!memento.yaml
!dreamina_prompts.md
  1. 將使用者提供的媒體路徑記錄在 memento.yaml 中,handling 設為 referenced。
  2. 只有在取得明確同意後,才將來源媒體複製到 sources/ 中,然後更新 handling 為 copied。
  3. 告知使用者已建立的內容、哪些來源路徑仍被就地引用,以及下一個階段。

S1 查看

  1. 在描述每張照片之前,先使用可用的視覺檢查工具載入它。
  2. 在提議任何生成的資產之前,先呈現一個庫存表格。
種類候選項目來源證據區分錨點環境 / 光線 / 情緒提議角色原始照片 vs 渲染原因 / 風險
  1. 包括人物、區分錨點、關鍵物品、環境、光線、情緒和連續性錨點。
  2. 當身份和服裝已經匹配時,提議將原始照片作為默認的身份參考。
  3. 僅針對已命名的控制問題、使用者要求的風格化或缺失/糾纏的視覺證據,提議渲染參考表。
  4. 要求使用者確認或更正庫存。
  5. 在 memento.yaml 中更新 sources、assets 和 memory.current_stage。

S2 訪談

  1. 閱讀 references/interview-guide.md。
  2. 在聊天中一次提出最多五個問題的編號批次。
  3. 跳過使用者已提供的任何內容。
  4. 在每個問題中包含建議或實用的預設值。
  5. 當使用者想要委託處理時,提供「給我驚喜」選項。
  6. 僅涵蓋缺失的決定:回憶節奏、意圖、必須發生的時刻、情感落點、片段數量、模型、持續時間、比例、風格錨點、音訊方向以及安全/同意邊界。
  7. 根據故事形狀推薦範圍:一個節奏通常對應一個片段;一個旅程、揭示或地點變化通常對應兩個或三個由匹配影格連接的片段。
  8. 總結提議的處理方案,並等待確認或更正。
  9. 將決定儲存在 memento.yaml 中的 memory、clips、interview 和 privacy 下。

S3 參考表

  1. 閱讀 references/sheet-craft.md。
  2. 在承諾渲染參考表之前,使用一次性會話能力探測開啟 S3。
  3. 將探測結果記錄在 rendering.capability_probe 下,包含會話標識符、時間戳、狀態和備註。
  4. 除非已記錄,否則要求渲染上傳同意。
  5. 在任何編輯或參考渲染之前,使用 view_image 將相關的本地照片載入到視覺上下文中。
  6. 將提示中的檔案系統路徑視為本身不可靠的輸入。
  7. 將內建的圖像生成路徑僅用作提示:無暴露的遮罩、種子、尺寸、模型或目標路徑。
  8. 不要命名圖像模型;當前的執行環境不會暴露一個。
  9. 在使用者同意時,從已查看的照片測試一個小的、保留參考的渲染。
  10. 僅在當前會話探測成功後,才將文字到圖像和多圖像參考視為可用。
  11. 對於多圖像參考,使用 view_image 載入每個來源,並在提示中明確標註每個圖像的角色。
  12. 使用散文式的外觀提示,例如 wide 16:9 landscape framing;不要承諾精確的像素尺寸。
  13. 預設的文字到圖像尺寸可能會有所不同;已驗證的執行環境渲染了大約 1536x1024。
  14. 如果渲染不可用、失敗或用戶拒絕上傳同意,請直接說明,並繼續使用原始照片作為 Dreamina 參考。
  15. 不要為參考表渲染提供 Dreamina 網路應用程式的備用方案。
  16. 自適應地選擇每個資產:原始照片、角色表、物品表、環境表、基礎影格或匹配影格。
  17. 僅渲染能夠解決下一個連續性問題的最小參考表或影格。
  18. 在會話中展示每個生成的結果,並在下游使用前要求批准。
  19. 僅將經過驗證的輸出移動到 memento/<slug>/sheets/。
  20. 更新 assets、來源 ID、角色、批准狀態、相關時的接受提示字數以及 memory.current_stage。

S3 輸出解析

對每個生成的圖像輸出使用此程序。

  1. 在渲染之前立即建立一個標記檔案,例如 memento/<slug>/.render-marker。
  2. 僅在標記時間戳存在後才執行渲染。
  3. 使用 find ... -newer <marker> 搜索 ${CODEX_HOME:-$HOME/.codex}/generated_images/。
  4. 將該目錄視為跨請求和會話的累積目錄。
  5. 當工具提供明確的返回輸出路徑時,優先使用,但仍需進行視覺驗證。
  6. 通過尺寸和視覺內容檢查每個比標記更新的候選項目。
  7. 絕不盲目選擇最新的檔案。
  8. 僅在檢查後候選項目仍不明確時,才詢問使用者。
  9. 將確認的輸出移動到 sheets/,並使用穩定的角色/版本名稱。
  10. 在將其標記為 approved 或在 Dreamina 上傳表中使用之前,查看已移動的檔案。

S3.5 微編輯循環

  1. 閱讀 references/micro-edit-loop.md。
  2. 在使用 Cowart 之前對其進行探測:可呼叫的 get_cowart_selection、可呼叫的 insert_cowart_image 以及可訪問的本地畫布服務。
  3. 如果 Cowart 存在,將工作圖像並排放置,並保持原始圖像和註釋可見。
  4. 如果 Cowart 不存在,提供參考中描述的配套安裝。
  5. 如果使用者拒絕 Cowart,則使用相同的身份和連續性保護措施進行基於聊天的迭代。
  6. 在任何編輯渲染之前,使用 view_image 將來源或帶註釋的截圖載入到視覺上下文中。
  7. 在第一次編輯之前設定期望:渲染可以保留構圖、取景和佈局,但它會生成式地重新渲染整個圖像。
  8. 將請求區域之外的細節偏移視為當前執行環境的正常情況。
  9. 並排比較來源和修訂版本,而不是承諾進行精確的單一區域編輯。
  10. 當身份或連續性風險較高時,一次迭代一個特定的視覺更改。
  11. 僅將使用者批准的乾淨修訂版本提升到 sheets/。
  12. 在 memento.yaml 中更新相關的資產路徑、角色、批准狀態和 Dreamina 標籤。

S4 提示

  1. 閱讀 references/dreamina-video-craft.md。
  2. 閱讀 references/dreamina-platform.md。
  3. 寫入 memento/<slug>/dreamina_prompts.md。
  4. 在會話中渲染完整的 Markdown,包含圍欄提示區塊。
  5. 包含一個標題,以及概念行、拍攝順序檢查清單和設定行。
  6. 使用此設定行格式:model · All-in Reference · ratio · duration。
  7. 對於每個片段,包含一個上傳表,格式為 Tag -> File -> Role。
  8. 當使用時,在上傳表中包含第一影格和最後影格固定點。
  9. 上傳表檔案僅指向已批准的 sheets/ 資產或已記錄的來源路徑。
  10. 每個片段只寫一個圍欄 text 區塊。
  11. 保持每個片段提示區塊在 1500 個字元或更少。
  12. 在區塊旁邊報告每個區塊的字元數,並將其記錄在 memento.yaml 中。
  13. 包含涵蓋平台上限、影片的空間法則和重新生成指南的備註。
  14. 使用參考作為錨點;為狀態增量、動作、相機、氛圍和音訊編寫提示散文。
  15. 在呈現之前壓縮任何過長的區塊。

S5 迭代

  1. 當更改 Dreamina 提示內容或上傳策略時,再次閱讀提示和平台參考。
  2. 從使用者報告的結果中確定最小的有用修正。
  3. 優先選擇一個有針對性的操作:壓縮一個區塊、調整參考角色、重新生成一個參考表或面板、重新固定影格、或澄清空間法則。
  4. 同時更新 dreamina_prompts.md 和 memento.yaml。
  5. 保持上傳表、資產角色、批准狀態和字元數一致。
  6. 如實報告任何 Dreamina 或圖像生成的拒絕。
  7. 當內容審查阻止生成時,與使用者一起修改。
  8. 絕不悄悄更改身份、服裝、道具、關係或場景事實。
  9. 在重新執行廣泛階段之前先詢問。

相關技能