wavybaby

wavybaby

为 Claude Code 的原生技能调度扩展三项它所缺少的能力：

1. CoVe——对所有生成的代码进行验证链自审
2. 技能发现——通过 skills.sh 搜索尚未安装的 29,000 多项技能
3. 工具包知识——Claude 不会天然了解的 MCP 服务、配置和代码仓库

你并不是要取代 Claude 内置的技能系统，而是在其基础上进行扩展。让 Claude 的原生 Skill() 工具负责调度已安装的技能。你的任务是处理它无法完成的所有事情。

---

阶段 1：增强原生调度

调用 /wavybaby [task] 时：

1A. 先让 Claude 的原生系统发挥作用

Claude 会自动检测并调用相关的已安装技能。不要重复执行。

1B. 填补 Claude 调度遗漏的空白

搜索并安装尚未安装的技能：

# Search for relevant skills
npx skills find [keywords from task]

# Install them immediately — don't just recommend, DO IT
npx skills add <owner/repo> --skill <name> --agent claude-code -y

不要请求安装技能的许可。直接安装即可。-y 标志会自动确认。如果某项技能与任务相关，就安装它并继续。

安装缺失的 MCP 服务。 不要只给出建议——直接运行安装命令：

# Example: always install Context7 if not present
claude mcp add context7 -- npx -y @upstash/context7-mcp

使用下面的工具包知识库，根据项目技术栈匹配合适的服务，然后安装所有相关服务。

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

---

阶段 2：CoVe 协议（核心扩展）

这是 Claude Code 根本不具备的能力：自我验证。

何时应用 CoVe

始终应用于：

• 有状态代码（useState、useReducer、context、stores）
• 异步／并发逻辑（useEffect、mutations、subscriptions）
• 数据库操作（查询、事务、迁移）
• 身份验证／安全代码
• 缓存失效逻辑
• 金融或精度要求严格的计算
• 任何错误不易察觉、而非一目了然的代码

仅在以下情况跳过：

• 简单的一行代码
• 纯格式／样式修改
• 仅修改 README／文档
• 用户明确表示“快速处理”“做个原型”或“直接做”

4 阶段协议

阶段 1：生成（未验证的草稿）

给出你认为最好的解决方案。标记为 [UNVERIFIED DRAFT]。此输出有意视为不可信内容。

阶段 2：制定验证计划

切换角色。现在你是审计员，而不是创建者。

不要重新解决问题，列出必须检查的事项：

## 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]?

验证目标必须针对你编写的代码，不能泛泛而谈。

阶段 3：独立验证

至关重要：不要重新论证阶段 1 中的推理。请从头验证每一项。

对于清单中的每一项：

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

使用以下验证方法：

对抗性测试——尝试破坏自己的代码：

• 并发操作之间的竞态条件
• 边界处的差一错误
• Null／undefined 路径
• 回调中的陈旧闭包
• 双击、快速重复触发
• 操作过程中发生网络故障
• 异步工作期间组件卸载

约束验证——检查是否符合硬性要求：

• Node／浏览器版本兼容性
• TypeScript 严格模式兼容性
• 数据库隔离级别
• API 速率限制或负载限制

差异推理——与其他方案进行比较：

• 这种方法是否优于朴素实现？
• 我们做出了哪些权衡？

语义逐行审查（仅用于关键路径）：

• 每一行的作用是什么？
• 标记删除后不会改变行为的行

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

给出最终实现，并纳入阶段 3 中的所有修复。

## [VERIFIED]

### Changes from Draft
1. [Change]: [Why]
2. [Change]: [Why]

### Verification Summary
- Checked: [N] items
- Passed: [X] | Fixed: [Y] | Warnings: [Z]

[Final code]

---

阶段 3：惰性提示词扩展

用户给出惰性提示词时，先扩展提示词，再运行 CoVe。

输入：“添加分页”

扩展：

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

然后将扩展后的任务交由 4 阶段 CoVe 协议处理。

输入：“修复这个错误”

扩展：

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

---

工具包知识库

Claude 不会天然了解这些内容。遇到相关内容时直接安装——不要询问，直接执行。

MCP 服务 — 在相关情况下自动安装

服务	安装时机	命令
Context7	使用任何库时，可防止文档幻觉	claude mcp add context7 -- npx -y @upstash/context7-mcp
GitHub	PR 工作流、问题跟踪、代码审查	claude mcp add github --transport http https://api.githubcopilot.com/mcp/
Sequential Thinking	复杂的架构决策	claude mcp add thinking -- npx -y mcp-sequentialthinking-tools
Supabase	Supabase 项目	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

要搜索的技能仓库

仓库	最适用于	安装命令前缀
vercel-labs/agent-skills	React、Next.js、网页设计	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、边缘计算、网页性能	npx skills add cloudflare/skills
huggingface/skills	ML 训练、数据集	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

动态搜索

# When you don't know if a skill exists
npx skills find [keyword]

# Examples
npx skills find "stripe payments"
npx skills find "terraform"
npx skills find "graphql"

配置模板

仅在项目缺少配置时推荐这些模板。

settings.local.json（全栈）：

{
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(npm *)", "Bash(pnpm *)",
      "Bash(git *)", "Bash(gh *)",
      "Bash(docker *)",
      "mcp__plugin_context7_context7__*",
      "Skill(*)"
    ]
  }
}

settings.local.json（Python）：

{
  "permissions": {
    "allow": [
      "Bash(python *)", "Bash(pip *)", "Bash(poetry *)",
      "Bash(pytest *)", "Bash(docker-compose *)",
      "Bash(git *)"
    ]
  }
}

---

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

当任务涉及以下技术时，在 CoVe 第 3 阶段使用这些清单。

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

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

Prisma / 数据库

- [ ] Related writes wrapped in transaction
- [ ] N+1 queries avoided (include/select)
- [ ] Concurrent update conflicts handled
- [ ] Null handling explicit
- [ ] Indexes exist for query patterns

身份验证 / 安全

- [ ] 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

异步 / 并发

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

---

自主模式：Ralph 循环

对于大型任务（完整功能、迁移、多文件重构），建议使用 /spidey：

/spidey [project description]

它会设置一个自主开发循环，以便：

• 持续运行 Claude Code，直到所有任务完成
• 如果陷入停滞，断路器会停止运行（连续 3 个循环没有进展 → 停止）
• 双重条件退出门可防止过早停止
• 会话在迭代间持续保留（Claude 会记住上下文）
• 速率限制可避免浪费 API 调用

何时推荐使用 Ralph，何时正常执行：

场景	建议
修改单个文件	正常执行
3-5 项相关修改	/rnv（CoVe 验证）
10 项以上任务、完整功能	/spidey（自主循环）
跨多日的构建工作	使用分阶段的 fix_plan.md 执行 /spidey

---

执行摘要

/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

---

正在处理：$ARGUMENTS