名称: 用户配置管理 描述: 中央权威用于管理Claude Code用户配置目录（~/.claude/ 和 ~/.claude.json）。涵盖存储清理、备份/恢复、重置工作流、MCP服务器保留、历史管理、计划管理、会话统计和配置健康审计。委托给docs-management技能获取官方文档。在管理用户配置、清理存储、备份设置、重置Claude Code或审计配置健康时使用。 允许工具: Read, Glob, Grep, Skill, Bash
用户配置管理
强制要求：首先调用docs-management
停止 - 在提供任何关于Claude Code用户配置的响应之前：
- 调用
docs-management技能获取官方文档- 查询 用户的具体主题
- 基于 官方文档 + 此技能的自定义参考
跳过此步骤将导致信息过时或不正确。
验证检查点
在响应之前，验证：
- [ ] 我是否调用了docs-management技能获取官方文档？
- [ ] 我是否检查了此技能的自定义工作流参考？
- [ ] 我的响应是否基于官方文档（设置、MCP）+ 技能参考（重置、备份）？
如果有任何复选框未勾选，停止并完成缺失步骤。
概述
中央权威用于管理Claude Code的用户配置目录。此技能提供：
- 关键词注册表 用于高效docs-management查询
- 自定义工作流 官方文档未覆盖（重置、备份/恢复、漂移检测）
- 命令清单 链接到现有清理命令
- 跨平台指导 用于路径处理
架构： 混合委托 - 官方文档通过docs-management，自定义工作流通过技能参考。
何时使用此技能
关键词： 用户配置、~/.claude、.claude.json、清理、存储、备份、恢复、重置、MCP服务器、历史、计划、会话、调试日志、修剪、审计、漂移检测
使用此技能当：
- 管理 ~/.claude/ 目录内容
- 清理存储（会话、代理、调试、缓存）
- 备份或恢复配置
- 重置Claude Code同时保留MCP服务器
- 搜索命令历史
- 管理计划文件
- 查看会话统计
- 审计配置健康
- 检测更新后结构漂移
关键词注册表用于docs-management查询
查询docs-management技能时使用这些关键词：
配置文件
| 主题 | 关键词 |
|---|---|
| 设置概述 | “设置”、“settings.json”、“配置文件” |
| 用户设置 | “用户设置”、“~/.claude/settings.json” |
| 全局配置 | “.claude.json”、“全局配置”、“mcpServers” |
| MCP服务器 | “MCP服务器”、“mcpServers”、“用户级MCP” |
保留与清理
| 主题 | 关键词 |
|---|---|
| 保留设置 | “cleanupPeriodDays”、“会话保留”、“自动清理” |
| 会话清理 | “会话”、“项目会话”、“会话文件” |
| 调试日志 | “调试”、“调试转录”、“调试中” |
存储位置
| 主题 | 关键词 |
|---|---|
| 存储结构 | “~/.claude”、“存储目录”、“claude文件夹” |
| 项目目录 | “项目”、“项目会话”、“会话存储” |
| 插件目录 | “插件”、“插件缓存”、“已安装插件” |
快速决策树
你想做什么？
所有操作通过整合的 /user-config <动作> 技能调用：
- 检查存储使用 -> 运行
/user-config storage - 清理会话 -> 运行
/user-config cleanup-sessions - 清理代理 -> 运行
/user-config cleanup-agents - 清理调试日志 -> 运行
/user-config cleanup-debug - 全面清理 -> 运行
/user-config prune - 核清理（一切） -> 运行
/user-config prune --nuclear - 备份配置 -> 运行
/user-config backup - 从备份恢复 -> 运行
/user-config restore - 重置（保留MCP） -> 运行
/user-config reset- 参见 reset-workflow.md - 搜索历史 -> 运行
/user-config history - 管理计划 -> 运行
/user-config plans - 审计配置健康 -> 运行
/user-config audit - 查看会话统计 -> 运行
/user-config session-stats - 查看MCP服务器 -> 运行
/user-config mcp - 重置插件（核） -> 运行
/user-config reset-plugins
目录结构参考
~/.claude/ 目录（13个概念）
| 目录/文件 | 目的 | 清理安全 | 操作 |
|---|---|---|---|
projects/ |
每个项目的会话文件 | 是（旧文件） | /user-config cleanup-sessions |
debug/ |
调试转录 | 是（旧文件） | /user-config cleanup-debug |
plugins/ |
已安装插件缓存 | 否（使用 /plugin） | /plugin uninstall |
file-history/ |
编辑撤销历史 | 否（丢失撤销） | 从不自动清理 |
plans/ |
保存的执行计划 | 是（旧文件） | /user-config plans |
shell-snapshots/ |
Shell状态捕获 | 是 | /user-config prune |
todos/ |
待办列表状态 | 是（旧文件） | /user-config prune |
statsig/ |
功能标志缓存 | 总是安全 | /user-config prune |
ide/ |
IDE锁文件 | 是（陈旧） | /user-config audit |
session-env/ |
会话环境 | 是 | /user-config prune |
settings.json |
用户设置 | 从不 | 仅手动 |
history.jsonl |
命令历史 | 通常保留 | /user-config history |
.credentials.json |
OAuth令牌 | 从不备份 | 仅手动 |
~/ 根文件（3个概念）
| 文件 | 目的 | 备份优先级 |
|---|---|---|
.claude.json |
全局配置（mcpServers、OAuth、标志） | 关键（mcpServers） |
CLAUDE.md |
用户级指令 | 高 |
.claudeignore |
用户级忽略模式 | 中 |
重要： 没有 ~/.mcp.json 文件。用户范围MCP服务器放在 ~/.claude.json 下的 mcpServers 字段。
操作清单
所有操作整合在 /user-config <动作> 技能下：
清理操作
| 操作 | 目的 |
|---|---|
/user-config cleanup-agents |
代理转录清理（默认7天） |
/user-config cleanup-debug |
调试日志清理（默认7天） |
/user-config cleanup-sessions |
会话文件清理（默认7天） |
/user-config cleanup-hook-logs |
钩子日志清理（默认30天） |
/user-config prune |
全面清理（–nuclear） |
分析操作
| 操作 | 目的 |
|---|---|
/user-config status |
所有配置的统一概述 |
/user-config storage |
存储分析 |
/user-config session-stats |
会话统计 |
/user-config costs |
API成本估计 |
/user-config audit |
结构漂移检测 |
备份/恢复操作
| 操作 | 目的 |
|---|---|
/user-config backup |
完整备份到 ~/.claude-backups/ |
/user-config restore |
从备份恢复 |
/user-config reset |
备份MCP -> 擦除 -> 恢复工作流 |
/user-config reset-plugins |
完整插件重置（缓存 + 注册表 + 设置） |
配置操作
| 操作 | 目的 |
|---|---|
/user-config global |
安全查看/编辑 ~/.claude.json |
/user-config mcp |
列出/导出MCP服务器配置 |
/user-config history |
搜索/导出命令历史 |
/user-config plans |
列出/查看/归档计划文件 |
会话分析操作
| 操作 | 目的 |
|---|---|
/user-config file-versions |
浏览文件编辑历史 |
/user-config compaction-review |
审查压缩信息丢失 |
/user-config prompt-extract |
提取成功提示 |
/user-config transcript-search |
跨会话转录搜索 |
/user-config retrospective |
会话事后分析/回顾 |
自定义工作流（技能所有）
这些工作流不在官方文档中 - 它们是自定义功能：
重置工作流（MCP保留）
对于想要全新开始但需要保留MCP服务器配置的用户。
完整指南： references/reset-workflow.md
快速总结：
- 备份：从 ~/.claude.json 提取 mcpServers
- 备份：复制 settings.json（可选）
- 用户擦除 ~/.claude/ 和 ~/.claude.json
- 用户重新启动Claude Code（创建新配置）
- 恢复：将 mcpServers 注入新 ~/.claude.json
备份/恢复工作流
用于完整配置备份和恢复。
完整指南： references/backup-restore.md
备份位置： ~/.claude-backups/backup-YYYY-MM-DD-HHmmss/
漂移检测
检测Claude Code更新时配置结构变化。
完整指南： references/known-structure.yaml
机制： 比较实际 ~/.claude/ 与已知结构清单。
委托模式
标准查询模式
用户问："如何清理旧会话？"
1. 检查操作清单（此技能）
2. 指向：/user-config cleanup-sessions
3. 如果用户需要更多细节，查询docs-management："cleanupPeriodDays"、"会话保留"
重置/备份模式
用户问："我想重置Claude Code但保留我的MCP服务器"
1. 加载此技能的references/reset-workflow.md
2. 查询docs-management："mcpServers"、".claude.json"
3. 指导用户通过重置工作流
故障排除模式
用户报告："存储使用太多磁盘空间"
1. 运行 /user-config storage 进行分析
2. 根据结果推荐特定清理操作
3. 如果需要，查询docs-management获取保留设置
跨平台路径处理
所有命令必须跨平台处理路径：
Python：
from pathlib import Path
claude_dir = Path.home() / ".claude"
claude_json = Path.home() / ".claude.json"
backup_dir = Path.home() / ".claude-backups"
Bash：
CLAUDE_DIR="$HOME/.claude"
CLAUDE_JSON="$HOME/.claude.json"
BACKUP_DIR="$HOME/.claude-backups"
从不硬编码：
C:\Users\USERNAME\.claude\/Users/USERNAME/.claude//home/USERNAME/.claude/
保留设置
官方设置（通过docs-management）
cleanupPeriodDays 在 settings.json 中：
- 会话不活跃 > N 天在启动时删除
- 默认：30 天
- 设置为 0 = 立即删除
查询docs-management：“cleanupPeriodDays”、“会话保留”
命令默认
注意： 对于官方保留设置（如
cleanupPeriodDays），查询docs-management: "cleanupPeriodDays session retention"。以下默认 是此插件的命令默认，不是Claude Code的官方默认。
| 命令 | 默认保留 |
|---|---|
| 清理命令 | 7 天 |
| 钩子日志 | 30 天 |
| 文件历史 | 从不自动清理（危险） |
故障排除快速参考
| 问题 | 解决方案 |
|---|---|
| 存储太大 | 运行 /user-config storage 然后清理操作 |
| 重置后丢失MCP服务器 | 使用 /user-config reset 工作流（先备份） |
| ~/.claude 中未知文件 | 运行 /user-config audit 进行漂移检测 |
| 找不到旧会话 | 使用 /user-config history 搜索 |
| 需要恢复配置 | 使用 /user-config restore 从备份 |
| “另一个Claude进程运行” | /user-config prune --nuclear 清除陈旧锁 |
审计配置
此技能提供由 user-config-auditor 代理使用的验证标准。
审计检查
| 类别 | 检查 |
|---|---|
| JSON有效性 | 所有 .json 文件解析正确 |
| 孤立文件 | 无项目的会话、陈旧锁 |
| 安全 | 设置中无暴露API密钥 |
| 结构 | 已知与未知目录/文件 |
| 交叉引用 | 待办引用有效会话 |
相关代理
user-config-auditor 代理执行正式审计：
- 使用此技能的known-structure.yaml进行漂移检测
- 验证JSON语法
- 检查孤立/陈旧文件
- 生成结构化审计报告
参考
自定义参考（技能所有）：
- known-structure.yaml - 漂移检测结构清单
- reset-workflow.md - MCP保留重置指南
- backup-restore.md - 备份/恢复程序
- command-inventory.md - 完整命令参考
官方文档（通过docs-management）：
- 查询：“设置”、“settings.json” - 设置结构
- 查询：“mcpServers”、“.claude.json” - MCP服务器配置
- 查询：“cleanupPeriodDays” - 保留设置
版本历史
- v1.0.0 (2025-12-30)：初始发布
- 整合命令命名空间（user-config:*）
- 带MCP保留的重置工作流
- 漂移检测清单
- 纯委托官方文档
- 插件特定功能的自定义参考
最后更新
日期： 2025-12-30 模型： claude-opus-4-5-20251101