Guide

---
name: guide
description: Hub skill 地圖：本 repo 實際裝到的 skill 的使用場景、邊界與銜接流程（router，零 context 成本；依 .claude/hub.json 分層）。
disable-model-invocation: true
metadata:
  author: clade
  version: "1.0"
permission_tier: read-only
---
<!-- 🔒 LOCKED — managed by clade · auto-generated by sync-to-cursor; edit source in .claude/ then re-run sync -->

# /guide — hub skill 地圖

不確定該用哪個 skill 時打 `/guide`。本 skill 是 router：描述每個 skill 的適用場景與銜接關係，本身不執行任何工作。讀完後直接 invoke 對應 skill。

## 先看這個：本表分層，不是每一支你都裝了

skill 由 `.claude/hub.json` 的 `modules` 決定裝哪些。下表的條目帶標記時，**只有宣告對應 module 的 repo 才有那支 skill**——沒宣告就是打了也不存在，不是壞掉：

| 標記 | 需要 `.claude/hub.json` 宣告 | 沒宣告的 repo |
| --- | --- | --- |
| 〔openspec〕 | `modules.capabilities` 含 `"openspec"` | 沒有 spectra 家族。待辦走 HANDOFF / tech-debt / ROADMAP，`/work-loop` 照樣能跑 |
| 〔nuxt〕 | `modules.framework` = `"nuxt"` | 沒有 Nuxt 專用的稽核與 dev 工具 |
| 〔node〕 | `modules.ecosystem` 含 `"node"` | 沒有 `/dep-upgrade`（它綁 npm/pnpm，不是綁 Nuxt） |

無標記的是 hub-core，每個 consumer 都有。**NEVER** 因為本表列了某支就斷定這裡裝了它——以 `.claude/hub.json` 為準。

## 主流程（idea → shipped）

一條 change 的完整生命週期，依序銜接：

| 階段 | Skill | 這一站做什麼 |
| --- | --- | --- |
| 提案〔openspec〕 | `/spectra-propose` | 建 change proposal + 全套 artifacts（tasks / design / spec delta） |
| 討論〔openspec〕 | `/spectra-discuss` | 對單一 topic 聚焦討論、收斂結論（提案前後皆可插入） |
| 實作〔openspec〕 | `/spectra-apply` | 按 tasks.md 逐 phase 實作或 resume |
| 驗證〔openspec〕 | `/spectra-verify` | 比對 implementation 與 artifacts，出 assessment + evidence |
| 人工檢查 | `pnpm review:ui`（GUI）；批次前先 `/review-readiness-scan` 看哪些 ready | UI / 資料類 manual review |
| 歸檔〔openspec〕 | `/spectra-archive` | change 收尾：spec delta 合併、搬 archive、自動 sweep 截圖 |
| 提交 | `/commit` | 依功能分組走品質閘門提交（所有 commit 的唯一入口） |

不確定專案當前該走哪一站：`/spectra`〔openspec〕（orchestrator）會依 project state 自動判斷並 invoke 對應 sub-skill。沒宣告 openspec 的 repo 整條主流程不適用——那裡的生命週期是「待辦來源 → `/wt` → `/commit`」。

## On-ramps（從症狀進入）

- **遇到 bug / 異常行為** →〔openspec〕`/spectra-debug`（四階段系統化 debug）
- **要看 UI 畫面 / 截圖驗證** → `/review-screenshot`（統一截圖入口，派遣 screenshot-review agent；不要在主 session 直接跑截圖命令）
- **專案還沒有可重跑的 app control／feature map** → `/verification-create`（建立 consumer-owned `verify-<app>` skill）
- **既有 verification skill／feature map 要對帳 source 與 live behavior** → `/verification-maintain`（`clean` 是零 branch／零 commit／零 PR 的成功結果）
- **要動 code 而還在 main working tree** → `/wt`（開 worktree 隔離；`/wt A: ... B: ...` 可並行多條 task）
- **implementation plan 內有多個獨立 task 想並行** → `/subagent-dev`（同 session 派 subagent；跨 change 的並行仍走 `/wt`）
- **session 要收尾 / 交接** → `/handoff`（有 in-progress 工作寫交接；沒有則整理 HANDOFF.md 推薦 outstanding）
- **要把待辦無人值守推完**（spectra change / HANDOFF / tech-debt / ROADMAP）→ `/work-loop`（自主推進 loop；一次性任務不適用）
- **外部新資訊要更新既有 change** →〔openspec〕`/spectra-ingest`
- **問 openspec 文件內容** →〔openspec〕`/spectra-ask`；**查 change 與 codebase 是否漂移** → `/spectra-drift`；**查 artifacts 一致性** → `/spectra-analyze`
- **安全視角掃 changed code** →〔openspec〕`/spectra-audit`

## 歸檔三兄弟的邊界

三個 archive skill 各管一種資產，不互相替代：

- `/spectra-archive`〔openspec〕 — 歸檔**完成的 change**（openspec）；完成時自動觸發截圖 sweep
- `/review-archive` — 歸檔**已結束的人工檢查結果**（manual review → docs/manual-review-archive.md）；完成時同樣自動 sweep 截圖
- `/screenshots-archive` — 只搬**截圖資料夾**到 `_archive/`；通常由上面兩個自動呼叫，手動跑用於補救 pending sweep

## 品質 / 稽核類（standalone）

- `/design` — design orchestrator（new / improve / iterate / health）
- `/design-retro` — 分析歷史 design review findings 找重複模式
- `/nuxt-data-audit`〔nuxt〕 — 審計 Nuxt data-fetching 模式與效能 golden path
- `/data-sanity`〔nuxt〕 — 偵測 client-server schema mismatch（review 前 / archive 前跑）

## User-invoked（model 不會自動觸發，要自己記得）

以下 skill 已設 `disable-model-invocation`——model 看不到它們的 description，**必須手動打指令**：

- `/dep-upgrade`〔node〕 — 單 consumer outdated batch 或跨 fleet 單套件 sweep 升級（副作用大，故不讓 model 自主觸發）
- `/vite-tunnel`〔nuxt〕 — 建 Cloudflare Named Tunnel 給 dev server（跨裝置 OAuth / webhook 測試）
- `/guide` — 本 skill

## Commit 相關邊界

- 一般 commit 一律 `/commit`（多閘門品質流程）
- spectra change 檔案的專屬 commit **同樣走 `/commit`**，在 argument 寫明「只 commit `openspec/changes/<name>/` 與該 change 觸動的實作檔」——`/spectra-commit` 已自 clade 移除（consumer 若由 `spectra init` 帶入上游版，PreToolUse hook 仍 fail-closed），**NEVER** 改派
- 兩者都用 `git commit --only` 隔離別 session 的 staged 內容——不要繞過 skill 手打 `git add + git commit`