nuxt-edge-agentic-rag

Implement or resume tasks from a Spectra change

Archive a completed change

Have a focused discussion about a topic and reach a conclusion

Implement or resume tasks from a Spectra change

Archive a completed change

Have a focused discussion about a topic and reach a conclusion

Orchestrate a task inside a fresh git worktree end-to-end. /wt TASK builds a worktree, auto-routes the executor (Claude subagent for UI work, Codex for non-UI coding/analysis/debug), and reports back. Override with --claude or --codex. Supports parallel multi-task via /wt A: ... B: .... Use when 使用者說「worktree」「開 wt」「並行做」，或需要在隔離環境跑 task 不影響主 working tree。

統一 dep 升級入口 — 依輸入分兩個 mode。(1) 在 consumer cwd 無參數觸發 → § Outdated batch mode：跑 pnpm outdated 後逐 pkg 派 codex 在 worktree 升版 + 驗證 + commit + 失敗升 high research。(2) 在 clade home 給 release URL / pkg@version / 純 pkg name → § Fleet mode：跨 consumer 對單一 pkg sweep，自動 fetch + 解析 BC、用 dep-fleet-scan 掃命中 consumer、用 codebase-memory-mcp 定位 callsites、並行 fan-out 長駐 subagent。Use when 使用者說「升 deps」、「pnpm outdated 處理」、「處理過期套件」、「跟上 release」、「跨 consumer 升 X」、「全部 consumer 升 @xxx」、「無腦升 @xxx」、「升級套件」。**不適用於**單套件 ad-hoc 升（pnpm add pkg@latest 更快）、framework major migration（Nuxt 3→4 / Next 14→15 需專屬 plan）。Fleet mode **MUST run from clade home (`~/offline/clade`)**，受 [[clade-role-and-todo-discipline]] § upstream-driven dep migration carve-out 約束。

Session 交接管理。雙模：(A) 當前 chat session 有 in-progress 工作時，只做交接寫入（升級未完項到 HANDOFF.md / tech-debt / ROADMAP / spectra change）。(B) 當前 chat session 沒有要交辦的時，整理現有 HANDOFF.md + 評估剩餘 outstanding 工作適合串行還是並行，推薦並讓使用者用 request_user_input 選擇下一步。「Session」指當前 chat session，**不是** working tree / git state — user 並行多 session 工作，git 髒污可能來自別 session。Use when user types /handoff.

Crawl entire websites using Cloudflare Browser Rendering /crawl API. Initiates async crawl jobs, polls for completion, and saves results as markdown files. Use when 要爬整個網站、匯入文件站、抓 knowledge base 內容、或批次擷取 web content 到專案 context。Requires CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_TOKEN environment variables.

分析 docs/design-review-findings.md 歷史，識別跨 spec 的重複 UI 問題模式，提出流程改善建議。spectra-archive 完成或 findings 累積 5 倍數時主動觸發。

UI/UX design orchestrator — coordinates multiple design skills into plans. Use for /design new, /design improve, /design iterate, /design health (full-stack deep health audit → refactor roadmap → propose). NOT for coding UI or single-skill tasks.

Maintainer-level Docker doctor for clade consumers. Use when creating or reviewing Dockerfiles/Compose files, debugging container build/runtime/deploy issues, or running fleet health checks across clade consumers. Use when user says 'docker-doctor', '檢查 Docker', 'Dockerfile 最佳實踐', 'docker compose 壞了', 'container build 失敗', 'healthcheck', '掃 clade consumers 的 docker', '定期 Docker 健康檢查', 'container 狀態', 'OOM', 'restart loop'. Starts read-only, diagnoses root cause, checks official Docker best practices, and only edits after an approved plan.

