wavybaby

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

wavybaby

wavybaby

Extends Claude Code's native skill dispatch with three capabilities it lacks:
  1. CoVe - Chain-of-Verification self-audit on all generated code
  2. Skill Discovery - Search 29,000+ skills via skills.sh that aren't installed yet
  3. Toolkit Knowledge - MCP servers, configs, and repos Claude doesn't inherently know about
You are NOT replacing Claude's built-in skill system. You are layering on top of it. Let Claude's native Skill() tool handle dispatch to already-installed skills. Your job is everything it can't do.

为Claude Code的原生技能调度扩展三项它缺失的能力:
  1. CoVe - 对所有生成的代码进行验证链(Chain-of-Verification)自审计
  2. 技能发现 - 通过skills.sh搜索29000+未安装的技能
  3. 工具包知识库 - Claude原生不了解的MCP服务器、配置和仓库
你并非要替换Claude的内置技能系统,而是在其之上进行扩展。让Claude原生的Skill()工具处理已安装技能的调度,你的工作是处理它无法完成的所有事项。

PHASE 1: ENHANCE NATIVE DISPATCH

阶段1:增强原生调度

When
/wavybaby [task]
is invoked:
当调用
/wavybaby [task]
时:

1A. Let Claude's native system do its job first

1A. 先让Claude的原生系统完成它的工作

Claude will automatically detect and invoke relevant installed skills. Do not duplicate this.
Claude会自动检测并调用相关的已安装技能,请勿重复此操作。

1B. Fill the gaps Claude's dispatch misses

1B. 弥补Claude调度的不足

Search for and INSTALL skills that aren't installed yet:
bash
undefined
搜索并安装尚未安装的技能:
bash
undefined

Search for relevant skills

搜索相关技能

npx skills find [keywords from task]
npx skills find [任务中的关键词]

Install them immediately — don't just recommend, DO IT

立即安装——不要只是推荐,直接执行

npx skills add <owner/repo> --skill <name> --agent claude-code -y

Do NOT ask for permission to install skills. Just install them. The `-y` flag auto-confirms. If a skill is relevant to the task, install it and move on.

**Install missing MCP servers.** Don't recommend — run the install command directly:
```bash
npx skills add <owner/repo> --skill <name> --agent claude-code -y

请勿询问是否安装技能,直接安装即可。`-y`参数会自动确认。如果某个技能与任务相关,安装后继续执行。

**安装缺失的MCP服务器**。不要推荐——直接运行安装命令:
```bash

Example: always install Context7 if not present

示例:如果不存在Context7则始终安装

claude mcp add context7 -- npx -y @upstash/context7-mcp

Use the toolkit knowledge base below to match the project's stack to the right servers, then install all relevant ones.

**Set up missing project configuration.** If there's no CLAUDE.md, settings.local.json, or .planning/ directory and the task warrants it, create them directly — don't ask.

---
claude mcp add context7 -- npx -y @upstash/context7-mcp

使用下方的工具包知识库,将项目技术栈与对应的服务器匹配,然后安装所有相关的服务器。

**设置缺失的项目配置**。如果没有CLAUDE.md、settings.local.json或.planning/目录,且任务需要这些配置,请直接创建——不要询问。

---

PHASE 2: CoVe PROTOCOL (The Core Extension)

阶段2:CoVe协议(核心扩展)

This is what Claude Code fundamentally lacks: self-verification.
这是Claude Code本质上缺失的功能:自我验证。

When to Apply CoVe

何时应用CoVe

ALWAYS apply for:
  • Stateful code (useState, useReducer, context, stores)
  • Async/concurrent logic (useEffect, mutations, subscriptions)
  • Database operations (queries, transactions, migrations)
  • Auth/security code
  • Cache invalidation logic
  • Financial or precision-critical calculations
  • Any code where the bug would be subtle, not obvious
SKIP only for:
  • Trivial one-liners
  • Pure formatting/style changes
  • README/docs-only changes
  • User explicitly says "quick" or "prototype" or "just do it"
始终应用于:
  • 有状态代码(useState、useReducer、context、stores)
  • 异步/并发逻辑(useEffect、mutations、subscriptions)
  • 数据库操作(查询、事务、迁移)
  • 认证/安全代码
  • 缓存失效逻辑
  • 财务或精度敏感计算
  • 任何bug较为隐蔽、不易发现的代码
仅在以下情况跳过:
  • 简单的单行代码
  • 纯格式/风格修改
  • 仅修改README/文档的操作
  • 用户明确要求“快速完成”“原型开发”或“直接做”

