nudt_skill

YHFT 技能站点。通过 Agent Skills 协议（skills.sh / npx skills CLI）向客户分发 Claude Code 等 AI 助手的技能包。

目录结构

nudt_skill/
├── cmd/server/main.go      # Go 静态文件服务器（带 CORS，监听 PORT，默认 8888）
├── scripts/build-skills.sh # 构建脚本：skills/ → site/ 打包 + 生成 index.json
├── skills/                 # 技能源码（每个子目录含 SKILL.md）
│   ├── yhft-devtools/          # 代码生成与开发
│   ├── yhft-evalution/     # 评估评测（NPU 板卡性能评估）
│   ├── yhft-netrans/       # NETrans 神经网络翻译
│   └── yhft-x78ne/        # x78NE 板级开发/自动测试/PNNA 推理
├── site/                   # 线上服务目录（Go 服务器静态根）
│   ├── index.html          # 展示页（手写，构建脚本不覆盖）
│   ├── usage.html          # 使用说明页（手写，构建脚本不覆盖）
│   ├── assets/             # 展示页样式/脚本（手写）
│   ├── EDITING.md          # 展示页编辑指南
│   ├── .well-known/agent-skills/index.json  # 技能发现索引（build-skills.sh 生成）
│   └── skills/*.tar.gz     # 打包后的技能（build-skills.sh 生成）
├── deploy-skill/           # 部署更新技能（本地专用，不参与打包，不上传服务器）
├── Dockerfile              # 容器镜像（go 构建 + scratch 运行）
└── docker-compose.yml      # 一键容器部署

技能站点

• 生产环境 URL：http://skills.nudtdsp.com:8888（根路径为技能展示页 site/index.html）
• 展示页：site/index.html（技能卡片、安装命令、发现索引说明，手写维护）
• 发现索引：http://skills.nudtdsp.com:8888/.well-known/agent-skills/index.json
• 当前技能：yhft-dsp（全量包）+ yhft-devtools、yhft-evalution、yhft-netrans、yhft-x78ne
• 服务器以 systemd 服务 nudt-skills.service 运行（Restart=always，自动恢复），站点目录为 /home/ubuntu/nudt_skill/site

---

一、安装技能

使用 npx skills CLI（需要 Node.js）。有两种安装方式：

• 方式一：从云服务器安装 —— 原在线安装方式，云服务器已停用，http://skills.nudtdsp.com:8888 目前不可访问，仅作存档保留。
• 方式二：从 Git 仓库克隆安装 —— 当前推荐方式，从 gitlink 仓库直接安装，无需云服务器。

---

方式一：从云服务器安装（已停用，仅存档）

<URL> 为站点地址，如 http://skills.nudtdsp.com:8888。

安装全部技能（推荐：yhft-dsp 全量包）

npx skills add http://skills.nudtdsp.com:8888 -s yhft-dsp --yes -g

yhft-dsp 是全量聚合包：一次安装即包含全部子技能（yhft-devtools、yhft-evalution、yhft-netrans、yhft-x78ne）和一个路由入口，用 /yhft-dsp 按意图自动分发到对应子技能。客户一条命令装完即可用。

安装单个技能

npx skills add http://skills.nudtdsp.com:8888 -s yhft-netrans --yes -g

---

方式二：从 Git 仓库克隆安装（当前推荐）

技能资源托管在 https://gitlink.org.cn/nudt_dsp/nudt_skill.git。需要 git 和 Node.js（npx skills CLI）。没有 Node.js 环境的用户，从 conda 开始搭建：

第 1 步：conda 创建环境并安装 Node.js

# 创建独立环境，安装 nodejs（含 npm/npx）和 git（克隆仓库用）
conda create -n yhft-skills -c conda-forge nodejs git -y
conda activate yhft-skills

# 验证
node -v && npx -v && git --version

• 此环境只用于运行 npx skills，无需指定 Python 版本（安装过程不使用 Python）。
• 已有 Node.js（v18+）和 git 的用户可跳过此步，直接进入第 2 步。

第 2 步：从 Git 仓库安装技能

# 安装全部技能（推荐）
npx skills add https://gitlink.org.cn/nudt_dsp/nudt_skill.git -s '*' --yes -g

# 或安装单个技能
npx skills add https://gitlink.org.cn/nudt_dsp/nudt_skill.git -s yhft-netrans --yes -g

Git 安装方式下技能以子技能形式提供（yhft-devtools、yhft-evalution、yhft-netrans、yhft-x78ne），-s '*' 一次装全部。

npx skills 会自动 clone 仓库、读取 skills/ 目录下的技能并安装。

Windows 与 Ubuntu/Linux 的差异

安装命令在两个平台上完全一致（conda 命令、npx 命令均通用），仅以下细节不同：

项目	Ubuntu / Linux / macOS	Windows
通配符引号	单引号 -s '*'	PowerShell/CMD 用双引号 -s "*"；Git Bash 中单引号 -s '*' 也可
符号链接	系统原生支持，无需配置	由 CLI 自动处理，已验证可正常安装
无 conda 时的替代	sudo apt install nodejs npm git（注意 apt 源的 nodejs 可能低于 v18，版本不够时仍建议用 conda 方式）	官网安装包或 nvm-windows

技能本身是纯 Markdown 静态文件，装完由 AI 助手直接读取，跨平台通用。

说明

• 安装完成后技能写入 ~/.agents/skills/<skill>/，并符号链接到各助手目录（如 ~/.claude/skills/）。技能是静态文件，运行时不依赖 conda 环境——装完即可 conda deactivate，之后由 Claude Code 等 AI 助手直接读取。
• 下次需要增删技能时，重新 conda activate yhft-skills 后再执行 npx skills 命令即可。

常用参数

参数	含义
-s, --skill <name>	指定安装某个技能（'*' 为全部）
-a, --agent <agents>	指定安装到的 AI 助手（'*' 为全部，含 Claude Code）
-g, --global	全局安装（用户级 ~/.agents/skills/，跨项目可用）
-y, --yes	跳过确认提示
--all	简写 --skill '*' --agent '*' -y，一键装全部技能到全部助手
-l, --list	只列出仓库内可用技能，不安装
--copy	复制文件而非符号链接

安装后技能会写入 ~/.agents/skills/<skill>/，并符号链接到各助手目录（如 ~/.claude/skills/）。

部署方式也支持直接指定 git 仓库：npx skills add https://gitlink.org.cn/nudt_dsp/nudt_skill.git

---

二、删除技能

# 删除单个技能（全局作用域）
npx skills remove yhft-netrans -g -y

# 删除多个技能
npx skills remove yhft-netrans yhft-devtools -g -y

# 交互式选择要删除的技能（不带参数会弹出菜单）
npx skills remove

# 删除全部技能
npx skills remove --all

# 从指定助手删除（如仅 Claude Code）
npx skills remove yhft-netrans -a claude-code -y

删除会移除 ~/.agents/skills/ 下的目录及助手中的符号链接。

---

三、查询技能

1. 查询本地已安装的技能

npx skills list        # 或 npx skills ls

2. 查询站点上可用（但未安装）的技能

npx skills add http://skills.nudtdsp.com:8888 -l

3. 直接查站点的发现索引

curl http://skills.nudtdsp.com:8888/.well-known/agent-skills/index.json

index.json 返回每个技能的 name、type、url、digest（sha256）和 description。

四、构建 skills/ 下的子技能

子技能规范

每个技能 = skills/<name>/ 目录 + SKILL.md，结构如下：

---
name: yhft-xxx
description: |
  一句话描述技能用途。
  支持命令：/yhft-xxx
  Trigger: trigger phrase
---

# yhft-xxx：技能标题

你是 ... 助手。处理 ... 相关任务。

构建要求（由 build-skills.sh 强制）：

• 目录必须位于 skills/ 下，且含 SKILL.md 才会被打包
• SKILL.md 必须含 YAML frontmatter 的 name 和 description（description 取前 80 字符用于索引）
• 目录名即技能名（name 应与目录名一致）
• skills/ 下新增/删除目录 → 重新运行构建脚本即生效