skill-status

用途

skill-status 用于展示当前已加载的技能清单（skill inventory）。它把技能按来源划分为 bkit 核心（bkit 默认提供）与项目本地（project-local）两层，并给出冲突与覆盖情况，帮助使用者了解当前环境中实际生效的技能集合。

根据描述，其主要关注点是：bkit 核心与项目本地的技能对比、冲突（conflicts）以及覆盖缺口（coverage gaps）。触发方式包括 skill-status 与 skill list。

主要能力

1. 扫描核心技能：读取 bkit 核心技能目录 ~/.claude/plugins/cache/bkit-marketplace/bkit/*/skills/，对每个技能目录读取 SKILL.md 的 frontmatter，获取 name、classification、description（首行），并统计核心技能总数。
2. 扫描项目本地技能：读取项目技能目录 .claude/skills/project/*/SKILL.md，读取 frontmatter，并统计项目技能总数。
3. 检测冲突：对比核心与项目中的技能名称。若同名同时存在于两层，标记为 “override”（项目层胜出）；若项目技能的触发词与核心技能重叠，标记为 “shadow”。
4. 输出报告：以“Skill Status Report”形式展示，包含层级名称与版本（示例为 bkit Core v1.6.2）、技能数量，以及每个技能的名称、类型（Type）和分类（Classification）。

使用方式

通过命令 /skill-status 执行。

可用选项：

• /skill-status --detail：显示每个技能的完整描述与触发关键词。
• /skill-status --conflicts：仅显示存在命名冲突或触发重叠的技能。

报告内容示例

报告按层分节展示：

• Layer: bkit Core，示例显示 28 loaded，并列出如 pdca（workflow / PDCA lifecycle）、enterprise（workflow / Enterprise init）、bkit-rules（capability / Auto-apply rules）、code-review（workflow / Code analysis）等条目。
• Layer: Project-Local，示例显示 8 loaded，并列出如 btw（workflow / BTW suggestions）、skill-create（workflow / Skill generator）、skill-status（workflow / This report）、hunikflow-model（capability / @Flow patterns）、hunikflow-proxy（capability / DataProxy patterns）、hunikflow-domain（capability / ERP domain logic）、hunikflow-i18n（capability / i18n CSV guide）、hunikflow-dynamic-api（capability / Dynamic API guide）等条目。
• Conflicts 行：示例为 0 overrides, 0 shadows。
• Summary 行：示例为 36 total skills (28 core + 8 project)。

技能层级优先级

优先级由高到低为：

1. .claude/skills/project/（项目本地，受 git 跟踪）
2. ~/.claude/plugins/.../skills/（bkit 核心，由插件管理）
3. ~/.claude/skills/（用户全局，若存在）

当项目技能与核心技能同名时，项目技能优先，这被称为“2-layer override”模式。

适用场景

• 需要确认当前 Claude Code 环境中究竟加载了哪些技能时。
• 需要区分某个技能来自 bkit 核心还是项目本地时。
• 需要排查命名冲突或触发词重叠时。
• 需要查看特定技能的完整描述与触发关键词时。

限制

资料未说明该技能对技能目录缺失、SKILL.md frontmatter 格式异常等情况的处理方式；未提供安装命令、收费或价格信息。报告示例中的具体技能数量与版本随实际环境变化，不代表固定值。