Communitygithub.com

atilla777/omr

用于收集或修订 OMR(一镜到底回顾)视频的素材:整理主题资料、核实事实与外部来源、创建 content/index.md 及主题 Markdown 文件。不用于需求访谈、最终旁白或场景脚本、渲染、与视频无关的通用调研或 OMR 自身开发。

omr 是什么?

该技能旨在协助 AI 代理(如 Claude Code、Cursor、Codex)为 OMR(一镜到底回顾)视频准备结构化的事实素材库。它将工作聚焦于系统化的研究、事实核查与内容组织,确保输出一个真实准确、来源清晰的知识基础,以支撑后续的脚本创作。技能要求首先加载 `omr-dialogue` 依赖以获取项目上下文,并读取 `reviews/content.md`(如有)以考虑过往反馈。工作流程包括:加载并理解用户提供的材料与外部来源(优先使用第一手资料与官方文档),将每个关键事实与具体来源关联,并清晰区分事实、解释、示例与假设。随后,技能会在 `content/` 目录下创建一个 `content/index.md` 文件作为主题索引,并生成多个主题 Markdown 文件来分类组织事实、解释、示例与来源信息。最终输出的是一个可直接供后续脚本创作使用的素材库,而非最终脚本本身。该技能明确不处理需求访谈、最终旁白、场景或渲染等生产任务。

兼容平台~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:

  • 主题和资料库的用途,使用的需求/等效简报;
  • 指向素材的相对链接,简要说明每个素材的内容和阅读顺序;
  • 必要主题的覆盖情况、重大空白、有争议/未经验证的信息以及搜索限制(如有)。

在主题文档中,将事实/解释、示例、注意事项和来源分开。为下一阶段提供足够的上下文,而无需依赖旧聊天记录。根据主题调整结构;不要为了模板而复制文档。链接应指向现有的本地素材或具体的外部来源,而不仅仅是其主页。

这是素材,而非脚本:不要创作最终叙述、现成的旁白文本、场景顺序、逐帧时间线或生产代码。文档的阅读顺序不是场景顺序。不要预先创建或下载生产媒体;可以研究提供的资源并进行引用。不要安装引擎或其他生产依赖项,不要创建包文件、场景源文件、渲染文件或后续阶段的空文件夹。

在重新运行时,研究现有内容,仅修改委托的素材,并在此次编辑中更新索引。保留其他工作和来源;不要覆盖整个目录,不要更新需求、脚本或视频。如果禁止写入,则明确给出未保存的结果并说明限制。

检查与停止

重新阅读已保存的文档。检查是否符合要求,是否存在索引、阅读顺序和本地链接,关键事实是否与实际阅读的来源相关联,示例是否准确,剩余空白是否明确。如果某个必要主题仍缺乏可靠素材,不要宣布资料库已足够。

报告实际路径、简要覆盖情况以及任何重要的检查限制。停止: 不要自动启动脚本或其他阶段。只有在确认下一阶段命令确实实现后,才提及它。

Individual skills in this repo

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

相关技能