Agent Skills › LanternOps/breeze › worktree-stack

worktree-stack

GitHub

为当前 git worktree 提供隔离的测试环境，自动启动包含数据库、API 和前端的全栈服务，并输出连接信息以便驱动 Playwright 进行端到端测试。

.claude/skills/worktree-stack/SKILL.md LanternOps/breeze

Trigger Scenarios

需要为特定工作区启动完整的测试环境准备 Playwright 端到端测试所需的运行实例

Install

npx skills add LanternOps/breeze --skill worktree-stack -g -y

More Options

Non-standard path

npx skills add https://github.com/LanternOps/breeze/tree/main/.claude/skills/worktree-stack -g -y

Use without installing

npx skills use LanternOps/breeze@worktree-stack

指定 Agent (Claude Code)

npx skills add LanternOps/breeze --skill worktree-stack -a claude-code -g -y

安装 repo 全部 skill

npx skills add LanternOps/breeze --all -g -y

预览 repo 内 skill

npx skills add LanternOps/breeze --list

SKILL.md

Frontmatter

{
    "name": "worktree-stack",
    "description": "Use when an agent needs a running, seeded, Playwright-ready Breeze stack for the current git worktree. Brings up pg+redis+api+web+portal+caddy running the worktree's own code and emits a JSON descriptor."
}

Worktree Test Stack

Loop for testing the current worktree end to end:

Bring up the stack (per-worktree isolated): pnpm wt-stack up
- Add --shared for the singleton stack (ports are always ephemeral, read from .breeze-stack.json).
- Add --rebuild after Dockerfile or dependency changes.
Read .breeze-stack.json at the worktree root for baseUrl, apiUrl, portalUrl, and admin creds (admin@breeze.local / BreezeAdmin123!).
Drive Playwright: pnpm wt-stack test -- tests/<spec>.spec.ts, or point the Playwright MCP browser at baseUrl.
Tear down: pnpm wt-stack down (removes volumes by default).

Notes:

Requires Node v22.20.0 on PATH and a populated root .env (image refs).
Caddy serves plain HTTP in dev; baseUrl is http://localhost:<port>.
OrbStack is recommended for speed but not required — the CLI uses only the standard docker compose interface.
pnpm wt-stack ls lists running stacks; pnpm wt-stack info prints the descriptor.