SuperAPI AI 工具集

reset-agent-env

部署与运维

查看项目

更新于 10-18 16:15

技能介绍

用途

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,缺失时会被跳过并警告。