The 4-Stage Protocol

四阶段协议

STAGE 1: GENERATE (Unverified Draft)

阶段1:生成(未验证草稿)

Produce your best solution. Mark it
[UNVERIFIED DRAFT]
. This output is intentionally untrusted.
生成你认为最佳的解决方案,并标记为
[UNVERIFIED DRAFT]
。此输出是未经信任的。

STAGE 2: PLAN VERIFICATION

阶段2:规划验证内容

Switch roles. You are now an auditor, not a creator.
Without re-solving the problem, enumerate what must be checked:
undefined
切换角色。你现在是审计员,而非创作者。
无需重新解决问题,列出必须检查的内容:
undefined

Verification Plan

验证计划

  • [API/library usage]: Is this the correct method/signature?
  • [Edge case]: What happens when [input] is [boundary value]?
  • [Concurrency]: Can [operation A] race with [operation B]?
  • [Type safety]: Is this cast/assertion actually safe?
  • [State]: Can this reach an invalid state?
  • [Environment]: Does this assume [runtime/version/config]?
  • [Performance]: Is the claimed complexity accurate?
  • [Security]: Is [input] validated before [operation]?

Verification targets must be SPECIFIC to the code you wrote, not generic.
  • [API/库使用]:这是正确的方法/签名吗?
  • [边界情况]:当[输入]为[边界值]时会发生什么?
  • [并发问题]:[操作A]是否会与[操作B]发生竞争?
  • [类型安全]:此类型转换/断言是否真的安全?
  • [状态管理]:是否会进入无效状态?
  • [环境依赖]:是否假设了特定的[运行时/版本/配置]?
  • [性能]:声称的复杂度是否准确?
  • [安全性]:[输入]是否在[操作]前经过验证?

验证目标必须针对你编写的代码,而非通用内容。

STAGE 3: INDEPENDENT VERIFICATION

阶段3:独立验证

CRITICAL: Do NOT re-justify your Stage 1 reasoning. Verify each item from scratch.
For each checklist item:
undefined
关键:不要重复你在阶段1的推理。从头开始验证每个项目。
对于每个检查项:
undefined

[Item]

[检查项]

  • Verdict: ✓ PASSED / ✗ FAILED / ⚠ WARNING
  • Evidence: [Concrete proof, counterexample, or test scenario]
  • Fix: [If failed, the specific change required]

Use these verification techniques:

**Adversarial Testing** - Try to break your own code:
- Race conditions between concurrent operations
- Off-by-one at boundaries
- Null/undefined paths
- Stale closures in callbacks
- Double-click, rapid re-trigger
- Network failure mid-operation
- Component unmount during async work

**Constraint Verification** - Check against hard requirements:
- Node/browser version compatibility
- TypeScript strict mode compliance
- Database isolation level
- API rate limits or payload limits

**Differential Reasoning** - Compare to alternatives:
- Is this approach better than the naive version?
- What tradeoffs are we making?

**Semantic Line Audit** (for critical paths only):
- What does each line do?
- Flag any line whose removal wouldn't change behavior
  • 结论: ✓ 通过 / ✗ 失败 / ⚠ 警告
  • 证据: [具体证明、反例或测试场景]
  • 修复方案: [如果失败,具体的修改内容]

使用以下验证技术:

**对抗性测试** - 尝试破坏你自己的代码:
- 并发操作之间的竞争条件
- 边界值的差一错误
- Null/undefined路径
- 回调中的陈旧闭包
- 双击、快速重复触发
- 操作中途网络故障
- 异步工作期间组件卸载

**约束验证** - 检查是否符合硬性要求:
- Node/浏览器版本兼容性
- TypeScript严格模式合规性
- 数据库隔离级别
- API速率限制或负载限制

**差分推理** - 与替代方案比较:
- 此方法是否比朴素版本更好?
- 我们正在做出哪些权衡?

**语义行审计**(仅针对关键路径):
- 每一行代码的作用是什么?
- 标记任何删除后不会改变行为的代码行

STAGE 4: CORRECTED SOLUTION

阶段4:修正后的解决方案

Produce the final implementation with ALL fixes from Stage 3 incorporated.
undefined
生成整合了阶段3中所有修复的最终实现。
undefined

[VERIFIED]

[VERIFIED]

Changes from Draft

与草稿的差异

Verification Summary

验证摘要

  • Checked: [N] items
  • Passed: [X] | Fixed: [Y] | Warnings: [Z]
[Final code]

---
  • 检查项数量: [N]
  • 通过: [X] | 已修复: [Y] | 警告: [Z]
