mcpField
S
spark-gen

spark-gen

github.com/jm-parent创意与媒体0102 次安装4 周前更新
代码仓库

关于 spark-gen

spark-gen 是一项用于制作 TeamSpark 项目展示材料的 skill，会分析当前仓库并生成独立交付目录，不改动仓库现有文件。它还会处理视频、项目说明和归档。

主要功能

  1. 01分析当前仓库
  2. 02复用或生成视频
  3. 03编写 TeamSpark 项目说明
  4. 04复制媒体文件
  5. 05创建 ZIP 归档

适用场景

  1. 01为 TeamSpark 整理项目展示材料
  2. 02按指定时长准备项目视频
  3. 03打包项目资料与媒体以供分享

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jm-parent/spark-skills --skill spark-gen

安装后在 Claude Code 中输入/spark-gen确认已加载。

详细介绍

spark-gen — 生成 TeamSpark 成果

分析当前仓库，并且仅创建 _spotlight/<slug>/。不要修改仓库中的任何现有文件。<slug>：简短名称，使用小写字母和连字符（例如 dashboard-ventes）。

步骤 0：视频时长

询问用户视频时长，介于 20 到 120 秒之间，默认 20 秒（用户可以直接接受默认值）。如果回答超出范围或不是数字，再询问一次，然后使用 20。将其称为 N。

文件夹内容

  • project.md
  • 所有引用的媒体文件，平铺复制（不创建子文件夹）。

project.md 格式

---
title: <nom du projet>
description: "<1 à 2 phrases en français, 160 caractères max, bénéfice utilisateur>"
team: [Prénom Nom, Prénom Nom]
logo: logo.svg
images: [cover.png]
video: brag.mp4
link: https://...
duration: <N>
---

description 必须始终用双引号括起来（未加引号的 “:” 会导致 YAML 解析失败）。

步骤 1：视频 /brag（N 秒）

  1. 首先查找已生成的视频：brag-output*/brag.mp4，或 out/、renders/、docs/、assets/、media/ 中任何用于展示的 .mp4 / .webm 文件。如果存在且时长符合 N ± 10%（至少 ± 2 秒），则复用该视频（如果有多个，选择最新的）。否则，重新生成（见第 3 点）。
  2. 确认 /brag 命令可用。否则，安装它： npx skills add https://github.com/latent-spaces/brag --skill brag -g （接受默认选项；目标是 Copilot Agent / 当前 Agent）。同时检查 Hyperframes：npx hyperframes doctor（修复它指出的问题）。如有必要，重新加载 skills，然后继续。
  3. 如果没有有效视频，则生成视频：/brag --duration <N> --format landscape。输出位于 brag-output/（或 brag-output-<date>/）；视频文件为 brag.mp4。
  4. 检查时长：ffprobe -v error -show_entries format=duration -of csv=p=0 brag.mp4。时长必须符合 N ± 10%（至少 ± 2 秒）。否则，使用 --duration <N> 重新运行 /brag。
  5. 要求：16:9、.mp4（H.264）、最大 20 Mo（如有需要，重新编码：ffmpeg -i in.mp4 -vf scale=1280:-2 -crf 28 -an brag.mp4）。不使用音频。
  6. 将视频复制到 _spotlight/<slug>/，命名为 brag.mp4，并填写 video: brag.mp4。
  7. duration = 视频实际时长向上取整后的整数（限制在 5 到 120 之间）。
  8. 如果安装或生成最终失败，不要捏造内容：省略 video:，并在总结中说明遇到的错误。

步骤 2：其余项目资料

  • title 为必填项。其他字段均为可选项：如果缺少信息，省略该行。不要捏造内容。
  • description：根据 README 和代码撰写，避免使用技术术语。
  • team：根据 git shortlog -sn --no-merges 推断（最多 5 人，不包括机器人），使用真实姓名而非登录名。
  • logo：现有徽标/图标（README、public/、assets/、favicon），原样复制。否则省略。
  • images：0 到 4 个现有视觉素材（README 中的截图、docs/、screenshots/）。不要生成。存在视频时可以不提供。
  • link：已部署产品的公开 http(s) URL，否则使用仓库 URL。否则省略。
  • 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），然后以以下流程结尾，并填写实际路径：

最后一步：分享成果

  1. 获取文件夹 _spotlight/<slug>/（或压缩包 _spotlight/<slug>.zip）。
  2. 发送给 Jean-Marie PARENT（通过 Teams、邮件或共享仓库）。
  3. 他会将其添加到 TeamSpark，项目便会出现在团队屏幕的轮播中。

评论

支持 Markdown