关于 reset-agent-env
reset-agent-env 是用于盘点并清除多种 Agent 环境全局配置的 Claude 技能。默认先执行不改动文件的预览;确认后可备份移除,或直接删除。
主要功能
- 01按 Agent 分类预览待处理内容
- 02通过重复参数选择 Agent
- 03可备份移除或直接删除
- 04对 JSON 配置进行定点修改
适用场景
- 01清理前预览全局 Agent 配置
- 02为测试准备干净环境
- 03交接前清除选定 Agent 配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ c0nant/ skills --skill reset-agent-env安装后在 Claude Code 中输入/reset-agent-env确认已加载。
附带文件scripts/reset-agent-env.sh
详细介绍
重置 Agent 环境
清除此计算机上的 全局 Agent 配置:所有 Agent 框架中的技能、钩子、规则和 MCP 服务,以便测试从零开始的安装,或移交干净的环境。
此操作具有破坏性。脚本默认执行 试运行;在确认模式之前,不会删除任何内容。
流程
1. 清点(试运行)
不带任何标志运行捆绑脚本。脚本会按 Agent 分组,准确列出已有内容及将要删除的内容,且不会做任何更改:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh
向用户展示输出。
2. 确认范围和模式
向用户询问以下两项:
- 哪些 Agent? 全部(默认),或通过可重复使用的
--agent指定部分 Agent:claude·agents(~/.agents/skills标准目录)·cursor·windsurf·antigravity。 - 备份还是彻底删除?
--apply(推荐):将所有内容移至~/.cache/agent-env-reset/<timestamp>/,以便恢复。--hard:直接删除,不备份。
3. 执行
使用所选标志和 --yes 运行(用户已确认):
# everything, reversible:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh --apply --yes
# scoped + hard delete:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh --hard --agent claude --agent cursor --yes
4. 报告
告知用户删除了哪些内容。对于 --apply,提供备份路径和恢复提示(将文件移出备份目录)。
此技能位于 ~/.claude/skills 下,因此完整重置 Claude Code 会删除该技能本身:再次使用前,请通过 npx skills@latest add C0nanT/skills 重新安装。
操作范围
| Agent | 目标 |
|---|---|
| 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 standard | ~/.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,这些操作会跳过并显示警告(基于文件的移除仍会执行)。 -
重置后,重新安装以验证干净的设置:
npx skills@latest add C0nanT/skills npx @c0nant/claude-hooks install
评论
支持 Markdown