@yottameta/yotta-skills 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
+## v0.5.1 (2026-09-06)
+
+skills.json 三处滞后同步修复（yotta-skills 0.5.0→0.5.1）：元真 0.1.2→0.1.3 / 元忆 0.8.5→0.10.1 / 元守 0.1.1→0.2.1 + updated 改期 2026-09-06 + yotta-skills 四件对齐 0.5.1 + 技能分发清单副本 + 插件同步。
 # 更新日志
 
+## v0.5.0 (2026-08-31)
+
+方案 A（其他已装技能候选编排）：路由输出从「只编排元阁组合」扩展为「组合 + 并列候选提示」。
+
+- 新增 `--route` / `route_request` 输出「其他已装技能候选」：注册表中非元阁家族的已装技能，按 frontmatter `description` 与需求文本做本地机械匹配（英文词项 + 中文二字组交集），Top N（默认 3）并列展示，标注来源、得分、命中词项与扫描状态。
+- 安全边界：只读 frontmatter `description` 做机械匹配，不读取全文指令、不做语义推理、不自动调用；候选默认标注「未扫描」，使用/安装前需先做装前安全扫描；数据不出本机。
+- 确定性：同输入同输出，无状态、无个人数据；候选不参与组合融合排序，7 个静态组合输出保持不变。
+- CLI 文本输出追加「其他已装技能候选」段；`--json` 追加 `other_skill_candidates` / `other_skills_note` 字段；MCP `route_request` 同步。
+- 测试：路由核心新增候选匹配 / 元技能排除 / Top N 与排序 / 确定性 / 空结果；CLI JSON 与文本输出用例。
+- 版本升至 0.5.0。
+
 ## v0.4.0 (2026-08-31)
 
 阶段 C（O1 静态编排 playbook + 路由指引）：从「知道装了什么」升级为「给出该用哪几个、什么顺序」。

package/README.md