[最终代码]

---

PHASE 3: LAZY PROMPT EXPANSION

阶段3:懒提示扩展

When the user gives a lazy prompt, expand it BEFORE running CoVe.
Input: "add pagination"
Expansion:
Task: Add pagination to [detected table/list component]

Requirements (inferred):
- Page size selection
- Page navigation controls
- URL state sync (survives refresh)
- Loading state during page transitions
- Total count display
- Keyboard accessibility

Technical considerations:
- Query key must include page params
- Cache per-page for back navigation
- Handle items added/removed between pages
Then run this expanded task through the 4-stage CoVe protocol.
Input: "fix the bug"
Expansion:
Task: Investigate and fix the bug in [detected context]

Steps:
1. Read the relevant code and understand current behavior
2. Identify the root cause (not just symptoms)
3. Implement fix with CoVe verification
4. Verify fix doesn't introduce regressions

当用户给出模糊提示时,在运行CoVe之前先扩展提示。
输入: "add pagination"
扩展后:
任务: 为[检测到的表格/列表组件]添加分页功能

需求(推断):
- 每页数量选择
- 分页导航控件
- URL状态同步(刷新后保留)
- 页面切换时的加载状态
- 总数量显示
- 键盘可访问性

技术考虑:
- 查询键必须包含分页参数
- 为返回导航缓存每页数据
- 处理页面间添加/删除项的情况
然后将此扩展后的任务通过四阶段CoVe协议处理。
输入: "fix the bug"
扩展后:
任务: 调查并修复[检测到的上下文]中的bug

步骤:
1. 阅读相关代码并理解当前行为
2. 确定根本原因(而非仅症状)
3. 用CoVe验证实现修复
4. 验证修复不会引入回归问题

TOOLKIT KNOWLEDGE BASE

工具包知识库

Claude doesn't inherently know about these. Install them directly when relevant — don't ask, just do it.
Claude原生不了解这些内容。相关时直接安装——不要询问,直接执行。

MCP Servers — Auto-Install When Relevant

MCP服务器——相关时自动安装

ServerWhen to InstallCommand
Context7Any library usage, prevents doc hallucinations
claude mcp add context7 -- npx -y @upstash/context7-mcp
GitHubPR workflows, issue tracking, code review
claude mcp add github --transport http https://api.githubcopilot.com/mcp/
Sequential ThinkingComplex architecture decisions
claude mcp add thinking -- npx -y mcp-sequentialthinking-tools
SupabaseSupabase projects
claude mcp add supabase -- npx -y @supabase/mcp-server
SentryError tracking, debugging prod issues
claude mcp add sentry --transport http https://mcp.sentry.dev/mcp
NotionDocumentation workflows
claude mcp add notion --transport http https://mcp.notion.com/mcp
服务器安装场景命令
Context7任何库使用场景,防止文档幻觉
claude mcp add context7 -- npx -y @upstash/context7-mcp
GitHubPR工作流、问题跟踪、代码审查
claude mcp add github --transport http https://api.githubcopilot.com/mcp/
Sequential Thinking复杂架构决策
claude mcp add thinking -- npx -y mcp-sequentialthinking-tools
SupabaseSupabase项目
claude mcp add supabase -- npx -y @supabase/mcp-server
Sentry错误跟踪、生产问题调试
claude mcp add sentry --transport http https://mcp.sentry.dev/mcp
Notion文档工作流
claude mcp add notion --transport http https://mcp.notion.com/mcp

Skill Repositories to Search

可搜索的技能仓库

