已安装数量不符、技能目录缺失，Claude Code Skills

Quick fix

在 Skills 页面检查已安装条目的目录是否仍存在；移除失效记录或重新扫描目录后再同步。

Symptom

报错原文复制

Skills page shows **已安装 14**; `~/.agents/skills/` holds **10** directories.

Cause

Skills 面板的已安装计数依赖数据库中的启用标记，没有普遍核对 SSOT 目录是否仍存在。删除目录后，对应数据库行仍保留，因此技能会继续显示为已安装和启用。检查更新会跳过本地 Skill；对仓库技能，目录缺失也会被当作没有可报告的更新。立即重新同步从数据库投射到应用目录，失败时不会清除数据库行。

问题还包括 SSOT 目录与应用技能目录中的副本不同步，以及没有启动时的反向核对。该 issue 仍为 open，提出的是只读核对报告和供用户审核的修复选项；没有确认已实施或验证的修复步骤。

Fix

1. 1

   在 Skills 页面逐项确认数据库记录对应的 SSOT 目录是否存在；缺失的条目目前需要通过应用界面卸载，或等待/使用尚未确认实现的重新扫描能力。

2. 2

   不要仅凭“所有技能已是最新版本”判断本地技能目录完整；该检查会跳过本地 Skill，缺失的仓库技能目录也可能不被报告。

Affected Versions

ToolClaude Code / OpenCode

Version4.0.5（评论报告环境）

PlatformsWindows

Source Issues

本页汇总自 1 个真实 issue

• #7698Skills: installed counts and sync state drift from filesystem (ghost DB rows, shadowing app-dir copies)

FAQ

为什么检查更新显示所有技能已是最新版本，但目录已经被删除？

检查更新会跳过本地 Skill；仓库技能的 SSOT 目录不存在时也可能被视为没有更新，因此该提示不能发现这类缺失目录。

立即重新同步会自动删除缺失目录对应的记录吗？

不会。重新同步从数据库投射到应用目录，失败的技能会被报告，但数据库记录仍保留。

能否生成只读核对报告并让我确认后再清理？

issue 提议在 Skills 页面显示数据库、SSOT 和应用目录之间的漂移，并提供审核选项；该 issue 仍为 open，未确认此功能已实现。

相关问题

技能描述仍是旧内容 Claude Code手动修改 SKILL.md 后，Claude Code 会读取新内容，但 cc-switch 目前不会刷新技能列表中的安装时元数据快照。1 issues mergedSkill 更新会静默覆盖本地修改更新前先备份本地修改；当前拟议修复会将本地已改动的 Skill 排除在“全部更新”之外。1 issues mergedSkills 自动导入后仍保留副本，CC Switch自动导入会将 Skills 复制到 `~/.cc-switch/skills/`，不会删除 `~/.agents/skills/` 中的源目录。1 issues merged