cc-inspect 生态检查器
一条 /inspect 命令,把已安装的 Claude Code 技能、插件、MCP 服务器、命令与钩子全部呈现在浏览器仪表板中,附带记忆目录的清理建议。
脚本以只读扫描为主,输出自包含 HTML 到 /tmp,归档操作为可逆 mv 到 ~/.claude-archive,用户需手动复制执行删除/归档命令,数据流披露较清楚(内存文件仅做 MD5,不读入面板)。扣分点:dedupe 生成 rm 命令(虽需用户手动执行),未显式请求确认即扫描全部 ~/.claude/ 内容并可能在面板中展示 MCP/hook 命令行(可能含敏感 token),归档建议的误判风险(orphan 判定基于 l 抽样)未充分提示,发布者身份未验证。
脚本结构完整、set -euo pipefail、python 内嵌解析,主路径(扫描、生成 HTML、打开)在静态阅读下自洽。扣分点:大量 2>/dev/null || true 吞掉错误,失败时用户只看到静默缺失;python -c 通过字符串插值拼路径,含单引号/特殊字符的路径会崩溃;硬编码 macOS open;无任何测试或错误反馈机制。
目标场景明确(Claude Code 用户审计本地生态),README 中英/繁中双语,扫描范围表清晰,安装与使用说明完整。扣分点:仅支持 macOS(Linux 需手改 xdg-open),触发描述较宽('Show installed...'),未声明不适用边界(如 Windows/远程环境)。
MIT 许可、双语 README、扫描范围/记忆卫生分组文档化、截图说明,结构分层良好。扣分点:无版本号或 changelog,无维护责任与更新路径声明;SKILL.md 中的脚本路径为 ~/.claude/skills/cc-inspector 与仓库名 cc-inspect 不一致属隐性假设;无 FAQ 或已知限制清单。
价值主张具体(三层 scope 面板 + 记忆卫生清理建议,可逆归档),边际价值高于手动翻目录,零依赖轻量。扣分点:静态审查无法验证输出可直接使用,截图与功能描述未经独立复现,dedupe 保留最新副本的假设可能不总符合用户意图。
README 提供截图与详细机制说明,脚本源码可审计,中文文档与英文一致可交叉核对。扣分点:无测试套件、无 CI 证据、无第三方执行佐证,所有运行时行为均为作者声称,静态审查无法复现。
- 该 skill 仅支持 macOS;Linux 用户需手动将 open 改为 xdg-open,Windows 完全不适用。
- 面板会显示 MCP 服务器与 hooks 的命令行内容,可能暴露 API key 或 token 等敏感配置,请留意共享截图时的信息泄露。
- orphan 判定基于 session l 抽样前 100 行,可能误报;执行复制出的 rm 去重命令前请自行核对路径。
- 脚本静默吞掉错误(2>/dev/null),若面板内容缺失不会给出失败原因,需手动运行脚本排查。
- 无版本号与 changelog,更新需自行跟踪仓库;发布者未经 FollowSkills 注册表验证。
这个 Skill 能做什么,适合哪些场景?
cc-inspect 是一个 Claude Code 技能,运行一个 Bash 脚本扫描用户层与项目层的 `.claude/` 目录,收集技能、插件、MCP 服务器、命令、钩子和记忆目录信息,生成一个自包含的 HTML 文件并自动在浏览器中打开。它的特色是按作用域(User / Project / Local)分层展示,并针对自动记忆目录提供分组式的清理建议——过期、孤儿、重复内容都给出可复制的归档命令,且只归档不删除。整体零依赖,仅用 Bash 和 Python 3 完成。
运行 inspect.sh 脚本:扫描 ~/.claude/ 与当前项目的 .claude/ 目录,读取 settings. 中的 mcpServers 与 hooks 配置,遍历 skills、plugins/marketplaces、commands 等路径;解析会话 .l 文件中的 cwd 字段来解码记忆目录归属;对记忆文件做 MD5 哈希以发现重复;最后在 /tmp/cc-inspector.html 生成自包含 HTML 并用 open 命令在默认浏览器打开。文件内容本身不会被读入仪表板,只报告路径、大小与时间戳。
- 重度 Claude Code 用户想清点自己装了哪些技能、插件和 MCP 服务器时,用它一键生成可视化清单
- 使用数月后发现 `~/.claude/projects/` 下积累了几十个记忆目录(含已删除项目残留),需要安全的清理建议
- 怀疑某些钩子或 MCP 配置残留在项目层或 local 层,需要按作用域排查配置来源
- 换机或重装前,想快速导出当前 Claude Code 环境的完整快照
- 团队协作者想确认某个项目仓库里定义了哪些命令与钩子
这个 Skill 有哪些优点和局限?
- 零依赖:纯 Bash + Python 3,输出为单个自包含 HTML 文件
- 作用域感知,可区分 User / Project / Local 三层配置并动态筛选
- 记忆清理建议全部走可逆的归档命令(移入 ~/.claude-archive/),不直接删除任何内容
- 用会话 .l 的 cwd 字段解码目录归属,含破折号或特殊字符的项目路径也能正确解析
- 隐私保守:文件内容只做哈希比对,不读入仪表板
- 脚本用 `open` 打开浏览器,macOS 开箱即用,Linux 需手动改成 `xdg-open`;Windows 未见支持说明
- 记忆清理建议中的孤儿/过期判定依赖 .l 会话存在与 30 天阈值,无法覆盖所有边缘情况
- 仓库未附测试套件,README 未提供版本历史或维护承诺说明
- 仅做只读巡检与归档建议,不执行实际清理,需用户自行复制运行命令
如何安装这个 Skill?
git clone https://github.com/howardpen9/cc-inspect.git && cd cc-inspect && mkdir -p ~/.claude/skills/cc-inspector && cp inspect.sh SKILL.md ~/.claude/skills/cc-inspector/ && chmod +x ~/.claude/skills/cc-inspector/inspect.sh。前置条件:macOS(脚本使用 open,Linux 需自行改为 xdg-open)、Python 3、Claude Code CLI。
如何使用这个 Skill?
在任意 Claude Code 对话中输入 /inspect,脚本执行后会自动在浏览器打开仪表板,助手回复「Dashboard opened in browser.」。注意:按 SKILL.md 指示,不要让模型自己去扫目录,一切由脚本完成。