# 模块 M5 技能生态 审计报告

> **审计版本**: V12 | **日期**: 2026-04-04

## 1. 链路完整性

| 链路 | 状态 | 备注 |
|------|------|------|
| 技能发现(discover) | ✅ | loader.rs → skill_list Tauri 命令 |
| 技能加载(load) | ✅ | SKILL.md YAML frontmatter 解析 |
| 技能注册(register) | ✅ | Registry HashMap + Tauri skill_list |
| 技能索引(index) | ✅ | SkillIndexMiddleware 注入 system prompt |
| 语义路由(route) | ✅ | TF-IDF + 可选 embedding + LLM fallback |
| 技能执行(execute) | ✅ | PromptOnly/Python/Shell 三模式 |
| 技能 CRUD | ✅ | create/update/delete 写磁盘 SKILL.md |
| 技能编排(orchestration) | ✅ | DAG 并行执行+重试+取消 |

**链路完整性评分: 92/100**

## 2. 问题清单

| ID | 文件:行号 | 级别 | 描述 | 修复建议 |
|----|----------|------|------|---------|
| M5-01 | `skill-discovery.ts:110-123` | **P1** | convertFromBackend() 将 `tags` 误映射为 `triggers`，`tags[0]` 映射为 `category`，丢失真正的 triggers 数据 | 改为 `triggers: backend.triggers`, `category: backend.category` |
| M5-02 | `loader.rs:49-104` | P2 | SKILL.md frontmatter 不解析 `tools` 字段，75 个 SKILL.md 的 tools 定义被静默忽略 | 增加 tools 字段提取 |
| M5-03 | `runner.rs:83` | P2 | PythonSkill 硬编码 `python3`，Windows 上通常是 `python`，Python 模式技能在 Windows 失败 | 条件编译或运行时检测 |
| M5-04 | `loader.rs:59-64` | P3 | YAML triggers 解析引号剥离只处理双引号 | 统一处理单引号和无引号 |
| M5-05 | `runner.rs:130-170` | P3 | ShellSkill duration_ms 未设置，始终为 None | 移除 `_` 前缀赋值到 SkillResult |
| M5-06 | `SkillCard.tsx:35-45` | P3 | CATEGORY_CONFIG 只覆盖 9 种分类，未匹配分类显示灰色 | 扩展或动态生成 |

**综合健康度: 85/100** — 核心链路完整，前端 triggers 映射错误是唯一 P1。