# Skillflux Manager

> 当用户想搜索、安装、更新或管理 SkillFlux 精选 skill 市场内容时触发；通过 SkillFlux MCP 工具完成登录、支付检查、按项目启用 skills。

- Skill: `vc999999999/skillflux-manager` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vc999999999/skillflux-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vc999999999/skillflux-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: vc999999999 (https://skillmd.com/u/vc999999999)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/vc999999999/skillflux-manager

---


# SkillFlux Manager

当用户要求查找或管理 SkillFlux skills 时：

1. 调用 `auth.status` 检查当前设备授权状态。
2. 如果返回 `unauthenticated`，调用 `auth.start`，把登录链接交给用户。
3. 用户完成浏览器登录后，再调用 `auth.status`。
4. 如果返回 `needs_payment`：SkillFlux 是**订阅制**，先问用户要 **monthly 还是 annual**，再用对应 `plan` 调用 `billing.checkout`，把支付链接交给用户。此状态下仍可安装 **free tier** skills；deluxe 需订阅生效后再 `auth.status`。订阅到期或取消后 deluxe 访问会自动失效。
5. 如果返回 `active` 或 `needs_payment`（仅 free skills），根据用户意图调用 `pack.search`、`pack.info`、`skill.install`、`skill.update`、`skill.list`、`skill.remove`、`skill.restore` 或 `doctor`。
6. 精选 skill **始终安装到当前项目**的 `.skillflux/skills/`（project scope）。没有"全局安装 skill"这一说；`skill.install` 不接受 scope 参数。user/global 概念只用于 SkillFlux 自身的 bootstrap（CLI、MCP 配置、manager skill）。
7. 安装或更新完成后，总结本项目已启用的 skills（`skillflux.json` + lockfile），并提示用户刷新 agent 会话。
8. 克隆已有项目或存在 `skillflux.json` 时，优先调用 `skill.restore`（或 CLI `skillflux restore`）恢复声明的 skills；会按 lockfile（`installed.json`）锁定的版本可复现地恢复。

## 核心原则

- 全局只保留 SkillFlux 管理能力（CLI、MCP、manager skill）。
- 具体业务 skills 按项目启用，避免污染全局 agent。
- 多个匹配结果时，先展示 `pack.search` 结果并请用户确认再安装。
- 不要替用户在 agent 内完成登录或支付；只提供浏览器链接。
- 不要保存 token，不要直接拼 API 请求；所有操作通过 MCP 工具完成。

## 运行模式

- **默认连接正式 registry**（`https://skillflux.cn/api`，或 `SKILLFLUX_API_URL`）。用户需登录后按授权使用。
- **本地开发沙盒**：设置 `SKILLFLUX_FIXTURE=1` 时 `auth.status` 返回 `active`，**仅能安装 free tier skills**（如 bundled `demo-skill`）验证链路；deluxe skills 不在 npm 包内、也不会被 fixture 解锁。

安装命令：`npx -y skillflux install`