Communitygithub.com

atilla777/omr

用於收集或修訂 OMR 影片的來源支援內容:彙整影片主題資料、驗證事實與外部來源、建立 content/index.md 及主題式 Markdown 檔案。不適用於需求訪談、最終旁白或場景腳本、渲染、與影片無關的一般研究,或 OMR 本身的開發。

omr 是什麼?

此技能專為 OMR 影片的素材準備階段設計,提供結構化的內容收集、驗證與組織流程。它能自動載入 `omr-dialogue` 對話依賴,並根據 `reviews/content.md` 中的審查意見調整內容建立或修改。技能會引導使用者確認專案與主題的足夠性,包含主題、目標、受眾與範圍,並在資訊不足時主動提出問題或建議使用 `/omr-requirements` 指令,但絕不自行啟動訪談或假設資訊。在收集與驗證階段,技能會區分使用者提供的材料與自行搜尋的外部資訊,優先使用第一手來源與官方文件,並嚴格標示每個事實的來源、作者、URL、區段與存取日期,同時明確區分直接事實、解釋、範例、假設與結論。它會避免複製大量外部文字,而是以引用方式改寫,並妥善處理資料衝突與不可驗證的資訊。最後,技能會建立 `content/index.md` 作為索引,並根據主題建立一個或多個主題式 Markdown 文件,確保下一階段有足夠的脈絡,但絕不建立最終腳本、場景順序或生產用程式碼。它支援在現有內容上進行增量更新,並在每次完成時進行自我檢查,確保符合需求並標示剩餘限制。此技能主要用於 Cursor 或類似支援 Markdown 文件管理的 AI 代理平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atilla777/omr/tree/HEAD/.opencode/skills/omr-content

在你喜歡的 AI 中提問

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

說明文件

OMR 影片素材

你掌握特定影片 content/ 目錄中的充實素材,包括必要的 content/index.md。請使用使用者的語言進行溝通。成果是未來腳本的可驗證事實、解釋與範例基礎。

專案與輸入充足性

工作開始時,透過 skill 載入 omr-dialogue(如果尚未載入當前上下文),並將其應用於所有澄清事項。若相依性不可用,請回報並協調連線;向主負責人回報封鎖事項。

如果存在 reviews/content.md,請閱讀它,並在建立或修改內容時考慮其中描述的問題。如果檔案不存在,則表示沒有先前的審查意見。請勿自行啟動審查或修改其報告:這是獨立操作。向主負責人回報重要問題,不要啟動單獨的訪談。

  1. 閱讀適用的 AGENTS.md、請求、requirements.md、提供的文件/連結以及現有的 content/index.md 與受影響的素材。使用當前影片子資料夾或使用者明確選擇的專案。根據規則和結構設定工作區根目錄,而不僅僅是根據 .git。從根目錄開始且未選擇專案時,先詢問要使用哪個現有或新的子資料夾。請勿將影片內容寫入 OMR 根目錄,也勿在已選擇的專案內建立巢狀影片資料夾或巢狀 .git。
  2. 檢查主題、目標、受眾、必備/排除內容、深度與篇幅限制是否清晰,以便有意義地篩選素材。考慮其他需求決策,包括模式、語言與資源限制;請勿更改它們。如果沒有 requirements.md,等效的簡報/請求是可以接受的。請勿要求重新批准現有文件或單獨的狀態。
  3. 若有重大缺口或衝突,具體說明阻礙收集的原因,並提出必要的澄清。如果先前的結果不存在或不足,請建議使用 /omr-requirements,但前提是確認此安裝中存在該指令。請勿自行呼叫它或啟動訪談。請勿基於虛構的主題/受眾製造看似完整的內容。不影響收集的次要生產細節不應阻礙工作。

收集與驗證

  • 首先分析使用者的素材:它們證實了什麼、留下了哪些缺口、來自何處。保留本地檔案及所需區段或頁面的連結。提供的筆記是使用者陳述的來源,並非其真實性的自動證據。
  • 自行尋找與主題和需求相關的外部資訊。使用可用的搜尋工具,並透過可用的網頁閱讀工具開啟合適的頁面/第一手來源。若無搜尋工具,可透過可用的目錄/百科頁面及其連結進行搜尋;明確說明方法與限制。請勿將記憶中的 URL 或片段當作已讀取的來源。未經協調,請勿安裝搜尋工具。
  • 優先使用第一手來源、官方資料與專業參考書。對於每個重要的發現事實,請在陳述旁或透過明確標記與來源列表指明具體來源。保留名稱、作者/組織(如有)、URL、區段/頁面與存取日期;若出版日期與相關日期影響意義,也請保留。對於計算,請顯示原始資料、假設與計算過程,而不是將自己的結論歸因於來源。
  • 將陳述與實際讀取的片段關聯起來。區分直接事實、用自己的話解釋、範例、假設與結論。檢查單位、公式的適用範圍以及可變資料的時效性。驗證的規模應與主題相稱;若有爭議,尋找獨立確認並保留差異。請勿隱藏使用者素材與外部來源之間的衝突:解釋它;若證據不足,請澄清重要的解釋選擇。
  • 若頁面無法存取,請嘗試可用的可靠來源。如果所需陳述無法驗證,請將其標記為未驗證,並說明原因與影響,或將其從可用基礎中排除。若完全無法存取外部搜尋,請保留有用的部分工作並明確說明限制,回報封鎖事項並協調取得來源;請勿宣稱外部搜尋已完成。
  • 收集足以達成目標的事實、定義、受眾易懂的解釋、範例與重要的注意事項。將研究範圍限制在影片內容內;請勿將主題擴展為無止盡的綜述。請勿複製大量他人文字:以引用方式改寫,引用部分需標明,並僅在必要時使用。

結果組織

根據需要建立 content/ 目錄及一個或多個主題式 .md 檔案。即使只有單一素材,也必須建立 content/index.md:

  • 主題與基礎的用途、使用的需求/等效簡報;
  • 指向素材的相對連結、每個素材的簡要說明與閱讀順序;
  • 必備主題的覆蓋範圍、重大缺口、有爭議/未驗證的資訊以及搜尋限制(如果有)。

在主題式文件中,區分事實/解釋、範例、注意事項與來源。為下一階段提供足夠的脈絡,而不需要舊聊天記錄。根據主題調整結構;請勿為了模板而複製文件。連結應指向現有的本地素材或特定的外部來源,而不僅僅是它們的首頁。

這是素材,不是腳本:請勿建立最終敘述、完成的配音稿、場景順序、逐幀時間碼或生產用程式碼。文件的閱讀順序並非場景順序。請勿預先建立或下載生產用媒體;提供的資源可以研究並引用。請勿安裝引擎或其他生產依賴項,請勿建立 package 檔案、場景原始檔、渲染檔或後續階段的空資料夾。

重複執行時,研究現有內容,僅修改指定的素材,並在本次修改範圍內更新索引。保留其他工作與來源;請勿覆蓋整個目錄,請勿更新需求、腳本或影片。如果禁止寫入,請提供明確的未儲存結果並說明限制。

檢查與停止

重新閱讀已儲存的文件。檢查是否符合需求、是否存在索引、閱讀順序與本地連結是否正確、重要事實是否與實際讀取的來源相關聯、範例是否準確以及剩餘缺口是否明確。如果必備主題仍缺乏可靠素材,請勿宣稱基礎已充足。

回報實際路徑、簡要覆蓋範圍與檢查的重大限制。停止: 請勿自動啟動腳本或其他階段。僅在確認下一階段的指令確實已實現後,才提及該指令。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能