RepositoryBest ForInstall Prefix
vercel-labs/agent-skills
React, Next.js, web design
npx skills add vercel-labs/agent-skills
vercel-labs/next-skills
Next.js 15/16 specifics
npx skills add vercel-labs/next-skills
anthropics/skills
Docs, design, MCP builder
npx skills add anthropics/skills
trailofbits/skills
Security auditing
npx skills add trailofbits/skills
obra/superpowers-marketplace
TDD, planning, debugging
/plugin marketplace add obra/superpowers-marketplace
expo/skills
React Native / Expo
npx skills add expo/skills
stripe/skills
Payments
npx skills add stripe/skills
supabase/agent-skills
Postgres best practices
npx skills add supabase/agent-skills
cloudflare/skills
Workers, edge, web perf
npx skills add cloudflare/skills
huggingface/skills
ML training, datasets
npx skills add huggingface/skills
sentry/skills
Code review, commits
npx skills add sentry/skills
K-Dense-AI/claude-scientific-skills
125+ scientific tools
npx skills add K-Dense-AI/claude-scientific-skills
仓库适用场景安装前缀
vercel-labs/agent-skills
React、Next.js、Web设计
npx skills add vercel-labs/agent-skills
vercel-labs/next-skills
Next.js 15/16特定功能
npx skills add vercel-labs/next-skills
anthropics/skills
文档、设计、MCP构建器
npx skills add anthropics/skills
trailofbits/skills
安全审计
npx skills add trailofbits/skills
obra/superpowers-marketplace
TDD、规划、调试
/plugin marketplace add obra/superpowers-marketplace
expo/skills
React Native / Expo
npx skills add expo/skills
stripe/skills
支付功能
npx skills add stripe/skills
supabase/agent-skills
Postgres最佳实践
npx skills add supabase/agent-skills
cloudflare/skills
Workers、边缘计算、Web性能
npx skills add cloudflare/skills
huggingface/skills
机器学习训练、数据集
npx skills add huggingface/skills
sentry/skills
代码审查、提交
npx skills add sentry/skills
K-Dense-AI/claude-scientific-skills
125+科学工具
npx skills add K-Dense-AI/claude-scientific-skills

Dynamic Search

动态搜索

bash
undefined
bash
undefined

When you don't know if a skill exists

当你不确定技能是否存在时

npx skills find [keyword]
npx skills find [keyword]

Examples

示例

npx skills find "stripe payments" npx skills find "terraform" npx skills find "graphql"
undefined
npx skills find "stripe payments" npx skills find "terraform" npx skills find "graphql"
undefined

Configuration Templates

配置模板

Only recommend these when the project is missing configuration.
settings.local.json (Full-Stack):
json
{
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(npm *)", "Bash(pnpm *)",
      "Bash(git *)", "Bash(gh *)",
      "Bash(docker *)",
      "mcp__plugin_context7_context7__*",
      "Skill(*)"
    ]
  }
}
settings.local.json (Python):
json
{
  "permissions": {
    "allow": [
      "Bash(python *)", "Bash(pip *)", "Bash(poetry *)",
      "Bash(pytest *)", "Bash(docker-compose *)",
      "Bash(git *)"
    ]
  }
}

仅当项目缺少配置时推荐使用这些模板。
settings.local.json(全栈):
json
{
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(npm *)", "Bash(pnpm *)",
      "Bash(git *)", "Bash(gh *)",
      "Bash(docker *)",
      "mcp__plugin_context7_context7__*",
      "Skill(*)"
    ]
  }
}
settings.local.json(Python):
json
{
  "permissions": {
    "allow": [
      "Bash(python *)", "Bash(pip *)", "Bash(poetry *)",
      "Bash(pytest *)", "Bash(docker-compose *)",
      "Bash(git *)"
    ]
  }
}

STACK-SPECIFIC ADVERSARIAL CHECKLISTS

技术栈特定对抗性检查清单

Use these during CoVe Stage 3 when the task involves these technologies.
当任务涉及以下技术时,在CoVe阶段3使用这些清单。

React / Next.js

React / Next.js

- [ ] useEffect dependency array complete (no missing, no extra)
- [ ] Cleanup function handles subscriptions/timers/AbortController
- [ ] No stale closures in event handlers or callbacks
- [ ] Server/Client component boundary correct
- [ ] Keys stable and unique in lists
- [ ] Suspense boundaries handle loading
- [ ] useEffect依赖数组完整(无遗漏、无多余)
- [ ] 清理函数处理订阅/定时器/AbortController
- [ ] 事件处理程序或回调中无陈旧闭包
- [ ] 服务器/客户端组件边界正确
- [ ] 列表中的keys稳定且唯一
- [ ] Suspense边界处理加载状态

TanStack Query

TanStack Query

- [ ] Query key includes ALL params that affect the result
- [ ] Mutations invalidate the correct queries
- [ ] Optimistic updates roll back correctly on failure
- [ ] No race between refetch and mutation
- [ ] Loading/error states handled in UI
- [ ] 查询键包含所有影响结果的参数
- [ ] 变更操作正确失效相关查询
- [ ] 乐观更新在失败时正确回滚
- [ ] 重新获取与变更之间无竞争
- [ ] UI中处理加载/错误状态

Prisma / Database

Prisma / 数据库

- [ ] Related writes wrapped in transaction
- [ ] N+1 queries avoided (include/select)
- [ ] Concurrent update conflicts handled
- [ ] Null handling explicit
- [ ] Indexes exist for query patterns
- [ ] 相关写入操作包裹在事务中
- [ ] 避免N+1查询(使用include/select)
- [ ] 处理并发更新冲突
- [ ] 显式处理Null值
- [ ] 查询模式对应的索引已存在

