name: 用户配置 description: 管理 Claude Code 用户配置（~/.claude/）。动作包括：审计、备份、清理代理、清理调试、清理钩子日志、清理会话、压缩审查、成本、文件版本、全局、历史、MCP、计划、提示提取、修剪、重置、重置插件、恢复、回顾、会话统计、状态、存储、转录搜索。 argument-hint: <动作> [选项] (审计|备份|清理代理|清理调试|清理钩子日志|清理会话|压缩审查|成本|文件版本|全局|历史|MCP|计划|提示提取|修剪|重置|重置插件|恢复|回顾|会话统计|状态|存储|转录搜索) allowed-tools: Bash, Read, Write, Glob, Grep, Skill, AskUserQuestion
用户配置管理
统一技能，用于管理 Claude Code 用户配置（~/.claude/ 和 ~/.claude.json）。将所有用户配置操作整合到单个入口点，基于动作路由。
相关技能： 调用 claude-ecosystem:user-config-management 技能以获取元级配置权限、已知结构清单和文档管理委托模式。
快速决策树
您想做什么？
| 意图 | 动作 | 只读？ |
|---|---|---|
| 快速检查配置健康状态 | status |
是 |
| 深度健康审计与漂移检测 | audit |
是（除非 --fix） |
| 查看存储分解与建议 | storage |
是 |
| 查看会话文件计数与趋势 | session-stats |
是 |
| 估算 API 成本和令牌使用 | costs |
是 |
| 清理旧会话文件 | cleanup-sessions |
破坏性 |
| 清理旧代理转录文件 | cleanup-agents |
破坏性 |
| 清理旧调试文件 | cleanup-debug |
破坏性 |
| 清理旧钩子日志文件 | cleanup-hook-logs |
破坏性 |
| 全面清理（所有类别） | prune |
破坏性 |
| 备份配置到 ~/.claude-backups/ | backup |
否（创建文件） |
| 从备份恢复配置 | restore |
否（覆盖文件） |
| 重置 Claude Code 保留 MCP 服务器 | reset |
破坏性 |
| 核级插件重置（缓存+注册表） | reset-plugins |
破坏性 |
| 查看/编辑 ~/.claude.json 全局配置 | global |
取决于模式 |
| 列出/管理 MCP 服务器配置 | mcp |
取决于模式 |
| 搜索/分析命令历史 | history |
是（除非 --clear） |
| 列出/查看/归档计划文件 | plans |
取决于模式 |
| 浏览跨会话的文件编辑历史 | file-versions |
是（除非 --restore） |
| 审查压缩信息丢失 | compaction-review |
是 |
| 从会话中提取成功提示 | prompt-extract |
是 |
| 跨会话转录搜索 | transcript-search |
是 |
| 生成会话回顾/事后分析 | retrospective |
是 |
参数路由表
| 动作 | 参数 | 默认行为 | 参考 |
|---|---|---|---|
audit |
[--fix] [--verbose] |
完整审计并摘要报告 | audit.md |
backup |
[--include-history] [--include-sessions] |
仅备份基本配置 | backup.md |
cleanup-agents |
[days] [--dry-run] [--all-projects] |
移除 >7 天的代理文件，当前项目 | cleanup-agents.md |
cleanup-debug |
[days] [--dry-run] |
移除 >7 天的调试文件 | cleanup-debug.md |
cleanup-hook-logs |
[days] [--dry-run] |
移除 >30 天的钩子日志 | cleanup-hook-logs.md |
cleanup-sessions |
[days] [--dry-run] [--all-projects] |
移除 >7 天的会话文件，当前项目 | cleanup-sessions.md |
compaction-review |
[session-id] [--current] [--compare] |
审查最近压缩 | compaction-review.md |
costs |
[--days N] [--project] [--breakdown] [--export FILE] |
最近成本摘要（30 天） | costs.md |
file-versions |
<file-path> [--list] [--diff VER] [--restore VER] |
显示当前工作目录版本摘要 | file-versions.md |
global |
[--view] [--edit SECTION] [--validate] |
查看配置摘要 | global.md |
history |
<search-term> [--days N] [--stats] [--export FILE] [--clear] |
显示最近历史摘要 | history.md |
mcp |
[--list] [--export FILE] [--import FILE] [--add NAME] [--remove NAME] |
显示 MCP 服务器摘要 | mcp.md |
plans |
[plan-name] [--list] [--archive] [--cleanup N] |
列出最近计划 | plans.md |
prompt-extract |
[--successful-only] [--category CAT] [--days N] [--export FILE] |
提取所有提示（30 天） | prompt-extract.md |
prune |
[days] [--dry-run] [--all-projects] [--include-debug] [--include-todos] [--nuclear] |
全面清理 >7 天，当前项目 | prune.md |
reset |
[--backup] [--restore] [--list-backups] |
交互式重置向导 | reset.md |
reset-plugins |
[--dry-run] [--include-marketplaces] [--force] |
清除除市场外的所有内容 | reset-plugins.md |
restore |
[backup-name] [--list] [--mcp-only] [--dry-run] |
从备份交互式选择 | restore.md |
retrospective |
[session-id] [--current] [--days N] |
分析最近会话 | retrospective.md |
session-stats |
[--all-projects] |
当前项目统计 | session-stats.md |
status |
（无） | 统一配置概览 | status.md |
storage |
[--verbose] |
存储分析与建议 | storage.md |
transcript-search |
<query> [--days N] [--project] [--regex] [--context N] |
搜索所有项目，所有时间 | transcript-search.md |
常见参数模式
这些模式在多个动作中共享：
| 模式 | 使用于 | 描述 |
|---|---|---|
[days] |
cleanup-agents, cleanup-debug, cleanup-sessions, prune | 移除超过 N 天的文件（非负整数） |
--dry-run |
cleanup-*, prune, reset-plugins, restore | 预览而不做更改 |
--all-projects |
cleanup-agents, cleanup-sessions, prune | 应用于所有项目（默认：仅当前） |
--days N |
costs, history, prompt-extract, transcript-search | 限制分析时间范围 |
--export FILE |
costs, history, mcp, prompt-extract | 将结果导出到文件 |
--project |
costs, transcript-search | 限制为当前项目 |
安全分类
只读动作（始终安全）
audit（不带 --fix）、compaction-review、costs、file-versions（不带 --restore）、prompt-extract、retrospective、session-stats、status、storage、transcript-search
破坏性动作（需要确认）
所有破坏性动作在删除前必须使用 AskUserQuestion。未经用户明确确认，切勿删除文件。
| 动作 | 删除内容 | 可逆？ |
|---|---|---|
cleanup-agents |
代理转录文件（agent-*.jsonl） | 否 |
cleanup-debug |
调试转录文件 | 否 |
cleanup-hook-logs |
钩子日志 .jsonl 文件 | 否 |
cleanup-sessions |
会话 .jsonl 文件 | 否 |
prune |
会话 + 代理 + statsig + 计划 + 可选调试/待办事项/锁 | 否 |
reset |
用户必须手动删除 ~/.claude/（技能仅准备备份） | 部分（备份） |
reset-plugins |
插件缓存、注册表、enabledPlugins 设置 | 部分（重新安装） |
history --clear |
命令历史条目 | 否 |
写入动作（创建/修改文件）
| 动作 | 写入内容 |
|---|---|
backup |
在 ~/.claude-backups/ 中创建备份 |
restore |
从备份覆盖配置文件 |
global --edit |
修改 ~/.claude.json |
mcp --add/--remove/--import |
修改 ~/.claude.json 中的 mcpServers |
plans --archive |
将计划文件移动到 archive/ 子目录 |
受保护文件（永不删除）
这些文件任何清理动作都永不触及：
| 文件 | 原因 |
|---|---|
~/.claude/CLAUDE.md |
用户指令 |
~/.claude/settings.json |
用户设置 |
~/.claude/settings.local.json |
本地设置 |
~/.claude/.credentials.json |
OAuth 令牌（永不备份） |
~/.claude/history.jsonl |
命令历史（使用 history --clear 明确清除） |
~/.claude/plugins/ |
已安装插件（使用 /plugin uninstall） |
~/.claude/file-history/ |
编辑撤销历史（丢失此文件会移除 /rewind 能力） |
~/.claude/commands/ |
用户命令 |
~/.claude/skills/ |
用户技能 |
~/.claude/agents/ |
用户代理 |
~/.claude/hooks/ |
用户钩子 |
跨平台路径处理
所有动作处理跨平台路径：
Python： 使用 pathlib.Path.home() / ".claude" — 永不硬编码操作系统特定路径。
Bash： 使用 $HOME/.claude — 在 macOS、Linux 和 Windows 上的 Git Bash 中工作。
项目路径编码： pwd | sed 's/[\\/:]/-/g' | sed 's/^-//'
执行
步骤 1：解析动作
从 $ARGUMENTS 中提取动作：
ACTION = 第一个非标志参数（审计、备份、清理代理等）
REMAINING_ARGS = 动作后的所有内容
如果未提供动作或动作无法识别，显示上面的快速决策树，并要求用户指定动作。
步骤 2：加载参考
从 references/{action}.md 加载动作的详细参考文件。参考包含完整的操作指令、工作流、代码示例和输出格式。
步骤 3：执行
遵循参考文件中的指令，将 REMAINING_ARGS 作为动作的参数传递。