wxxzy

branch-vibe

Vibe Mode 平行探索分叉。当想尝试完全不同的技术栈/风格/架构而不覆盖当前原型时使用。基于 git worktree 隔离，允许多个方向并行探索。

cost-report

成本报告技能。汇总 token 消耗、时间投入、外部 API 费用到 docs/cost-ledger.md，产出周期性回顾。跨模式使用。

debt-log

技术债登记与查询。记录、更新、还清技术债条目，维护 docs/debt-ledger.md。跨模式使用。

AI & Automation Listed

explain-back

项目状态非技术语言汇报。用非技术语言告诉用户"我们现在项目是什么状��、做到哪一步、下一步该做什么"。适合走开一段时间回来的用户，或非技术背景的用户。

graduate

原型晋升。将 sandbox/ 下经过验证的原型正式迁移到 src/，补齐工程标准（ADR、测试、命名规范）。

AI & Automation Listed

micro-adr

微观架构决策记录。用于记录不足以写完整 ADR 的技术选型（如"为什么选 zustand 不用 jotai"）。追加到 docs/arch/micro-adr.md，一决策一行。

taste-review

Vibe Mode 审美/体验维度评审。当原型功能已可跑但用户对"感觉不对"、视觉/交互氛围有疑虑时使用。产出 docs/reviews/taste-<date>.md。

usds-cost-report

【共享】成本核算 — 汇总 token/时间/API 费用 → docs/cost-ledger.md。当用户说「花了多少/成本报告」时使用。

usds-debt-log

【共享】技术债登记 — 记录/更新/还清债务条目 → docs/debt-ledger.md。当用户说「记债/查债」时使用。

usds-micro-adr

【共享】微决策记录 — 一行记录不值得写完整 ADR 的小型技术选型 → docs/arch/micro-adr.md。当用户说「为什么选 X/记一下这个决策」时使用。

vibe-branch

【Vibe】平行探索分叉 — 用独立 git worktree 探索不同技术栈/风格 → .worktrees/<name>/。当用户说「试试完全不同的方向」时使用。

AI & Automation Listed

vibe-explain-back

【Vibe】状态回顾 — 用非技术语言说明项目现状与下一步 → 一次性汇报。当用户说「刚回来/现在什么状态」时使用。

vibe-graduate

【Vibe→Studio】原型晋升 — 将 sandbox 原型迁入 src/ 并补齐 ADR/测试/规范 → 生产代码。当用户说「原型稳了/转正」时使用。

vibe-taste-review

【Vibe】审美评审 — 视觉/交互氛围评价 → docs/reviews/taste-<date>.md。当用户说「不好看/感觉不对劲」且原型已可跑时使用。

Web & Frontend Listed

arch-design

架构设计与影响分析。当用户需要定义 API 契约、数据库模型或记录架构决策（ADR）到 docs/arch/ 时使用。

discovery

结构化需求发现。当用户提出一个新想法、需要把模糊需求转化为 PRD（产品需求文档）并写入 docs/specs/ 时使用。

mode-switch

双模态切换。在 Vibe Mode（探索/原型）和 Studio Mode（严肃/生产）之间切换，或初始化模式声明。

prototype

快速原型技能。跳过架构设计和 ADR，直接在 sandbox/ 下产出可运行 demo。目标是 15 分钟内让用户看到能跑的东西。

sprint-kickoff

冲刺任务拆解。当架构确定后需要把设计拆解为可执行任务并生成 production/backlog.md 时使用。

start

工作室智能启动引导。当用户首次进入��目、不确定从何开始，或想了解该走新项目/维护项目/入职哪条路径时使用。

summarize-arch

架构快照与总结。当多个 ADR 累积后需要压缩汇总为架构最终态文档（ARCHITECTURE-STATE.md）时使用。

update

自动检查并同步工作室基础设施至 GitHub 最新版本。当用户要求更新 USDS、检查新版本或同步 .claude 配置时使用。

vibe-check

【Vibe】意图校准 — 重新对齐「最初想要 vs 现在做出」→ docs/specs/intent-log.md。当用户说「感觉不对/方向偏了」或原型迭代 3-5 轮后使用。

vibe-start

【Vibe】轻量意图捕获 — 3-5 轮对话把想法变成 spec → docs/specs/lite-spec.md。当用户说「快速试个东西/做个小玩具」时使用。

Web & Frontend Listed

studio-arch-design

【Studio】架构设计 — API 契约、数据模型、ADR → docs/arch/ADR-*.md。当用户说「设计架构/定义 API」时使用。

studio-discovery

【Studio】需求发现 — 把模糊想法转化为 PRD → docs/specs/PRD.md。当用户说「有个项目想法/写份需求文档」时使用。

studio-gate-check

【Studio】发布门控 — QA 按发布清单做最后质量验证 → RELEASE-CHECKLIST。当用户说「准备发布/上线前把关」时使用。

studio-project-scan

【Studio】代码库扫描 — 映射既有项目、识别技术债 → docs/arch/SYSTEM-MAP.md + TECH-DEBT.md。当用户说「分析这个项目/代码库现状」时使用。

studio-review

【Studio】技术评审 — 性能/可维护性/安全代码审计 → 评审报告。当用户说「评审代码/审查这段实现」时使用。

studio-setup-stack

【Studio】技术选型与骨架 — 选定技术栈、生成脚手架与依赖文件 → 项目骨架。当用户说「搭架子/初始化项目」时使用。

studio-sprint-kickoff

【Studio】冲刺启动 — 把设计拆解为可执行任务 → production/backlog.md。当用户说「拆任务/开个冲刺」时使用。

studio-summarize-arch

【Studio】架构快照 — 汇总累积的 ADR 为最终态 → ARCHITECTURE-STATE.md。当用户说「总结下当前架构」时使用。

usds-mode-switch

【共享】双模态切换 — 初始化/切换 .usds-mode（vibe/studio/hybrid）→ 模式声明文件。当用户说「切换模式/严肃点/放松点」时使用。

usds-onboard

【共享】入职演练 — 五步协作法、代理分工、目录规范 → 协议摘要。当用户说「入职/怎么协作」时使用。

usds-start

【共享】入口引导 — 路由新项目/维护/入职路径 → 路由建议。当用户说「怎么开始/有什么能做」时使用。

usds-update

【共享】框架更新 — 检查并同步 .claude 配置至 GitHub 最新版本 → 更新后的框架文件。当用户说「更新 USDS/检查新版本」时使用。

vibe-prototype

【Vibe】快速原型 — 跳过架构与 ADR，15 分钟出可跑 demo → sandbox/<name>/。当用户说「做个原型/试一版/搞个 demo」时使用。

gate-check

发布前质量门控审计。当代码即将交付、需要 QA 按发布清单做最后质量验证时使用。

onboard

团队新人入职引导。当新成员需要了解 USDS 的五步协作法、代理分工与目录规范时使用。

project-scan

已有项目扫描与映射。当用户需要分析现存代码库的架构、识别技术债或为维护型项目建立系统地图时使用。

review

技术评审与深度代码审计。当开发完成、发布前需要架构师从性能、可维护性与安全角度审查代码实现时使用。

setup-stack

技术选型与项目骨架初始化。当用户确定需求后需要选择技术栈、生成项目脚手架与依赖文件时使用。