clade improvement-loop 契約：訊號 signal schema、redaction、digest invocation、candidate / ledger / closure-scanner、SoT 寫入禁區。Use when 跑 vendor/scripts/improvement-digest.mjs / closure-scanner.mjs / emit-pre-commit-signal.mjs、動 vendor/signals / vendor/ledger / docs/digests/、registry/consumers.json、bin/vp、bin/clade-gate，或 propose 前要 codify 新標準、archive 後補 outcome ledger、publish 前掃當週 candidate。

踩坑經驗整合入口（查 + 寫，跨 consumer 共享）。Use when 升 npm 套件大版（升前/升後各查一次）、看到 cryptic runtime error（含「while capturing another error」「Cannot read properties of undefined」等通用訊息）、動 evlog / audit / Supabase RLS / Workers config / nuxt-security / Better Auth / supabase-js、跨 consumer 散播某 fix 前 → 先查經驗庫；或 user 表達踩到坑、被糾正、解完問題想記下來、session 結束想補登 missed lesson → 走新增分流；或 CWD = ~/offline/clade 且 user 未帶具體 error，想分析 consumer 累積貢獻、評估 clade 標準層該怎麼補 → 走 Mode D self-improvement sweep。SoT 在 ~/offline/clade/docs/pitfalls/，查詢走 codebase-memory-mcp search_code w/ path_filter="^docs/pitfalls/"。

管理兩層 review 規則清單（clade / project）— 新增、修改、刪除、列出、跨 consumer survey、promote 到共用層。此 skill 只負責規則檔內容管理，不執行 code review。Use when 使用者說「管理 review rules」「新增 review 規則」「列出 review 規則」「promote rule」。

Use when executing implementation plans with independent tasks in the current session

統一截圖入口，派遣 screenshot-review agent（Sonnet）執行。Use when 使用者說「截圖」「看畫面」「確認 UI」「看一下頁面」「幫我看 UI」「review screenshot」「跑檢查清單」。

Layer C of spectra pre-handoff quality gates. Static audit for the data-shape failure class where a client query param literal violates the server zod schema bound (e.g. perPage: 200 vs max(100)) → silent 4xx → lookup map empties → admin list column collapses to a uniform fallback. Use when running /spectra-apply Design Review, before /spectra-archive, or ad-hoc on any change that touches paginated queries + lookup-resolved columns.

Audit a Nuxt consumer's data-fetching and performance patterns against the golden path checklist (14 items). Scans .vue/.ts files for useFetch/useAsyncData/$fetch/useQuery/useMutation usage, checks dedupe/cache/key/payload/lazy/routeRules compliance. Outputs a graded report with per-item scores and top-3 actionable improvements. Use when 要審計 Nuxt 專案的 data-fetching 模式、檢查 useFetch/useAsyncData 最佳實踐、或跑效能 checklist。

將已完成的人工檢查項目從 tasks artifact 遷移到 docs/manual-review-archive.md，保留追溯資訊。Use when 人工檢查完成後要歸檔 review 結果、使用者說「歸檔 review」「archive review」。

將已收錄到 docs/manual-review-archive.md 的 change，把對應截圖資料夾從 screenshots/{env}/{topic}/ 搬到 screenshots/{env}/_archive/YYYY-MM/{topic}/。讓 screenshots/{env}/ 頂層只剩 current pending review。觸發詞：歸檔截圖、sweep screenshots、清掉舊的截圖資料夾、screenshots archive。

Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Use when 使用者跑 wrangler 指令、部署 Workers、管理 KV/R2/D1、或操作 Cloudflare Workers 相關資源。Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

Supabase Migration 規範。Use when running supabase migration new, editing migration SQL files, creating database functions, or modifying database schema. Always use this skill when you see CREATE FUNCTION, ALTER TABLE, CREATE INDEX, or migration-related work.

