mcpField
W
workflow-template-seeder

workflow-template-seeder

github.com/heyvhuang開発33850 回インストール30 週間前に更新
リポジトリ

workflow-template-seeder について

短い仕様書から、実行可能でドキュメント付きのプロジェクトテンプレートを作るワークフロースキルです。シンプルな土台の作成、説明と設定例の整備、インストール・起動・ビルドの検証を支援します。

主な機能

  1. 01仕様書からのテンプレート生成
  2. 02シンプルなNext.jsベースの作成指針
  3. 03必要な連携の選択
  4. 04READMEとメタデータの準備
  5. 05秘密情報を含まない環境設定例
  6. 06インストール・起動・ビルドの確認

活用シーン

  1. 01再利用可能なプロジェクトひな型の作成
  2. 02共有用テンプレートの準備
  3. 03必要な環境変数キーの記録
  4. 04引き渡し前のテンプレート確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/heyvhuang/ship-faster --skill workflow-template-seeder

インストール後、Claude Code で/workflow-template-seederを入力して読み込まれたか確認します。

詳細

ワークフロー:テンプレートシーダー(スキル → テンプレート)

目標:短いテンプレート仕様書から、templates/ 配下に実行可能で、ドキュメントが整ったテンプレートを作成します。

このワークフローはスキル優先です:

  • スキルを主な実行エンジンとして使用します
  • テンプレートは主力製品ではなく、「固定された出力」(サンプルおよび回帰テスト用の参照)として扱います

入力(パスのみを渡す)

  • repo_root:Ship Faster リポジトリのルート(templates/ がある場所)
  • run_dir:runs/template-seeder/active/<run_id>/
  • template_spec.md:1ページの仕様書(概要、対象ユーザー、主要ページ、必須の連携機能)

出力(永続化)

  • 03-plans/template-plan.md
  • 05-final/template-summary.md
  • 新しいテンプレートディレクトリ:templates/<NNN>-<slug>/。次のファイルを含みます:
    • README.md(5分で実行可能)
    • .env.local.example(キー名のみ)
    • metadata.json

ワークフロー

0) 初期化
  1. run_dir を作成します。
  2. 次を決定します:
    • <slug>:仕様書から作成(ケバブケース)
    • <NNN>:templates/ 配下で次に利用可能な番号(001、002、…)
  3. このワークフロー用に 01-input/context.json を作成します:
    • entry_type: idea
    • repo_root: <path-to-new-template-dir>
    • need_deploy: false(テンプレートは自動デプロイしないでください)
    • 仕様書で必要な連携機能(DB/課金/SEO)のみを有効にします
1) テンプレートのベースラインを生成する(クリーンで最小限の構成を推奨)

推奨する方法:

  • 新しいテンプレートディレクトリにクリーンな Next.js ベースラインを作成し、同じ「Ship Faster チェーン」を実行します。

推奨される実行順序:

  1. workflow-project-intake(仕様がすでに完成している場合は省略可)
  2. workflow-ship-faster(テンプレートディレクトリを repo_root として指定)
  3. 手順を省略した場合(例:DB/課金機能が不要な場合)は、その理由を 00-index.md/05-final/template-summary.md に記録します
2) テンプレートを強化する(共有可能な出力)

必須事項:

  • シークレットを削除し、.env.local.example には環境変数のキー名のみを残します
  • README.md に次の内容が含まれていることを確認します:
    • Node のバージョン
    • インストールと開発の手順
    • 必須の環境変数キー
    • 任意の連携機能に関する注記
  • metadata.json が正確で汎用的であることを確認します(意図した場合を除き、非公開のブランド情報は含めないでください)
3) 検証

最低限、次の結果を 05-final/template-summary.md に記録します:

  • インストールが成功する
  • dev が起動する
  • build が成功する(テンプレートに外部の認証情報が必要な場合は、最低限必要なキーを記載します)

制約

  • あらゆる機能を詰め込んだテンプレートは作成しないでください。
  • 大規模なリファクタリングは避け、適応しやすい、小さくクリーンなベースラインを優先してください。
  • シークレットは絶対にコミットしないでください。

コメント