skill-map: 技能地图 Skill

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
空目录与单技能场景下，地图渲染规则仍成立

Agent Skills: skill-map: 技能地图

Install this agent skill to your local

Skill Files