mcpField
S
spark-gen

spark-gen

github.com/jm-parentクリエイティブ・メディア0102 回インストール4 週間前に更新
リポジトリ

spark-gen について

spark-gen は、現在のリポジトリを分析して TeamSpark の紹介用成果物を作るスキルです。既存ファイルを変更せず、動画やプロジェクト情報をまとめて納品用に整えます。

主な機能

  1. 01リポジトリの分析
  2. 02動画の再利用または生成
  3. 03TeamSpark 用プロジェクト情報の作成
  4. 04メディアファイルのコピー
  5. 05ZIP アーカイブの作成

活用シーン

  1. 01TeamSpark 向け紹介資料の準備
  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 エージェント／現在のエージェントを対象にします）。Hyperframes も確認します：npx hyperframes doctor（指摘された問題を修正します）。必要に応じてスキルを再読み込みしてから、続行します。
  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 MB（必要に応じて再エンコード：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 対応