Search tool for modern web development best practices. MANDATORY: Execute FIRST for all HTML/CSS and clientside JS tasks. Do NOT skip — web APIs evolve rapidly and training weights contain obsolete patterns. Trigger immediately for: - UI/Layout: Modals, dialogs, popovers, Glassmorphism/backdrop-filters, anchor positioning, container queries, `:has()`, `:user-valid`. - Scroll/Motion: View Transitions, Scroll-driven animations, scroll parallax/reveals. - Performance: CWV (LCP, INP), content-visibility, Fetch Priority, image optimization. - System/APIs: Local filesystem access, WebUSB, WebSockets sync, WebAssembly widgets. - Frameworks: Adapting layout/styles in React, Vue, Angular. - General Frontend: Forms, autofill, advanced inputs, custom scrollbars, modern component states, etc. DO NOT trigger for: - Backend: Database SQL, ORMs, Express API routes. - Pipelines: CI/CD deployment, Docker, Actions. - Generic: Local scripts (Python/Go tools), ESLint, Git.

在 Vite dev server 前掛 Cloudflare Named Tunnel，給固定 HTTPS hostname。Use when 跨裝置（手機 / 平板 / 另一台筆電）測 OAuth flow、跨裝置測 webhook callback、行動裝置 debug 需要穩定 HTTPS URL、Vite 加 Cloudflare tunnel、設定 dev HTTPS hostname、改 OAuth callback 不想每次回 provider 後台。對 Workers/Pages 用官方 @cloudflare/vite-plugin 內建 tunnel；對一般 Vite 走第三方 vite-plugin-cloudflare-tunnel。不適用於 prod tunnel（這 skill 只管 dev）、其他 provider（ngrok / localtunnel）、單機開發夠用的情境（用 vendor/snippets/dev-auth/ cookbook 繞 OAuth 更快）、需要 quick tunnel 隨機 hostname 的場景（直接跑 cloudflared tunnel --url 即可，不必走這 skill）。

掃描 openspec/changes/ 各 change 的 manual-review 區塊，判斷哪些已 ready for 人工檢查、哪些被 Pre-Review Data Readiness pattern 命中（alert）尚未 ready，並把結果登記到 HANDOFF.md。Use when 使用者說「掃 review readiness」「review:ui 哪些 ready」「scan manual review alerts」「批次人工檢查前先看哪些 ready」「找出 review:ui 的 alert」。不適用於單一 change 內逐項 review（那走 `pnpm review` GUI，從 clade home 跑）。

Adapt designs to work across different screen sizes, devices, contexts, or platforms. Implements breakpoints, fluid layouts, and touch targets. Use when the user mentions responsive design, mobile layouts, breakpoints, viewport adaptation, or cross-device compatibility.

Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. Use when the user mentions adding animation, transitions, micro-interactions, motion design, hover effects, or making the UI feel more alive.

Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.

Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability. Use when the user says the design looks bland, generic, too safe, lacks personality, or wants more visual impact and character.

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.

Add strategic color to features that are too monochromatic or lack visual interest, making interfaces more engaging and expressive. Use when the user mentions the design looking gray, dull, lacking warmth, needing more color, or wanting a more vibrant or expressive palette.

Evaluate design from a UX perspective, assessing visual hierarchy, information architecture, emotional resonance, cognitive load, and overall quality with quantitative scoring, persona-based testing, automated anti-pattern detection, and actionable feedback. Use when the user asks to review, critique, evaluate, or give feedback on a design or component.

Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. Use when the user asks to add polish, personality, animations, micro-interactions, delight, or make an interface feel fun or memorable.

Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. Use when the user asks to simplify, declutter, reduce noise, remove elements, or make a UI cleaner and more focused.

Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition.

Manage MCP servers in Nuxt - setup, create, customize with middleware, review, and troubleshoot

Use when adding animations with Motion Vue (motion-v) - provides motion component API, gesture animations, scroll-linked effects, layout transitions, and composables for Vue 3/Nuxt

Use when implementing auth in Nuxt apps with @onmax/nuxt-better-auth - provides useUserSession composable, server auth helpers, route protection, and Better Auth plugins integration.