Skip to content
Back to search

hbg-classical-poem-silk-video

Agent Skill for turning Chinese classical poems into vertical Chinese-art videos with ImageGen stills, Docker I2V, calligraphy captions, retained ambience, BGM and final MP4 QA.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mr-funny--hbg-classical-poem-silk-video/badge.svg)](/listings/mr-funny--hbg-classical-poem-silk-video)

HTML

<a href="/listings/mr-funny--hbg-classical-poem-silk-video"><img src="/api/listings/mr-funny--hbg-classical-poem-silk-video/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 251 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/showcase/hero.svg" alt="HBG Classical Poem Silk Video" width="100%" />
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/Mr-funny/hbg-classical-poem-silk-video/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/Mr-funny/hbg-classical-poem-silk-video/ci.yml?branch=main&style=flat-square&label=CI" alt="CI" /></a>
  6. <img src="https://img.shields.io/badge/Agent%20Skill-SKILL.md-8b5cf6?style=flat-square" alt="Agent Skill" />
  7. <img src="https://img.shields.io/badge/Canvas-1080%C3%971920-b45309?style=flat-square" alt="1080x1920" />
  8. <img src="https://img.shields.io/badge/Stills-ImageGen-2563eb?style=flat-square" alt="ImageGen" />
  9. <img src="https://img.shields.io/badge/I2V-Docker-0f766e?style=flat-square" alt="Docker I2V" />
  10. <img src="https://img.shields.io/badge/Audio-ambience%20%2B%20BGM-c2410c?style=flat-square" alt="Ambience and BGM" />
  11. <img src="https://img.shields.io/badge/QA-final%20MP4-25221f?style=flat-square" alt="Final MP4 QA" />
  12. </p>
  13. <p align="center">
  14. 把古诗词做成<strong>逐句或两句一景的竖屏中国画动态视频</strong>。<br />
  15. <strong>诗意分镜 · 中国画风格分化 · 画中物象真实运动 · 毛笔字逐字题写 · 原环境声与 BGM 并行 · 最终成片质检</strong>
  16. </p>
  17. > 这不是“给一张古画做慢速推镜”的模板。Skill 会把诗句拆成独立意象,用静态锚点限制图生视频重画,让水纹、飞鸟、马蹄、柳枝、衣袍等画中物象真正动起来。
  18. ## ⚡ 一句话安装进 Agent
  19. 把下面整段话发给 Codex、Claude Code 或其他支持 `SKILL.md` 的 Agent:
  20. ```text
  21. 请从 https://github.com/Mr-funny/hbg-classical-poem-silk-video 安装
  22. classical-poem-silk-video skill。
  23. 请自动识别当前 Agent 的全局 skills 目录;如果已经存在旧版本,请先备份再更新。
  24. 安装后检查 SKILL.md、agents、references、scripts 和字体资产是否完整,
  25. 运行 shell 语法检查、Python 编译检查与 skill 校验。
  26. 不要读取、打印或上传任何 API Key、Cookie、Chrome Profile、本地视频、音频或生成素材。
  27. 验证完成后,告诉我如何使用 $classical-poem-silk-video
  28. 把一首中国古诗制作成 1080×1920 的国风动态视频。
  29. ```
  30. 安装后直接说:
  31. ```text
  32. 使用 $classical-poem-silk-video 制作《枫桥夜泊》。
  33. 四句诗一行一景,画面色调跟随诗意变化;镜头固定,
  34. 让月光、水纹、乌鸦、霜雾和渔火在画中自然运动。
  35. 保留 AI 环境原声,毛笔字逐字出现,场景之间自然交叉溶解。
  36. ```
  37. ## 🎯 它解决的不是“古画会动”,而是“古画不会乱动”
  38. | 常见问题 | Skill 的处理方式 |
  39. |---|---|
  40. | 每张图都是同一种泛黄古绢色 | 保持中国画 DNA,一景一条风格通道:水墨、工笔、青绿、人物鞍马等 |
  41. | 用后期推镜冒充图生动态 | 默认锁定镜头,只允许已有物象做局部、可解释的动作 |
  42. | 云雾一动就变成祥云,寺庙被重新搭建 | 声明建筑、山体、树干、岸线、人物躯干为静态锚点 |
  43. | 鸟越动越多,枝条凭空生长 | 固定主体数量与身体中心,明确禁止复制、合并、长枝和新增剪影 |
  44. | 马匹走动时多腿、悬空或换身体 | 限制为一次重心变化或小步,检查四蹄、地面接触和身体一致性 |
  45. | 所有动作同时发生导致整幅画重构 | 每景只设一个主动作,加一到两个环境辅助动作 |
  46. | 转场时黑一下,环境声突然断掉 | 画面用 `xfade`,原环境声用 `acrossfade`,BGM 连续播放 |
  47. | 白色 Gemini 星标和传统红印一起被删 | 只处理右下角白色星标,红色方印作为画面内容保留 |
  48. | 字幕像普通视频字体 | 内置 Ma Shan Zheng,右列先写、左列后写,逐字出现 |
  49. | 浏览器预览没问题,最终 MP4 却有黑帧 | 对最终编码视频重新抽帧、检查转场中点、末帧、黑帧和音轨 |
  50. ## ✨ 核心能力
  51. | 模块 | 能力 |
  52. |---|---|
  53. | 诗词解析 | 识别时代、地点、季节、时间、意象、动作和情绪弧线 |
  54. | 分镜分组 | 四句以内默认逐句;长诗默认连续两句一景 |
  55. | 画面风格 | 在统一中国画品质下,按诗意切换水墨、工笔、青绿、鞍马等支线 |
  56. | 静帧生成 | 使用 Codex 内置 ImageGen,预留竖排题字安全区 |
  57. | 图生视频 | 通过 Docker 调用 Gemini I2V,不在生成阶段操控用户浏览器 |
  58. | 动作提示词 | 静态锚点、局部动作区、稳定收尾、反幻觉禁令四段式结构 |
  59. | 字幕 | Ma Shan Zheng 毛笔字体,两列竖排,按字揭示 |
  60. | 音频 | 保留每个 I2V 镜头的模型环境声,可叠加连续 BGM |
  61. | 转场 | 画面和环境声同步交叉溶解,避免黑场与音频重启 |
  62. | QA | 检查主体数量、动物肢体、建筑稳定、题字安全区、编码规格与末帧 |
  63. ## 🚀 快速开始
  64. ### 方法一:让 Agent 自动安装(推荐)
  65. 复制 README 首屏的自然语言安装提示,让 Agent 完成下载、备份、安装和验证。
  66. ### 方法二:安装到 Codex
  67. ```bash
  68. curl -fsSL https://raw.githubusercontent.com/Mr-funny/hbg-classical-poem-silk-video/main/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 87 on GitHub
  69. ```
  70. 默认安装到:
  71. ```text
  72. ${CODEX_HOME:-~/.codex}/skills/classical-poem-silk-video
  73. ```
  74. ### 方法三:安装到 Claude Code
  75. ```bash
  76. curl -fsSL https://raw.githubusercontent.com/Mr-funny/hbg-classical-poem-silk-video/main/install.sh | sh -s -- --claude
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 99 on GitHub
  77. ```
  78. ### 方法四:手动安装
  79. ```bash
  80. git clone https://github.com/Mr-funny/hbg-classical-poem-silk-video.git
  81. mkdir -p ~/.codex/skills/classical-poem-silk-video
  82. cp -R hbg-classical-poem-silk-video/skill/classical-poem-silk-video/. \
  83. ~/.codex/skills/classical-poem-silk-video/
  84. ```
  85. ## 🐳 Docker 运行时
  86. 静帧由 Agent 的内置 ImageGen 生成。图生视频与可选星标清理依赖:
  87. - [Mr-funny/hbg-gemini-flow-suite](https://github.com/Mr-funny/hbg-gemini-flow-suite)
  88. - Docker 容器名:`gemini-flow-suite`
  89. - 工作区在容器内挂载为 `/workspace`
  90. - 输出目录在容器内挂载为 `/data/outputs`
  91. 先按运行时仓库 README 完成一次用户控制的授权,再运行:
  92. ```bash
  93. skill/classical-poem-silk-video/scripts/check_prerequisites.sh
  94. ```
  95. Skill 不包含、不上传、也不会打印 Cookie、API Key 或浏览器 Profile。详细约定见 [runtime-contract.md](skill/classical-poem-silk-video/references/runtime-contract.md)。
  96. ## 🤖 使用示例
  97. ### 四句逐句成画
  98. ```text
  99. 使用 $classical-poem-silk-video 制作《枫桥夜泊》。
  100. 每句一景,夜色从冷蓝过渡到渔火暖色。
  101. 不要做后期推镜,动态来自月光、水纹、乌鸦、霜雾和钟声的可见原因。
  102. ```
  103. ### 长诗两句一景
  104. ```text
  105. 使用 $classical-poem-silk-video 制作《钱塘湖春行》。
  106. 两句一景,共四景;水墨湖寺、工笔花鸟、人物鞍马、青绿长堤分别对应诗意。
  107. 保留 AI 原环境声,BGM 与原声并行,转场使用 1.2 秒自然溶解。
  108. ```
  109. ### 修复已有国风视频
  110. ```text
  111. 使用 $classical-poem-silk-video 检查这四段图生视频。
  112. 重点排查建筑重构、鸟类复制、马腿畸形、柳叶脱落、白色星标、字幕安全区和黑帧转场。
  113. 只重做不合格镜头,不要用后期推镜掩盖问题。
  114. ```
  115. ## 🧠 工作原理
  116. ```mermaid
  117. flowchart LR
  118. A["完整古诗词"] --> B["意象与情绪弧线"]
  119. B --> C["逐句 / 两句一景"]
  120. C --> D["中国画风格通道"]
  121. D --> E["ImageGen 静帧"]
  122. E --> F["Docker I2V"]
  123. F --> G["早中晚抽帧验收"]
  124. G --> H["白色星标清理"]
  125. H --> I["毛笔字逐字字幕"]
  126. I --> J["原环境声 + BGM"]
  127. J --> K["画面与声音交叉溶解"]
  128. K --> L["最终 MP4 QA"]
  129. ```
  130. 四条动作原则:
  131. 1. **镜头锁定。** 图生视频的动态来自画中物象,不来自后期缩放。
  132. 2. **动作有锚点。** 翅膀围绕身体中心,水纹从接触点扩散,柳叶不能离开枝条。
  133. 3. **一景一主动作。** 动作过多会诱发模型重新构图。
  134. 4. **最终 MP4 才是交付对象。** 必须从编码后的成片重新抽帧验收。
  135. ## 🖼️ 实际项目:钱塘湖春行
  136. <p align="center">
  137. <img src="docs/showcase/qian-tang-contact.jpg" alt="钱塘湖春行关键帧" width="72%" />
  138. </p>
  139. - 8 句诗,连续两句一景,共 4 景
  140. - 水墨湖寺、工笔花鸟、人物鞍马、青绿长堤四条视觉通道
  141. - 每景约 9 秒,3 次 1.2 秒交叉溶解
  142. - 最终规格:1080×1920、30fps、H.264 + AAC
  143. - 成片时长:32.44 秒
  144. - 保留 I2V 原环境声,支持 BGM 低铺底或 100% 并行混音
  145. [下载示例成片(GitHub Release)](https://github.com/Mr-funny/hbg-classical-poem-silk-video/releases/download/v0.1.0/qian-tang-hu-chun-xing-v4-full-bgm.mp4)
  146. 完整复盘文章:
  147. > [《我用 Codex + AI 生图 + Docker,把〈钱塘湖春行〉做成了一条会呼吸的中国画视频》](docs/article.md)
  148. ## ✅ 最终媒体质检
  149. ```bash
  150. skill/classical-poem-silk-video/scripts/final_media_qa.sh \
  151. final.mp4 qa/final
  152. ```
  153. 输出包括:
  154. - `ffprobe.json`
  155. - `blackdetect.log`
  156. - `silencedetect.log`
  157. - `volumedetect.log`
  158. - 10%、25%、50%、75%、90% 与末帧
  159. - 最终编码视频联系表
  160. 如需检查马蹄、鸟数或转场中点,准备 TSV:
  161. ```text
  162. 8.400\ttransition-1-mid
  163. 16.200\ttransition-2-mid
  164. 20.100\thorse-contact
  165. 24.000\ttransition-3-mid
  166. ```
  167. ```bash
  168. skill/classical-poem-silk-video/scripts/final_media_qa.sh \
  169. final.mp4 qa/final qa-timestamps.tsv
  170. ```
  171. ## 📁 仓库结构
  172. ```text
  173. skill/classical-poem-silk-video/ Agent Skill 本体
  174. docs/article.md 当前项目完整复盘文章
  175. docs/showcase/ README 视觉预览
  176. examples/ 脱敏示例分镜与提示词
  177. tools/ CI 校验与隐私扫描
  178. install.sh Codex / Claude Code 安装器
  179. ```
  180. ## 🔐 隐私与合规
  181. - 不提交 API Key、Cookie、`.env`、Chrome Profile、Docker 数据卷或生成账号数据。
  182. - 不提交用户原始聊天、私人文案、本地项目路径或未授权素材。
  183. - 只在用户要求且适用条款允许时处理白色模型星标;传统红印与有意画面标记必须保留。
  184. - 运行时授权由用户本人完成,Skill 的生成流程只调用 Docker。
  185. ## 📄 License
  186. - Skill、脚本与文档:MIT License
  187. - Ma Shan Zheng 字体:SIL Open Font License 1.1,见 `skill/classical-poem-silk-video/assets/OFL.txt`
  188. - HBG Gemini Flow Suite:独立项目与独立许可证,本仓库不重复分发
  189. 欢迎提交 Issue 和 PR,一起把“这次终于改对了”变成“下一次默认不会再错”。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.