skill-map: 技能地图

扫描 ~/.claude/skills/ 下已安装的技能目录，生成一目了然的 ASCII 地图。

只面向安装后的技能目录：

扫描目标：~/.claude/skills/*/SKILL.md
不扫描仓库源码目录（如 content/skills/）
不把 registry 目录（如 content/community-skills-registry/）当作 installable skill

执行

1. 扫描

运行 scripts/scan.sh，获取每个技能的 JSON 数据：

name
version
invocable
desc
category

其中：

category 优先来自 frontmatter；若缺失则输出稳定的 ASCII 分组键（如 cognitive-analysis、workflow-integration、uncategorized）
渲染时再把这些键映射到中文分组标题
desc 兼容单行与多行 frontmatter description
缺失 version 时输出 -
缺失 user_invocable 时输出 false

2. 分类

分类优先级固定如下：

frontmatter category
基于 name + desc 的规则驱动关键词推断
未分类

分组顺序固定如下：

◆ 认知与分析
▲ 文档与表达
■ 开发与实现
● 工作流与集成
★ 系统与维护
· 未分类

规则驱动表

分组	图标	建议分组键	命中关键词示例	说明
认知与分析	◆	`cognitive-analysis`	`analy`, `research`, `read`, `paper`, `study`, `learn`, `summar`, `interpret`	面向理解、分析、学习、信息提炼
文档与表达	▲	`document-expression`	`write`, `card`, `slide`, `doc`, `screenshot`, `theme`, `format`, `present`	面向文档生成、卡片化、展示与内容包装
开发与实现	■	`development-implementation`	`code`, `build`, `debug`, `test`, `refactor`, `lint`, `api`, `tool`, `script`	面向开发、调试、构建、工程执行
工作流与集成	●	`workflow-integration`	`workflow`, `sync`, `web`, `browser`, `fetch`, `search`, `agent`, `automation`	面向联网、集成、自动化、协作流程
系统与维护	★	`system-maintenance`	`setup`, `install`, `config`, `memory`, `skill`, `meta`, `manage`, `review`	面向安装配置、技能管理、维护与元能力
未分类	·	`uncategorized`	无命中	frontmatter 与规则都无法判定时的兜底分组

约束：

必须先使用 frontmatter category，不得被推断结果覆盖
规则必须基于字段与关键词，不依赖特定 skill 名示例
无法判定时统一归入 未分类

3. 渲染

用 ASCII 方框图呈现，保持稳定、可重复的布局。

╔══════════════════════════════════════════════════════════╗
║              SKILL MAP  ·  {N} skills installed         ║
╠══════════════════════════════════════════════════════════╣
║                                                          ║
║  ◆ 认知与分析                                            ║
║  +----------------------+-----------------------------+  ║
║  | paper/ v4.3.0        | 论文阅读与分析              |  ║
║  | plain  v4.0          | 好问题与类比解释            |  ║
║  +----------------------+-----------------------------+  ║
║                                                          ║
║  · 未分类                                                ║
║  +----------------------+-----------------------------+  ║
║  | mystery -            | 无法根据元数据判断用途      |  ║
║  +----------------------+-----------------------------+  ║
╠══════════════════════════════════════════════════════════╣
║ Total: 12  Invocable: 7  Groups: 5                      ║
╚══════════════════════════════════════════════════════════╝

ASCII 输出契约

分组按固定顺序输出；空分组可省略，但相对顺序不得变化
分组内技能按 name 升序排序
名称列左对齐，invocable = true 时在技能名后追加 /
版本紧随名称展示；缺失显示 -
描述仅保留单行摘要；超长时截断，避免破坏边界
desc 为空时显示 无描述
若没有扫描到任何技能，仍输出完整边框，并在正文显示 No installed skills found under ~/.claude/skills
若仅有一个技能，仍使用相同模板，不切换为其它格式
底部统计行至少包含：Total、Invocable、Groups

4. 输出

直接在对话中渲染 ASCII 地图：

不生成文件
不写入磁盘
不省略统计信息
不把原始 JSON 直接贴给用户，除非用户明确要求

最小验证标准

满足以下条件才算完成：

scripts/scan.sh 能输出合法 JSON 数组
JSON 中每条记录都包含 category 字段
category 解析顺序满足：frontmatter 优先、规则推断其次、未分类 兜底
description 同时兼容单行与多行 frontmatter，且不会串入其它 frontmatter 字段
version 缺失时为 -，user_invocable 缺失时为 false
空目录与单技能场景下，地图渲染规则仍成立