用途：spark-gen 分析当前仓库，生成可直接加入 TeamSpark（循环展示项目的团队屏幕）的交付物。它只在 _spotlight/<slug>/ 下创建内容，不修改仓库中任何已有文件；slug 为小写短名、用连字符（如 dashboard-ventes）。
主要能力：生成 project.md 元数据文件，以及引用的媒体文件（全部平铺复制，不建子目录）。project.md 的 YAML 含 title、description、team、logo、images、video、link、duration 等字段；description 必须用双引号包裹，否则未加引号的冒号会破坏 YAML。
视频流程：先询问用户视频时长 N（20 至 120 秒，默认 20；越界或非数字则再问一次，之后按 20 处理）。优先复用已有视频（brag-output*/brag.mp4，或 out/、renders/、docs/、assets/、media/ 中的 .mp4/.webm），若时长在 N±10%（至少 ±2 秒）内则复用最新者。否则检查 /brag 命令，缺失时安装：npx skills add https://github.com/latent-spaces/brag --skill brag -g；并用 npx hyperframes doctor 检查 Hyperframes。生成命令为 /brag --duration <N> --format landscape，输出在 brag-output/（或带日期目录），文件为 brag.mp4。用 ffprobe -v error -show_entries format=duration -of csv=p=0 brag.mp4 校验时长，不符则重跑。约束：16:9、.mp4（H.264）、最大 20 MB，必要时重编码：ffmpeg -i in.mp4 -vf scale=1280:-2 -crf 28 -an brag.mp4；不使用声音。duration 取视频实际时长向上取整，限制在 5 至 120。
其余字段：title 必填，其他可选，缺信息就省略，不得编造。description 依据 README 与代码、避免技术术语；team 由 git shortlog -sn --no-merges 推断（最多 5 人、排除机器人、用真实姓名）；logo 复制已有图标；images 为 0 至 4 张已有截图，不生成新图；link 为已部署产品的公开 http(s) 地址，否则仓库地址。logo、images、video 引用的文件必须存在于 _spotlight/<slug>/。
结束：展示 project.md 内容、复制文件及大小、视频是复用还是生成、/brag 是否需安装、以及因缺信息省略的字段；创建 _spotlight/<slug>.zip（PowerShell：Compress-Archive -Path _spotlight/<slug>/* -DestinationPath _spotlight/<slug>.zip，或 macOS/Linux 用 zip -r），最后给出分享步骤：把文件夹或压缩包发给 Jean-Marie PARENT（Teams、邮件或共享仓库），由其加入 TeamSpark。
限制：若安装或生成失败，不得编造，应省略 video 并在总结中报告错误。资料未提供收费、价格、平台支持范围等信息。