用途
reset-agent-env 用于清空本机上的全局智能体配置,包括 skills、hooks、rules 和 MCP 服务器,覆盖多个智能体运行环境。典型用途是测试一次从零开始的安装,或将一台机器上的环境清理干净后交接给他人。
该操作具有破坏性。脚本默认执行 dry run(试运行),在用户确认模式之前不会删除任何内容。
主要能力
脚本会按智能体分组,列出实际存在且将被移除的内容。可处理的目标包括:
- Claude Code:~/.claude/skills、~/.claude/hooks-lib、~/.claude/hooks、~/.claude/commands、~/.claude/CLAUDE.md;并会精细地从 settings.json / settings.local.json 中剥离 .hooks,从 ~/.claude.json 中剥离 .mcpServers。
- Agent-Skills 标准:~/.agents/skills。
- Cursor:~/.cursor/rules、~/.cursor/mcp.json。
- Windsurf:~/.codeium/windsurf/memories/global_rules.md、~/.codeium/windsurf/mcp_config.json。
- Antigravity:~/.antigravity、~/.config/antigravity(尽力而为)。
对 Claude Code 和 ~/.agents/skills 目录的覆盖是完整的;对 Cursor / Windsurf / Antigravity 为尽力而为,只会触碰已经存在的路径。
JSON 编辑是精细的:settings.json 会保留你的模型、主题和其他偏好,只移除 .hooks 键。JSON 相关步骤需要 jq;若没有 jq,这些步骤会被跳过并给出警告(基于文件的删除仍会执行)。
使用方式
1. 清点(dry run)
不带任何参数运行捆绑脚本。它会按智能体分组,精确列出存在且将被移除的内容,不做任何更改:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh
将输出展示给用户。
2. 确认范围与模式
向用户询问两件事:
- 哪些智能体?默认全部,或通过可重复的 --agent 指定子集:claude · agents(即 ~/.agents/skills 标准目录)· cursor · windsurf · antigravity。
- 备份还是硬删除?
- --apply(推荐):将所有内容移动到 ~/.cache/agent-env-reset/<timestamp>/,因此可逆。
- --hard:直接删除,不备份。
3. 执行
使用所选参数加上 --yes(用户已确认)运行:
# 全部,可逆:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh --apply --yes
# 限定范围 + 硬删除:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh --hard --agent claude --agent cursor --yes
4. 报告
告知用户移除了什么。对于 --apply,给出备份路径和恢复提示(将文件从备份目录移回原处)。
适用场景
- 需要验证一次干净的从零安装。
- 需要将一台机器上的智能体环境清理后交接。
- 需要按智能体范围选择性重置,例如只重置 Claude Code 和 Cursor。
限制与注意事项
- 该技能位于 ~/.claude/skills 下,因此对 Claude Code 的完整重置会移除该技能本身;再次使用前需通过以下命令重新安装:
npx skills@latest add C0nanT/skills
- 重置后,可重新安装以验证干净的环境:
npx skills@latest add C0nanT/skills
npx @c0nant/claude-hooks install
- 对 Cursor / Windsurf / Antigravity 的覆盖为尽力而为,仅处理已存在的路径。
- JSON 步骤依赖 jq,缺失时会被跳过并警告。