Ayaka Map Router — Development skill for Claude Code

Ayaka Map Router（全域技能路由器）

一个给 Qoder / Claude Code 等 Agent 客户端用的「技能路由」技能：它先扫描你本机**已经安装**的全部技能，生成一张按来源分组的路由地图，然后回答你的问题——**「这个任务到底该用哪个技能、走哪条流程？」**

当技能装到一两百个时，没人记得住每个技能叫什么、能干什么、是不是只能手动触发。Ayaka Map Router 把「选技能」这件事变成一次提问。

它能做什么

• 全域盘点：扫描以下所有位置里的技能（凡是含 SKILL.md 的目录都算一个技能）：
  • Qoder 用户级：~/.qoder-cn/skills
  • AGENTS 用户级：~/.agents/skills
  • Claude 用户级：~/.claude/skills
  • 已安装插件缓存：~/.qoder-cn/plugins/cache/**、~/.claude/plugins/**
  • 当前工作区：.qoder/skills、.agents/skills、plugins/*/skills
• 生成路由地图：按来源分组列出每个技能的名称、描述，并自动标注：
  • manual-only：该技能设了 disable-model-invocation: true，模型无法自动调用，只能用户 /名字 手动触发；
  • also in: …：同名技能在多个目录重复出现。
• 给推荐：把你的任务拆成「领域 × 任务类型 × 阶段」，最多推荐 3 个候选，说明理由、先后关系与触发方式。
• 场景分类：用关键词启发式给每个技能打上场景标签——coding（编程）/ design（设计绘图）/ writing（文件编写）/ chat（日常问答）/ general（通用工具），并在地图里生成「按场景归类」汇总段；一个技能可属多个场景，general 任何场景都可用。
• 会话场景闸门：每次调用本技能时，先按「场景 × 来源」盘点可用技能，再结合上下文并询问你判断当前会话属于哪种场景，然后只推荐 / 只调用匹配该场景（+ general）的技能，其余场景默认不主动调用；你说一声即可切换或按需开启。
• 可长期演进：地图里 之后的手写内容，在每次重新生成时都会被保留。

安装

把本仓库克隆（或复制）到任一用户级技能目录下即可，目录名保持 `ayaka-map-router`：

# Qoder CN
git clone https://github.com/xez65/ayaka-map-router.git ~/.qoder-cn/skills/ayaka-map-router

# 或 Claude Code
git clone https://github.com/xez65/ayaka-map-router.git ~/.claude/skills/ayaka-map-router

安装后重启会话，或运行 `/skills reload`，再用 `/skills list` 确认已加载。

环境要求：Node.js 18+（脚本仅用 Node 内置模块，无第三方依赖）。

使用

直接用 `/ayaka-map-router` 触发，后面写你想完成的事：

/ayaka-map-router 我想给论文答辩做一页架构图，用哪个技能？
/ayaka-map-router 有没有已装的技能能帮我做 test-first 的功能开发？
/ayaka-map-router 修一个偶发的 flaky 测试，该走什么流程？

**首次使用**时，如果还没有生成过地图，技能会让你先运行扫描脚本（也可以自己手动跑一次）：

node scripts/scan-skills.mjs --out references/routing-map.md

之后每次提问，它会读取 `references/routing-map.md`；当地图缺失、超过 30 天、或你刚增删了技能时，它会重新生成。

输出示例（推荐格式）：

🎯 首选：/c4model（plugin:architecture-visualization）— 需要证据可追溯的 C4/Structurizr 架构图，正好是一页答辩图。
🥈 备选：/graphviz — 若图更偏密集依赖而非 C4 分层。
🔀 若要成流程：/c4model 出