菜单
plumb-link 技能集的总控入口。核心职责是技能生成器的入口，引导用户生成新技能。同时提供安装指引和指令消歧能力，技能列表统一由 agents/skill_registry.yaml 管理。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | plumb-link |
| description | plumb-link 技能集的总控入口。核心职责是技能生成器的入口，引导用户生成新技能。同时提供安装指引和指令消歧能力，技能列表统一由 agents/skill_registry.yaml 管理。 |
| metadata | {"internal":true} |
本技能负责三类交互：安装指引、指令消歧、技能生成引导。
当用户请求安装 plumb-link 项目的 skill 时，引导用户查看安装说明文件。
安装相关信息请参考：
scripts/install.pyagents/skill_registry.yaml（统一管理所有技能元数据）# 全部安装
python3 scripts/install.py /path/to/project
# 按需安装（参考 agents/skill_registry.yaml 获取技能名称）
python3 scripts/install.py /path/to/project --skills skill-name1 skill-name2
可用技能列表统一维护在 agents/skill_registry.yaml，包含：
当用户发出模糊指令时，先尝试自动探测；若无法明确判断，从注册表查询候选 skill 让用户选择。
用户输入模糊指令
│
▼
查询 agents/skill_registry.yaml
│
▼
自动匹配
│
├─ 唯一匹配 → 直接调用对应 skill
│
└─ 匹配多个或无法判断 → 列出候选 skill 供用户选择
指令消歧通过查询 agents/skill_registry.yaml 中的关键词进行匹配：
👤 编译
🤖 正在查询可用技能...
🤖 检测到多个匹配技能：
1. build-linux-app — Linux 应用编译
2. linux-build — Linux 内核构建
请输入编号或 skill 名称：
👤 1
🤖 使用 build-linux-app，正在配置编译环境...
当用户希望生成新技能时，引导其使用 plumb-link 根目录的技能生成器。
当用户表达技能生成需求时：
.trae/SKILL.md（技能生成器入口）.trae/rules/01-minimal-unit.md）.trae/rules/02-path-structure.md）agents/skill_registry.yaml当用户希望删除技能时，引导其使用 plumb-link 根目录的技能删除器。
当用户表达技能删除需求时：
.trae/SKILL.md（技能生成器入口）skills/ 目录.trae/rules/05-skill-removal.md）skills/{category}/{skill-name}/ 目录agents/skill_registry.yaml 中删除技能记录| 安全机制 | 说明 |
|---|---|
| 依赖检查 | 检查是否有其他技能依赖此技能 |
| 核心技能保护 | 核心技能（如 build-linux-app）受保护无法删除 |
| 完整清理 | 同时删除技能目录和注册表记录 |
| 确认删除意图 | 与用户确认删除意图 |
| 大类 | 小类示例 | 适用场景 |
|---|---|---|
| software | T(编译)、D(部署)、V(版本)、O(运维)、S(服务)、A(应用) | 软件相关技能 |
| hardware | HW(硬件) | 硬件相关技能 |
| platform | PL(平台) | 平台相关技能 |
| workflow | WF(工作流) | 工作流相关技能 |
👤 我想生成一个 NFS 网络挂载开发板的技能
🤖 正在分析技能需求...
分析结果：
- 是否为最小单元：否
- 拆分方案：
1. nfs-mount（NFS 挂载）→ software
2. network-config（网络配置）→ software
3. board-detect（开发板检测）→ platform
开始生成...
✓ 已生成技能：nfs-mount
路径：skills/software/nfs-mount/
✓ 已生成技能：network-config
路径：skills/software/network-config/
✓ 已生成技能：board-detect
路径：skills/platform/board-detect/
✓ 已更新注册表：agents/skill_registry.yaml
下一步建议：
1. 完善各技能脚本实现
2. 编写测试用例
3. 添加参考文档
👤 我想删除 old-skill 技能
🤖 正在验证删除请求...
验证结果：
- 技能名称：old-skill
- 分类：software
- 路径：skills/software/old-skill/
检查依赖关系：
- 无其他技能依赖此技能
开始删除...
✓ 已删除技能目录：skills/software/old-skill/
✓ 已更新注册表：agents/skill_registry.yaml
删除完成！
👤 我想删除 build-linux-app 技能
🤖 正在验证删除请求...
验证结果：
- 技能名称：build-linux-app
- 分类：software
⚠️ 此技能是 plumb-link 的核心技能，受保护无法删除。
如需修改，请使用更新版本功能。
plumb-link 与 plug-lens 形成姊妹双生态：
| 项目 | 定位 | 职责 |
|---|---|---|
| plug-lens | 嵌入式业务代码的可插拔架构框架 | 做业务落地 |
| plumb-link | 嵌入式AI技能的垂准基准与生态适配框架 | 做开发提效 |
安装完成后，告知用户：
/skill-name 调用具体 skillscripts/install.py 实现