mcpField
F
fullstack-workspace-init

fullstack-workspace-init

github.com/shipshitdev開発38163 回インストール2 日前に更新
リポジトリ

fullstack-workspace-init について

新しい Shipshit.dev 製品リポジトリを初期化するスキルです。既定では `npx @shipshitdev/v0` で雛形を生成し、製品概要の確認、設定選択、生成後の検証を行います。既存環境向けの手動手順もあります。

主な機能

  1. 01製品概要の確認
  2. 02既定の `v0` スキャフォールド手順
  3. 03エージェント引き継ぎ方式の選択
  4. 04ワークスペースと起動状態の確認
  5. 05重要な変更前の確認

活用シーン

  1. 01新しい製品リポジトリの作成
  2. 02生成されたアプリのカスタマイズ
  3. 03既存ワークスペースの拡張

インストール

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

$npx skills add https://github.com/shipshitdev/skills --skill fullstack-workspace-init

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

plugin.json
references/
architecture-guide.md
coding-standards.md
deployment-guide.md
legacy-manual-route.md
vitest.config.frontend.ts
vitest.config.ts
references/github-actions/
ci.yml
references/templates/
auth-guard.template.ts
clerk-provider.template.tsx
component-form.template.tsx
component-list.template.tsx
component.spec.template.tsx
controller.spec.template.ts
controller.template.ts
current-user.decorator.template.ts
dto.template.ts
e2e.spec.template.ts
hook.spec.template.ts
module.template.ts
proxy.template.ts
schema.template.ts
service-client.template.ts
service.spec.template.ts
service.template.ts
test-setup.template.ts
scripts/
add-api-collection.py
add-frontend-app.py
init-workspace.py

詳細

フルスタックワークスペースの初期化

新しい製品リポジトリでは、デフォルトのスキャフォールダーとして npx @shipshitdev/v0 を使用します。 このスキルは、製品概要のヒアリング、カスタマイズ、検証を行います。

契約

入力：

  • プロジェクトディレクトリと製品名
  • 製品の範囲または PRD 形式の概要
  • 選択したアプリのサーフェスと製品ルート
  • エージェントへの引き継ぎ設定：codex、claude、または skip-agent

出力：

  • 使用した v0 コマンドまたは対話形式のルート
  • 生成されたワークスペースの概要
  • 品質ゲートと起動ステータス
  • アプリ固有のカスタマイズに関する後続タスク

作成／変更するもの：

  • v0 の実行時に作成される新しい Bun/Turbo 製品リポジトリ
  • v0 が生成する .agents/skills、.agents/memory、.claude、.codex、apps、packages、.v0 ファイル
  • v0 の生成後にカスタマイズする場合に限り、アプリ固有のファイル

外部への副作用：

  • 依存関係をインストールし、apps/web を起動する場合があります
  • GitHub フラグが明示的に有効化されている場合に限り、GitHub リポジトリや Issue を作成する場合があります

確認が必要な操作：

  • GitHub リポジトリまたは Issue を作成する前
  • 空ではないディレクトリで実行する前
  • v0 の完了後に生成されたアプリファイルを上書きする前

委譲先：

  • ルートの選択は project-init-orchestrator
  • v0 で生成されていない既存リポジトリに限り agent-folder-init
  • 修復／カスタマイズは testing-cicd-init、linter-formatter-init、shadcn-setup
  • 生成されたワークスペース内の段階的なモジュール追加は scaffold

デフォルトの v0 ルート

新しい Shipshit.dev 製品リポジトリでは、次を実行します。

npx @shipshitdev/v0 <project-directory>

ユーザーから十分な詳細が提供されている場合は、非対話モードを使用します。

npx @shipshitdev/v0 <project-directory> \
  --scope "<product scope>" \
  --agent codex \
  --apps web,app,desktop,mobile,extension,cli \
  --routes overview,new-task,search,inbox,activities \
  --no-github

CI／スモークテストの場合、またはユーザーがスキャフォールドの書き出しのみを希望する場合は、--skip-agent、--no-install、--no-start を使用します。

従来の手動ルート

v0 が適切でない場合、または既存のワークスペースを拡張する場合に限り使用します。 v0 を利用できない場合、またはユーザーが明示的に v0 を使わないことを希望する場合を除き、新しい Shipshit.dev 製品リポジトリには使用しないでください。

スタック：Next.js 16 + React 19 + TypeScript + Tailwind + @agenticindiedev/ui（フロントエンド）、NestJS 11 + MongoDB + Clerk Auth + Swagger（バックエンド）、Vitest 80% カバレッジ + Biome + Husky + GitHub Actions CI/CD、Bun パッケージマネージャー。

手順、生成される構造、主要なコードパターン、開発コマンドの全容については、references/legacy-manual-route.md を読み込んでください。

リファレンス

  • references/templates/ - コード生成テンプレート
    • service.spec.template.ts - NestJS サービスの単体テスト用テンプレート
    • controller.spec.template.ts - NestJS コントローラーの単体テスト用テンプレート
    • e2e.spec.template.ts - supertest + MongoDB Memory Server を使用した E2E テスト用テンプレート
    • component.spec.template.tsx - React コンポーネントのテスト用テンプレート
    • hook.spec.template.ts - React フックのテスト用テンプレート
    • test-setup.template.ts - Clerk のモックを使用したフロントエンドのテスト設定
  • references/vitest.config.ts - バックエンドの Vitest 設定（80% カバレッジ）
  • references/vitest.config.frontend.ts - フロントエンドの Vitest 設定（jsdom）
  • references/github-actions/ci.yml - CI/CD ワークフロー
  • references/architecture-guide.md - アーキテクチャ上の決定事項
  • references/coding-standards.md - コーディング規則

コメント

Markdown 対応