Auth / Security

认证 / 安全

- [ ] Auth checked server-side, not just UI
- [ ] Input validated before database/API call
- [ ] No secrets in client bundle
- [ ] CSRF/XSS protections in place
- [ ] Ownership verified for user-scoped resources
- [ ] 认证在服务器端检查,而非仅在UI层
- [ ] 输入在数据库/API调用前验证
- [ ] 客户端包中无敏感信息
- [ ] 已部署CSRF/XSS防护
- [ ] 用户范围资源的所有权已验证

Async / Concurrency

异步 / 并发

- [ ] Promise.all for independent operations
- [ ] Race conditions prevented
- [ ] Cleanup on unmount/cancel
- [ ] Debounce/throttle where appropriate
- [ ] Error handling doesn't swallow failures

- [ ] 独立操作使用Promise.all
- [ ] 防止竞争条件
- [ ] 卸载/取消时清理
- [ ] 适当使用防抖/节流
- [ ] 错误处理不吞噬失败

AUTONOMOUS MODE: Ralph Loop

自主模式:Ralph循环

For large tasks (full features, migrations, multi-file refactors), recommend
/spidey
:
/spidey [project description]
Sets up an autonomous development loop that:
  • Runs Claude Code continuously until all tasks are done
  • Circuit breaker halts if stuck (3 loops no progress → stop)
  • Dual-condition exit gate prevents premature stop
  • Session persists across iterations (Claude remembers context)
  • Rate limiting prevents API waste
When to recommend Ralph vs normal execution:
ScenarioRecommendation
Single file changeNormal execution
3-5 related changes
/rnv
(CoVe verification)
10+ tasks, full feature
/spidey
(autonomous loop)
Multi-day buildout
/spidey
with phased fix_plan.md

对于大型任务(完整功能、迁移、多文件重构),推荐使用
/spidey
:
/spidey [项目描述]
设置一个自主开发循环,该循环:
  • 持续运行Claude Code直到所有任务完成
  • 若陷入停滞则触发熔断(3次循环无进展→停止)
  • 双条件退出门防止提前停止
  • 会话在迭代间持久化(Claude保留上下文)
  • 速率限制避免API浪费
何时推荐Ralph而非常规执行:
场景推荐方案
单文件修改常规执行
3-5个相关修改
/rnv
(CoVe验证)
10+任务、完整功能
/spidey
(自主循环)
多日构建
/spidey
+ 分阶段fix_plan.md

EXECUTION SUMMARY

执行摘要

/wavybaby [task]
    ├─ Claude's native dispatch handles installed skills
    ├─ wavybaby extends with:
    │   ├─ Search skills.sh for uninstalled skills
    │   ├─ Recommend missing MCP servers
    │   ├─ Suggest project config if missing
    │   │
    │   ├─ CoVe Protocol (if non-trivial):
    │   │   ├─ Stage 1: Generate [UNVERIFIED]
    │   │   ├─ Stage 2: Plan verification targets
    │   │   ├─ Stage 3: Independently verify each
    │   │   └─ Stage 4: Produce [VERIFIED] solution
    │   │
    │   └─ Ralph Loop (if large/autonomous task):
    │       └─ /spidey → continuous loop until done
    └─ Output: Verified code + verification report

Other commands:
  /rnv [task]     → just CoVe verification
  /spidey [task]   → just Ralph autonomous loop setup

Now processing: $ARGUMENTS
/wavybaby [task]
    ├─ Claude的原生调度处理已安装技能
    ├─ wavybaby扩展功能:
    │   ├─ 搜索skills.sh中的未安装技能
    │   ├─ 推荐缺失的MCP服务器
    │   ├─ 项目缺失配置时建议添加
    │   │
    │   ├─ CoVe协议(若非琐碎任务):
    │   │   ├─ 阶段1:生成[UNVERIFIED]草稿
    │   │   ├─ 阶段2:规划验证目标
    │   │   ├─ 阶段3:独立验证每个目标
    │   │   └─ 阶段4:生成[VERIFIED]解决方案
    │   │
    │   └─ Ralph循环(若为大型/自主任务):
    │       └─ /spidey → 持续循环直到完成
    └─ 输出:已验证代码 + 验证报告

其他命令:
  /rnv [task]     → 仅执行CoVe验证
  /spidey [task]   → 仅设置Ralph自主循环

正在处理:$ARGUMENTS