# 📦 Fmode 总技能库（fmode-skills）

> **让AI进化提前发生，让AI落地快人一步**
> 未来飞马 — 一次安装，全部 Fmode 能力自动落盘。

Fmode 总技能库是一个**元技能 / Meta Skill**：本身不执行业务，而是承载
`installer.mjs`，检测宿主 Agent 后把仓库内全部子技能**自动分发到对应技能目录**。
用户只需安装本技能，其他所有技能自动完成安装。

## 核心定位

- **一套技能库**统一承载 FMODE 全部可公开业务能力（数字分身初始化、云资源领取、前后端发布、VOC 情报、企微、支付、课件、报告）
- **ESM-first 多端兼容**：同一份技能兼容 WorkBuddy / Claude Code / Hermes
- **密钥剥离**：公开技能只描述接口/端点/流程，token 一律走环境变量，不含任何内部密钥
- 系统层运维技能（含密钥）剥离在内部仓库，不进公开 skillhub

## 快速开始

### 方式 1：仓库安装（Gogs / GitHub）

```bash
git clone https://git.fmode.cn/fmode/fmode-skills.git
cd fmode-skills
node scripts/installer.mjs --all        # 分发全部子技能到宿主技能目录
node scripts/installer.mjs --check      # 检查现状（只读）
```

### 方式 2：skillhub 检索安装

在 skillhub.cn 检索 `fmode-skills`，安装后运行仓库内 installer。

## 安装器行为

| 宿主 | 落盘目录 |
|------|---------|
| WorkBuddy | `~/.workbuddy/skills/` |
| Claude Code / FmodeCode | `~/.claude/skills/` |
| Hermes Agent | `~/.hermes/skills/` |

## 子技能清单（15 个，纯接口驱动）

> 所有子技能只依赖「公开 HTTP 接口 + 用户 token(env) + Agent 原生工具」，不依赖任何需另行安装的软件/fmode-studio。

### 服务级（Platform Services）
- `fmode-account` — 手机验证码注册/登录/sessionToken
- `fmode-enterprise` — 企业开通状态/独立部署
- `fmode-cloud-functions` — 云函数部署与调用（/api/functions）
- `fmode-cloud-resources` — 云资源领取（华为云 STS）
- `fmode-static-publish` — 静态站发布（OBS+CDN）
- `fmode-git-archive` — 项目 Git 归档（Gitea）
- `fmode-vision` — 视觉识别（公开 API）
- `fmode-listen` — 录音转写（公开网关 API）
- `fmode-storage` — 对象存储与公开分享

### 应用级（Business Applications）
- `fmode-voc-intelligence` — 小红书/抖音/视频号 VOC 情报
- `fmode-tihao` — 提号 SOP 达人研究
- `fmode-product-lab` — 新品研发
- `fmode-pay` — 微信特约商户进件
- `fmode-courseware` — 课程课件生产
- `fmode-report-publish` — HTML 报告发布

> 已剔除（依赖本地/软件）：`fmode-ffmpeg`（本地 ffmpeg 二进制）、`fmode-qiwei`（企微网关部署）。

## FAQ

**Q: 为什么用"总技能库"形态？**
用户只需安装一个技能（fmode-skills），installer 自动落盘全部子技能，避免逐个安装。

**Q: 技术框架是什么？**
ESM（ECMAScript Modules），`installer.mjs` 零 npm 依赖（Node>=18 自带 fetch），
每个子技能含 `SKILL.md` + `scripts/` + `references/`，符合 skill-core-guide 规范。

**Q: 和 skill-core-guide 的关系？**
skill-core-guide 是母技能（定义平台规范/分类体系/打包标准），本库是**总技能库**
（承载全部子技能并按宿主分发）。两者互补。

**Q: 开源协议？**
MPL-2.0。

## License

MPL-2.0 © 2026 Fmode (未来飞马)

> MPL-2.0 governs copyright for source code only. This license does NOT grant
> any right to use our trademarks: 未来飞马, Harness Loop, RSI, and the slogan
> "让AI进化提前发生，让AI落地快人一步". You may not use these trademarks in your
> product name, marketing, documentation, or public promotion unless you obtain
> separate written permission from 未来飞马.

## 相关项目

- `skill-core-guide` — Fmode Harness 平台技能开发规范母技能
- `skill-heterarchy` — 内异层认知协同
- `fmode-loop` — Fmode 交付循环（本库服务层接口的源头）
---

## License

本技能库采用 **Mozilla Public License 2.0**（MPL-2.0）协议发布。
完整协议文本：[Mozilla Public License 2.0](https://mozilla.org/MPL/2.0/)