buddy-reroll

Buddy Reroll

Language

Match user's language: Respond in the same language the user uses.

Overview

Claude Code 的 /buddy 宠物由 ~/.claude.json 中 oauthAccount.accountUuid 经确定性哈希生成。本 skill 通过暴力搜索 UUID 来找到产出目标宠物的 accountUuid，然后替换配置文件实现 reroll。

关键限制：必须用 bun 运行脚本（Bun.hash 与 Claude Code 内部一致），node 的 FNV-1a 结果不匹配。

Workflow

• Step 1: Preflight — 检查 bun 是否可用、~/.claude.json 是否存在且含 accountUuid
• Step 2: 查看当前 buddy — bun scripts/buddy-reroll.js --check <当前accountUuid>
• Step 3: 收集需求 — → AskUserQuestion：想要什么 species / rarity / hat / shiny / 属性要求
• Step 4: 搜索 — bun scripts/buddy-reroll.js --species <x> --rarity <x> ...
• Step 5: 展示候选 — 表格展示 roll 结果 → AskUserQuestion：让用户选择目标候选
• Step 6: 替换 — 备份原 UUID，用 Edit 工具替换 ~/.claude.json 中的 accountUuid
• Step 7: 完成报告 — 提示用户重启 Claude Code 并运行 /buddy

Runtime

Preflight

bun scripts/buddy-reroll.js --check test 2>/dev/null && echo '{"ready":true}' || echo '{"ready":false,"hint":"需要安装 bun"}'

检查项	失败时修复
which bun 无输出	macOS: brew install oven-sh/bun/bun；Linux: curl -fsSL https://bun.sh/install | bash
~/.claude.json 不存在	请先安装并登录 Claude Code（claude 命令启动后完成 OAuth 登录即可生成）
~/.claude.json 中无 oauthAccount.accountUuid	未通过 OAuth 登录，执行 /login 或重新启动 Claude Code 登录

Credentials

无需额外凭据。直接读取 ~/.claude.json。

Degradation

依赖	必需	不可用时行为
bun	是	停止，提示安装
~/.claude.json	是	停止，提示检查 Claude Code 安装
oauthAccount	否	fallback 到 userID 字段

Script Commands

命令	用途	示例
--check <uid>	查看指定 ID 产出的 buddy	bun scripts/buddy-reroll.js --check <uuid>
--species/--rarity/...	按条件搜索	bun scripts/buddy-reroll.js --species dragon --rarity legendary --shiny --count 3

所有参数见脚本 --help。输出为 JSON（含 hint 摘要字段）。非 bun 运行时 exit 2 并输出结构化错误。

替换规则

accountUuid 必须是 UUID 格式（xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx）。脚本已生成 UUID v4 格式的 uid。

替换步骤：

1. 用 Grep 找到 accountUuid 所在行
2. 用 Read 读取上下文
3. 用 Edit 替换值
4. 绝对不要替换为非 UUID 格式的字符串，否则会导致 Claude Code 崩溃

如果 oauthAccount 不存在（未登录用户），改为替换 userID 字段。

Buddy 属性参考

• Species: duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk
• Rarity: common(60%) / uncommon(25%) / rare(10%) / epic(4%) / legendary(1%)
• Eyes: · ✦ × ◉ @ °
• Hats: none, crown, tophat, propeller, halo, wizard, beanie, tinyduck（common 固定 none）
• Shiny: 1% 概率
• Stats: DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK（底值随稀有度提升）

Completion Report

[Buddy Reroll] 完成！

原始 UUID: <backup>
新 UUID:   <new>
新 Buddy:  <species> | <rarity> ★ | <hat> | shiny=<bool>
属性:      DEBUG:<n> PAT:<n> CHAOS:<n> WIS:<n> SNARK:<n>

→ 重启 Claude Code 后输入 /buddy 查看新宠物
→ 如需回滚，将 accountUuid 改回原始值即可

Troubleshooting

问题	解决
替换后 Claude Code 崩溃	accountUuid 格式不对，必须是 UUID v4 格式
roll 结果与实际不符	必须用 bun 运行脚本，node 的哈希不匹配
搜索 legendary+shiny 很慢	正常，概率 0.01%，增加 --max 或放宽条件
改了没效果	确认改的是 oauthAccount.accountUuid 而非 userID