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选择 Agent 交接方式
  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 风格的简介
  • 选定的应用界面和产品路由
  • Agent 交接偏好：codex、claude 或 skip-agent

输出：

  • 使用的 v0 命令或交互式流程
  • 生成的工作区摘要
  • 质量门禁和启动状态
  • 应用专属定制的后续任务

创建/修改：

  • 运行 v0 时创建新的 Bun/Turbo 产品仓库
  • v0 生成的 .agents/skills、.agents/memory、.claude、.codex、apps、packages 和 .v0 文件
  • 仅在 v0 生成后进行定制时创建应用专属文件

外部副作用：

  • 可能会安装依赖并启动 apps/web
  • 仅在明确启用 GitHub 标志时，才可能创建 GitHub 仓库/问题

需要确认：

  • 创建 GitHub 仓库或问题之前
  • 在非空目录中运行之前
  • v0 完成后覆盖生成的应用文件之前

委派给：

  • project-init-orchestrator，用于选择流程
  • agent-folder-init，仅用于未通过 v0 生成的现有仓库
  • 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 不可用或用户明确选择绕过，否则不要用于新的 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 hook 测试模板
    • 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