@@ -79,7 +79,7 @@ Requirements: Node.js 18+, npm, and system <code>tar</code> (built into Windows
 | `update [--agent <name> \| --dir <path>]` | Incremental update: add missing, upgrade version-skewed |
 | `--inventory` | Inventory installed skills: scan skill directories and update the local registry (self-contained); `--json` for JSON, `--project` adds project-level dirs |
 | `--reindex` | Re-index the registry: re-scan skill directories and merge changes incrementally (session start / after installing skills; `--rescan` is a synonym); `--json` for JSON |
-| `--route <task-summary>` | Static orchestration routing: return a combination, call order, per-skill roles, confidence, evidence, installed/missing status, and an install suggestion; `--json` for JSON, `--project` adds project-level dirs |
+| `--route <task-summary>` | Static orchestration routing: return a combination, call order, per-skill roles, confidence, evidence, installed/missing status, and an install suggestion; also lists other installed (non-YottaMeta) skills as candidates matched mechanically against their frontmatter description, tagged "not scanned", read-only and never auto-invoked; `--json` for JSON, `--project` adds project-level dirs |
 | `--no-reindex` | Do not re-index the registry automatically after `install` / `update` |
 | `--dry-run` | Preview the install / update list; no network, no changes |
 | `--pin` | Lock the exact manifest versions (default: range, latest patch of the same major) |

package/README.zh-CN.md

@@ -29,7 +29,7 @@
 元阁也是全家的**编排策划层**：接到需求先查「编排策划」组合表——该组合哪几个技能、按什么顺序、各自强在哪——再按需安装恰好那几个。决策表随包提供（<code>references/orchestration.md</code>），<code>SKILL.md</code> 中有摘要。
 
 - **看清单**--全家技能一览：slug / 中文名 / 包名 / 版本 / 一句话说明。
-- **编排路由**--`--route` 按需求摘要输出候选组合、调用顺序、技能角色、置信度、依据、已装/缺失状态与安装命令；只建议安装，不自动安装。
+- **编排路由**--`--route` 按需求摘要输出候选组合、调用顺序、技能角色、置信度、依据、已装/缺失状态与安装命令；非元阁家族已装技能按 frontmatter description 机械匹配作并列候选（标注来源与未扫描状态，只读不自动调用）；只建议安装，不自动安装。
 - **安装**——装全家（或指定技能）到智能体默认用户级目录或任意目录。
 - **更新**——增量更新：补齐缺失技能、升级版本不一致的技能。
 - **幂等**——已在清单版本的技能跳过；重复运行安全。

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: yotta-skills
-version: 0.4.0
-description: 元阁 -- 元阁全家技能的总编排策划 + 编排路由 + 一键安装器 + 技能盘点。路由层：--route / route_request 按需求摘要给出候选组合、调用顺序、角色、置信度、依据、已装/缺失状态与安装命令，只建议不自动安装；策划层：按场景给出「该组合哪几个元技能、组合强在哪、怎么自动装+自动用」；安装层：一条命令把 YottaMeta 已发布的全部 yotta-* 技能装进指定智能体或目录；盘点层：--inventory / --reindex 扫描本机已装技能生成/更新注册表，新装技能自动被发现（install/update 后自动 re-index，会话开工可先跑 --reindex；自包含零依赖，不依赖任何元技能）；MCP 按需加载（可选：list_installed_skills/describe_skill/reindex/route_request，不常驻，未加载降级 CLI）。支持 --list 清单 / --route 路由 / install / update / --inventory / --reindex / --dry-run 预览 / --pin 锁版本。触发：需要批量安装或更新元阁全家技能、按场景组合多个元技能、路由或判断该用哪些技能、盘点或查看本机已装技能、重扫技能注册表、给某个智能体或目录一次性铺齐 yotta-* 技能、预览安装清单、锁版本安装、或用户说 元阁/装全家/一次装齐/yotta-skills/install-all/更新全家/该用哪个技能/路由技能/盘点技能/查看已装技能 等。边界（Do NOT trigger）：只做「组合策划 + 静态路由建议 + 清单 + 下载 + 落位 + 汇总 + 盘点 + re-index」，不含技能本体、不做技能内容开发、不 -g 污染全局、不自动安装缺失技能；装前摘要仅供参考，安装决策由用户确认。
+version: 0.5.1
+description: 元阁 -- 元阁全家技能的总编排策划 + 编排路由 + 一键安装器 + 技能盘点。路由层：--route / route_request 按需求摘要给出候选组合、调用顺序、角色、置信度、依据、已装/缺失状态与安装命令，只建议不自动安装；非元阁家族已装技能按 frontmatter description 机械匹配作并列候选（标注来源与未扫描状态，只读不自动调用）；策划层：按场景给出「该组合哪几个元技能、组合强在哪、怎么自动装+自动用」；安装层：一条命令把 YottaMeta 已发布的全部 yotta-* 技能装进指定智能体或目录；盘点层：--inventory / --reindex 扫描本机已装技能生成/更新注册表，新装技能自动被发现（install/update 后自动 re-index，会话开工可先跑 --reindex；自包含零依赖，不依赖任何元技能）；MCP 按需加载（可选：list_installed_skills/describe_skill/reindex/route_request，不常驻，未加载降级 CLI）。支持 --list 清单 / --route 路由 / install / update / --inventory / --reindex / --dry-run 预览 / --pin 锁版本。触发：需要批量安装或更新元阁全家技能、按场景组合多个元技能、路由或判断该用哪些技能、盘点或查看本机已装技能、重扫技能注册表、给某个智能体或目录一次性铺齐 yotta-* 技能、预览安装清单、锁版本安装、或用户说 元阁/装全家/一次装齐/yotta-skills/install-all/更新全家/该用哪个技能/路由技能/盘点技能/查看已装技能 等。边界（Do NOT trigger）：只做「组合策划 + 静态路由建议 + 清单 + 下载 + 落位 + 汇总 + 盘点 + re-index」，不含技能本体、不做技能内容开发、不 -g 污染全局、不自动安装缺失技能；装前摘要仅供参考，安装决策由用户确认。
 license: MIT
 metadata:
   zh_name: 元阁
@@ -29,7 +29,7 @@ metadata:
 
 **元阁全家的总编排策划 + 编排路由 + 一键安装 + 技能盘点**，一句话四层：
 
-- **路由层（该用哪几个）**：`--route "<需求摘要>"` / MCP `route_request` 查本地注册表与静态编排 playbook，输出候选组合、调用顺序、每个技能角色、置信度、依据、已装/缺失状态与安装命令；只建议安装，不自动安装。
+- **路由层（该用哪几个）**：`--route "<需求摘要>"` / MCP `route_request` 查本地注册表与静态编排 playbook，输出候选组合、调用顺序、每个技能角色、置信度、依据、已装/缺失状态与安装命令；非元阁家族已装技能按 frontmatter description 机械匹配作并列候选（标注来源与未扫描状态，只读不自动调用）；只建议安装，不自动安装。
 - **策划层（怎么用）**：接到需求，先按「编排策划」定位命中哪个组合——哪些元技能搭配起来最强、适合什么场景、AI 该怎么自动装并自动用起来。
 - **安装层（怎么装）**：一条 `npx -y @yottameta/yotta-skills` 把组合/全家装进指定智能体或目录——`--list` 看清单、`install` 装、`update` 增量更新、`--dry-run` 预览、`--pin` 锁版本。
 - **盘点层（已装了什么）**：`--inventory` / `--reindex` 扫描本机各智能体技能目录，生成/更新本地注册表；装技能后自动 re-index，新装技能自动被发现——自包含扫描，不依赖任何元技能。

package/bin/yotta-skills.js

@@ -529,11 +529,12 @@ function runReindex(opts) {
   out('注册表: ' + scan.registryPath());
 }
 
-/** --route：静态编排路由，输出组合、顺序、角色与缺失技能建议。 */
+/** --route：静态编排路由，输出组合、顺序、角色、缺失技能建议与其他已装技能候选。 */
 function runRoute(opts) {
-  const { routeRequest } = require('../lib/route');
+  const { routeRequest, defaultYottaSlugs } = require('../lib/route');
   const { registry } = reindexRegistry(opts);
-  const result = routeRequest(opts.route, { registry });
+  const yottaSlugs = new Set([...defaultYottaSlugs(), ...MANIFEST.map((s) => s.slug)]);
+  const result = routeRequest(opts.route, { registry, yottaSlugs });
   if (opts.json) {
     out(JSON.stringify(result, null, 2));
     return;
@@ -552,6 +553,16 @@ function runRoute(opts) {
     out('安装命令: ' + result.install_command);
     out('安全提示: 安装前请先执行装前安全扫描；本命令不会自动安装。');
   }
+  if (result.other_skill_candidates.length) {
+    out('');
+    out('其他已装技能候选（非元阁家族，仅本地机械匹配 frontmatter description）:');
+    for (const c of result.other_skill_candidates) {
+      out('  - ' + c.slug + ' v' + c.version + ' [' + (c.sources || []).join(',') + ']');
+      out('    匹配: ' + c.matched_terms.join('、') + '（得分 ' + c.score + '）· 扫描状态: ' + (c.scan_status === 'not_scanned' ? '未扫描' : c.scan_status));
+      out('    ' + (c.description || ''));
+    }
+    out('安全提示: 其他已装技能只读 frontmatter description 做机械匹配，不读取全文指令、不自动调用；使用/安装前请先执行装前安全扫描，决定权在用户。');
+  }
   out('');
   out('应用模式: 显式调用（可经用户确认后切换为按场景自动调用）');
   out('说明: ' + result.disclaimer);

package/lib/route.js

@@ -81,6 +81,63 @@ const PLAYBOOKS = [
   },
 ];
 
+const OTHER_SKILLS_NOTE = '其他已装技能仅作并列候选提示：机械匹配 frontmatter description，未做语义推理、未读取全文指令、未自动调用；数据不出本机。';
+const OTHER_SKILL_NOTE = '非元阁家族技能：仅按 frontmatter description 本地机械匹配；不读取全文指令、不自动调用；使用/安装前请先做装前安全扫描。';
+const EN_STOPWORDS = new Set([
+  'a', 'an', 'the', 'and', 'or', 'of', 'to', 'in', 'on', 'for', 'with', 'from',
+  'this', 'that', 'is', 'are', 'was', 'were', 'be', 'been', 'your', 'you', 'our',
+  'we', 'it', 'at', 'by', 'as', 'not', 'no', 'so', 'do', 'does',
+]);
+
+/** 元阁家族 slug 集合：playbook 引用 + 已知不入 playbook 的元技能（如 yotta-chart）。 */
+function defaultYottaSlugs() {
+  const set = new Set(['yotta-chart']);
+  for (const playbook of PLAYBOOKS) {
+    for (const skill of playbook.skills) set.add(skill.slug);
+  }
+  return Array.from(set);
+}
+
+/** 英文词项：≥3 字母的单词，过滤停用词（保留出现顺序、去重）。 */
+function enTokens(text) {
+  const tokens = [];
+  const seen = new Set();
+  for (const m of String(text || '').toLowerCase().match(/[a-z][a-z0-9]{2,}/g) || []) {
+    if (EN_STOPWORDS.has(m) || seen.has(m)) continue;
+    seen.add(m);
+    tokens.push(m);
+  }
+  return tokens;
+}
+
+/** 中文词项：CJK 连续片段内相邻两字 bigram（零依赖确定性分词）。 */
+function cjkBigrams(text) {
+  const bigrams = [];
+  const seen = new Set();
+  for (const m of String(text || '').match(/[\u4e00-\u9fff]+/g) || []) {
+    for (let i = 0; i < m.length - 1; i++) {
+      const g = m.slice(i, i + 2);
+      if (seen.has(g)) continue;
+      seen.add(g);
+      bigrams.push(g);
+    }
+  }
+  return bigrams;
+}
+
+/** 需求与候选文本的词项匹配：英文 token + 中文 bigram 交集，按需求侧出现顺序输出。 */
+function scoreOtherSkill(request, record) {
+  const candidateText = [record.description, record.slug].filter(Boolean).join(' ');
+  const reqTokens = enTokens(request);
+  const reqBigrams = cjkBigrams(request);
+  const candTokens = new Set(enTokens(candidateText));
+  const candBigrams = new Set(cjkBigrams(candidateText));
+  const matched = [];
+  for (const item of reqTokens) if (candTokens.has(item)) matched.push(item);
+  for (const item of reqBigrams) if (candBigrams.has(item)) matched.push(item);
+  return { score: matched.length, matched_terms: matched };
+}
+
 function normalizeText(text) {
   return String(text || '').toLowerCase().replace(/\s+/g, '');
 }
@@ -101,6 +158,8 @@ function scorePlaybook(request, playbook) {
 function routeRequest(request, options) {
   const registry = (options && options.registry) || { skills: {} };
   const installed = registry.skills || {};
+  const yottaSlugs = new Set((options && options.yottaSlugs) || defaultYottaSlugs());
+  const otherSkillsTopN = (options && options.otherSkillsTopN) || 3;
   const ranked = PLAYBOOKS
     .map((playbook) => ({ playbook, ...scorePlaybook(request, playbook) }))
     .sort((a, b) => b.score - a.score || a.playbook.id.localeCompare(b.playbook.id));
@@ -135,6 +194,23 @@ function routeRequest(request, options) {
       + ' --dir <skills-dir>'
     : null;
 
+  const otherCandidates = Object.values(installed)
+    .filter((record) => record && record.status !== 'gone' && !yottaSlugs.has(record.slug))
+    .map((record) => ({ record, ...scoreOtherSkill(request, record) }))
+    .filter((item) => item.score > 0)
+    .sort((a, b) => b.score - a.score || a.record.slug.localeCompare(b.record.slug))
+    .slice(0, otherSkillsTopN)
+    .map(({ record, score, matched_terms }) => ({
+      slug: record.slug,
+      version: record.version || '',
+      sources: record.sources || [],
+      description: record.description || '',
+      score,
+      matched_terms,
+      scan_status: 'not_scanned',
+      note: OTHER_SKILL_NOTE,
+    }));
+
   return {
     request,
     playbook: {
@@ -154,7 +230,9 @@ function routeRequest(request, options) {
       note: '默认用户显式调用；切换为按场景自动调用需要用户确认。',
     },
     disclaimer: '路由建议不保证完全正确；关键动作应由用户确认，数据不出本机。',
+    other_skill_candidates: otherCandidates,
+    other_skills_note: OTHER_SKILLS_NOTE,
   };
 }
 
-module.exports = { PLAYBOOKS, routeRequest };
+module.exports = { PLAYBOOKS, defaultYottaSlugs, routeRequest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottameta/yotta-skills",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "YuanGe (元阁) - orchestration routing, inventory, and one-command installer for the YottaMeta skill family (zero dependencies, Node.js only).",
   "license": "MIT",
   "keywords": [

package/references/orchestration.md

@@ -14,11 +14,11 @@
 npx -y @yottameta/yotta-skills --route "帮我润色输出，要规范可复制，别有 AI 味"
 ```
 
-- **输出**：候选组合、调用顺序、每个技能的角色、置信度、命中依据、已装/缺失状态、安装命令与应用模式提醒。
+- **输出**：候选组合、调用顺序、每个技能的角色、置信度、命中依据、已装/缺失状态、安装命令与应用模式提醒；如本机装了非元阁家族技能，还会给出其他已装技能候选（仅按 frontmatter description 机械匹配，标注来源与未扫描状态）。
 - **缺失技能**：只给安装命令，不自动安装；安装前先做装前安全扫描，决定权在用户。
 - **应用模式**：默认用户显式调用；切换为「按场景自动调用」需要用户确认。
 - **无明确匹配**：低置信度回退到「入口 + 安装」组合，先澄清需求再继续。
-- **边界**：路由是建议，不保证完全正确；关键动作由用户确认，数据不出本机。
+- **边界**：路由是建议，不保证完全正确；关键动作由用户确认，数据不出本机。其他已装技能候选只读 frontmatter description、不读取全文指令、不自动调用；使用/安装前先做装前安全扫描。
 
 ---
 

package/references/tutorial.md

@@ -129,3 +129,4 @@ npx -y @yottameta/yotta-skills --route "检查代码质量，别糊弄"
 
 输出会告诉你命中哪个组合、按什么顺序调用、每个技能负责什么、哪些已装、哪些缺失，以及缺失技能的安装命令。元阁只给建议，不会自动安装；安装前请先做装前安全扫描，并由用户确认。
 - `--json` 输出机器可读结果（含新增 / 更新 / 消失），适合脚本与钩子。
+- 如果本机还装了非元阁家族技能，`--route` 会额外列出「其他已装技能候选」：只按 frontmatter description 与需求文本做本地机械匹配，标注来源、得分、命中词项与扫描状态（默认未扫描），不读取全文指令、不自动调用；使用/安装前请先做装前安全扫描。

package/scripts/yotta-skills-mcp.py

@@ -24,7 +24,7 @@ import subprocess
 import sys
 from pathlib import Path
 
-VERSION = "0.4.0"
+VERSION = "0.5.1"
 TOOL_NAME = "yotta-skills"
 CN_NAME = "元阁"
 MCP_PROTOCOL = "2025-03-26"
@@ -185,6 +185,7 @@ def mcp_tools():
         _tool_spec(
             "route_request",
             "按需求摘要给出静态编排路由建议：候选组合、调用顺序、每个技能角色、置信度、依据、已装/缺失状态与安装命令。"
+            "并给出其他已装技能候选（仅按 frontmatter description 本地机械匹配、标注未扫描状态，不读取全文指令、不自动调用）。"
             "只建议安装，不自动安装；数据不出本机。",
             {"request": {"type": "string", "description": "用户需求摘要"}},
             ["request"],

package/skills.json

@@ -1,6 +1,6 @@
 {
   "manifestVersion": 1,
-  "updated": "2026-08-30",
+  "updated": "2026-09-06",
   "note": "清单同步要求：每次技能发布新版本后，按 YottaSkills 技能登记表更新本文件（登记表为内部台账，不随包分发）。",
   "skills": [
     {
@@ -28,7 +28,7 @@
       "slug": "yotta-memory",
       "name": "元忆",
       "pkg": "@yottameta/yotta-memory",
-      "version": "0.8.5",
+      "version": "0.10.1",
       "desc": "有权限边界的文件式智能体记忆（FACT/PREF/BOUND/COMMIT）"
     },
     {
@@ -70,7 +70,7 @@
       "slug": "yotta-humanize",
       "name": "元真",
       "pkg": "@yottameta/yotta-humanize",
-      "version": "0.1.2",
+      "version": "0.1.3",
       "desc": "去 AI 味中文写作编辑：检测器引擎"
     },
     {
@@ -105,7 +105,7 @@
       "slug": "yotta-publish-guard",
       "name": "元守",
       "pkg": "@yottameta/yotta-publish-guard",
-      "version": "0.1.1",
+      "version": "0.2.1",
       "desc": "工坊「守」：发布前守门（版本四件对齐 + 三通道查重）"
     },
     {