메뉴
建立或檢查 opencode-bootstrap-json metadata。當使用者要求 scaffold commands、verification commands、runtime smoke checks、health URLs、project roles、setup order、framework/add-on/bootstrap metadata 或修正 skill bootstrap 邊界時使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | opencode-bootstrap-json |
| description | 建立或檢查 opencode-bootstrap-json metadata。當使用者要求 scaffold commands、verification commands、runtime smoke checks、health URLs、project roles、setup order、framework/add-on/bootstrap metadata 或修正 skill bootstrap 邊界時使用。 |
使用這個 skill 產生精簡、可執行、邊界清楚的 opencode-bootstrap-json fenced block。這個規範 skill 的 body 使用說明與範例，其他 executable project skill 才放可執行 bootstrap block。
category:"testing" 與跨框架 frameworks，並在使用者選用或要求 testing 時執行。role:"any" 適合真正跨 repo 的流程與 docs-only README rule skill，例如 readme-i18n-greenfield 搭配 category:"readme-docs"。category、frameworks、requiresPrimarySkills 或 requiresUiKitSkills 表達依賴。scaffoldCommand 與 verificationCommands，讓 Greenfield assignedSkills 能載入純文件規則。scaffoldCommand，並用 bundled script launcher 承載多步驟邏輯。pnpm build, npm run build, yarn build, bun run build, uv run python -m compileall, or equivalent framework compile checks./tmp/opencode-build 執行；metadata 仍保留原始 build command 作為 canonical verification intent，source of truth 仍是 target repo。role: frontend、backend 或 any。只有真正跨 repo 的能力使用 any。category: 可選，用來區分 framework、ui-kit、api-client、testing、readme-docs、docker、compose、devops 等 skill 類型。framework / frameworks: framework scaffold 或 add-on 適用範圍。uiKit: UI kit add-on 名稱。requiresPrimarySkills: add-on 依賴的 framework skill。requiresUiKitSkills: pattern/index skill 依賴的 UI kit skill。order: 執行順序。framework scaffold 通常最早，add-on 後面。packageManager: pnpm、npm、yarn、bun、uv、docker 等；會自行偵測 lockfile 的 Node script launcher 用 node。scaffoldCommand: 初始化或補檔 command array。verificationCommands: 驗證 command array。Framework skill 放 project-wide build/compile；add-on skill 放 integration/config check。runtimeSmokeCommand: 啟動 runtime smoke test 的 command。沒有 runtime component 時省略或留空。runtimeSmokeHealthUrl: runtime smoke check URL。沒有 health URL 時省略或留空。多步驟檔案產生邏輯放在 bundled script，metadata 只保留短 launcher：
"if test -f .opencode/skills/<skill-name>/scripts/bootstrap-<name>.cjs; then node .opencode/skills/<skill-name>/scripts/bootstrap-<name>.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/<skill-name>/scripts/bootstrap-<name>.cjs; fi"
使用 .cjs，讓 script 在目標專案的 type: module 設定下仍維持穩定。script 本身要能重複執行，保留既有使用者檔案，並清楚回報真正錯誤。
以下範例使用 jsonc fence，讓本規範 skill 保持文件用途。實際寫入其他 project skill 時使用 opencode-bootstrap-json fence。
Framework scaffold:
{
"role": "frontend",
"category": "framework",
"framework": "react-vite",
"order": 0,
"packageManager": "pnpm",
"scaffoldCommand": [
"pnpm create vite . --template react-ts --no-interactive",
"if test -f .opencode/skills/react-vite-feature-based/scripts/bootstrap-01-02.cjs; then node .opencode/skills/react-vite-feature-based/scripts/bootstrap-01-02.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/react-vite-feature-based/scripts/bootstrap-01-02.cjs; fi"
],
"verificationCommands": ["pnpm build"],
"runtimeSmokeCommand": "pnpm dev --host 127.0.0.1 --port $PORT --strictPort",
"runtimeSmokeHealthUrl": "http://127.0.0.1:$PORT/"
}
UI kit add-on:
{
"role": "frontend",
"category": "ui-kit",
"uiKit": "nuxt-ui",
"frameworks": ["nuxt", "nuxt4"],
"requiresPrimarySkills": ["nuxt4-creater"],
"order": 30,
"packageManager": "node",
"scaffoldCommand": [
"if test -f .opencode/skills/nuxt-ui/scripts/bootstrap-00-install.cjs; then node .opencode/skills/nuxt-ui/scripts/bootstrap-00-install.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/nuxt-ui/scripts/bootstrap-00-install.cjs; fi",
"if test -f .opencode/skills/nuxt-ui/scripts/nuxt-ui-bootstrap.cjs; then node .opencode/skills/nuxt-ui/scripts/nuxt-ui-bootstrap.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/nuxt-ui/scripts/nuxt-ui-bootstrap.cjs; fi"
],
"verificationCommands": [
"if test -f .opencode/skills/nuxt-ui/scripts/verify-build.cjs; then node .opencode/skills/nuxt-ui/scripts/verify-build.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/nuxt-ui/scripts/verify-build.cjs; fi"
]
}
API client add-on:
{
"role": "frontend",
"category": "api-client",
"frameworks": ["react-vite", "vue-vite", "nuxt", "nuxt4"],
"order": 20,
"packageManager": "node",
"scaffoldCommand": [
"if test -f .opencode/skills/api-client/scripts/bootstrap-api.cjs; then node .opencode/skills/api-client/scripts/bootstrap-api.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/api-client/scripts/bootstrap-api.cjs; fi"
],
"verificationCommands": []
}
Testing add-on:
{
"role": "frontend",
"category": "testing",
"testing": "playwright",
"frameworks": ["frontend", "web", "static", "vite", "react-vite", "vue-vite", "nuxt", "nuxt4", "next", "sveltekit", "astro", "angular"],
"order": 40,
"packageManager": "node",
"scaffoldCommand": [
"if test -f .opencode/skills/playwright-e2e-testing/scripts/bootstrap-01-01.cjs; then node .opencode/skills/playwright-e2e-testing/scripts/bootstrap-01-01.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/playwright-e2e-testing/scripts/bootstrap-01-01.cjs; fi"
],
"verificationCommands": [
"if test -f .opencode/skills/playwright-e2e-testing/scripts/verify-list.cjs; then node .opencode/skills/playwright-e2e-testing/scripts/verify-list.cjs; else node ${OPENCODE_PROJECT_SKILLS_PRESEEDED_DIR:-/app/.opencode/skills}/playwright-e2e-testing/scripts/verify-list.cjs; fi"
]
}
README docs-only rule:
{
"role": "any",
"category": "readme-docs",
"order": 90,
"packageManager": "none",
"scaffoldCommand": [],
"verificationCommands": []
}
category 與 dependency fields？scaffoldCommand 是否只包含穩定短指令或 bundled script launcher？$PORT？React-only Zustand state management skill for React SPA Vite and Next.js projects. Use when adding, configuring, bootstrapping, or refactoring Zustand stores, typed selectors, vanilla stores, client providers, persistence boundaries, or migration from ad hoc React state to Zustand. Do not use for Vue, Nuxt, Svelte, Angular, Remix, React Native, or non-React state libraries.
Vue-only Pinia state management skill for Nuxt 3/4 and Vue SPA Vite projects. Use when adding, configuring, bootstrapping, or refactoring Pinia stores, @pinia/nuxt modules, createPinia app registration, typed stores, storeToRefs usage, SSR-safe Nuxt state, store actions, getters, persistence boundaries, or migration from ad hoc Vue state to Pinia. Do not use for React, Next.js, Svelte, Angular, or non-Vue state libraries.
建立與維護 FastAPI 後端專案架構、feature 模組、router、Pydantic schema、service layer、app factory 與 app router 註冊。使用者提到 FastAPI endpoint、backend project architecture、backend feature、router、schema、service、request/response DTO、health endpoint 或 FastAPI greenfield backend 時使用。
Nuxt 4 通用專案建立、啟動、驗證與維護。首次建立新專案時 scaffold Nuxt app 與 section composition 架構：共用 components 組成 page-specific content sections，多個 content sections 組成 route pages。當需要建立或初始化 Nuxt 4 專案、建立 app/server/shared 目錄架構、加入 pages、app/content、components、composables、plugins、stores、server routes，或處理路由、SEO/meta、runtime config、Nuxt plugin warnings、模組與部署前驗證時使用。
Framework-agnostic Playwright E2E testing skill for frontend web apps. Use when a project needs end-to-end tests, browser workflow tests, cross-browser checks, form/auth flows, route smoke tests, visual regression, CI E2E setup, Playwright config, or flaky E2E debugging across React, Vue, Nuxt, Next.js, SvelteKit, Astro, Angular, Vite, static sites, or any browser-rendered frontend.
React + Vite feature-based frontend scaffold and maintenance skill. Use when creating or updating React/Vite projects with src/app, src/features, src/shared, routing, pages, components, hooks, types, assets, and feature-oriented refactors.