wsshow/feikong-teams/fkteams

Name: fkteams
Author: wsshow

Claude Code and agent skill by wsshow/feikong-teams

Trust tier 2

community

Source check pending

Checking that the SKILL.md file is still in the repository.

fkteams 多智能体协作 AI 助手的完整使用指南。当用户需要启动 fkteams、切换工作模式（团队/深度/讨论/自定义）、通过命令行或管道执行查询、管理单个智能体（coder/researcher/fkteams_helper/analyst/remote/generalist）、管理会话历史（保存/加载/导出/恢复）、管理模型配置（添加/切换/删除/登录服务商）、管理本地技能（列出/搜索/安装/移除）、初始化或修改配置文件，以及了解 fkteams 的任意命令行用法时，请使用此 skill。

Install

npx vskill@latest install wsshow/feikong-teams/fkteams

SKILL.md

fkteams 命令行完整指南

一、快速入门

bash

# 第一步：生成配置文件
fkteams generate config
 
# 第二步：编辑配置，添加模型（必填）
# 编辑 ~/.fkteams/config/config.toml，填写 api_key 和 model
 
# 第三步（可选）：安装运行时依赖
fkteams init --all   # 安装 uv（Python）和 bun（JavaScript）
 
# 第四步：启动
fkteams web          # Web 界面（推荐）
fkteams              # CLI 交互模式

二、启动与运行模式

模式对照表

模式	命令	适用场景
Web 界面	`fkteams web`	日常使用，需要历史记录和可视化界面
CLI 交互	`fkteams`	服务器/终端环境
直接查询	`fkteams -q "..."`	脚本集成、自动化
纯 API 服务	`fkteams serve`	作为后端独立部署

Web 界面模式

bash

fkteams web
# 启动后访问 http://localhost:23456

CLI 交互模式

bash

fkteams              # 默认：团队模式（coordinator 协调多智能体）
fkteams -m deep      # 深度分析模式
fkteams -m group     # 多智能体讨论模式（圆桌）
fkteams --temporary  # 临时会话，不保存历史

直接查询模式（非交互，执行后退出）

bash

fkteams -q "帮我审查 main.go"
fkteams -m deep -q "深度分析这个架构"
fkteams -q "生成一份报告"             # 默认保存历史
fkteams -q "临时问答" --temporary     # 不保存历史

管道输入模式

管道有内容时自动进入非交互模式。

bash

echo "解释一下 Go 的 context 包" | fkteams
cat main.go | fkteams -q "审查以下代码:"
git diff HEAD~1 | fkteams -q "审查这次提交"
curl -s https://example.com/api | fkteams -q "解析这个 API 响应"

规则：同时提供 -q 时，查询内容为 -q 文本 + 换行 + 管道内容；管道为空且无 -q 时报错。

纯 API 服务模式

bash

fkteams serve
fkteams serve --host 0.0.0.0 --port 8080

与 web 提供相同的 API，但无前端页面。支持端点：GET /v1/models、POST /v1/chat/completions。

恢复历史会话

bash

fkteams -r "20260302_091249"              # 交互模式恢复
fkteams -r "20260302_091249" -q "继续上次的分析"  # 恢复后直接查询

全局参数

参数	简写	说明
`--mode`	`-m`	工作模式：`team`（默认）/ `deep` / `group`
`--query`	`-q`	直接查询模式，执行后退出
`--resume`	`-r`	恢复指定会话 ID
`--temporary`	`--temp`	临时会话，不保存历史
`--approve`		自动批准工具调用：`all` / `command` / `file` / `git` / `dispatch`（逗号分隔）

三、交互模式内置命令

命令	说明
`quit` / `q`	退出程序
`help`	显示帮助
`list_agents`	列出所有可用智能体
`@智能体名 [查询]`	切换到指定智能体并可选执行查询
`switch_work_mode`	切换工作模式
`save_chat_history`	保存当前会话
`list_chat_history`	列出所有历史会话
`load_chat_history`	选择并加载历史会话
`clear_chat_history`	清空当前会话（不删除文件）
`save_chat_history_to_markdown`	导出为 Markdown
`save_chat_history_to_html`	导出为 HTML
`list_schedule`	列出所有定时任务
`cancel_schedule`	取消定时任务
`delete_schedule`	删除定时任务
`list_memory`	列出长期记忆条目
`delete_memory`	删除记忆条目
`clear_memory`	清空所有长期记忆

四、单智能体模式（`agent` 子命令）

智能体目录

名称	配置项	角色
`coordinator`	`[[agents.items]] id = "coordinator"`	协调者
`coder`	`[[agents.items]] id = "coder"`	软件工程师，代码实现、调试、重构
`researcher`	`[[agents.items]] id = "researcher"`	DuckDuckGo 网络搜索
`fkteams_helper`	`[[agents.items]] id = "fkteams_helper"`	fkteams 安装、配置、扩展与故障排查答疑
`analyst`	`[[agents.items]] id = "analyst"`	数据分析（Excel、Python、文档）
`remote`	`[[agents.items]] id = "remote"` + `ssh = { ... }`	SSH 远程服务器访问
`generalist`	`[[agents.items]] id = "generalist"`	通用执行助手，支持多工具任务

agent 命令用法

bash

# 列出所有可用智能体
fkteams agent list
 
# 交互模式（进入对话）
fkteams agent -n coder
fkteams agent --name analyst
 
# 直接查询（一次性，执行后退出）
fkteams agent -n researcher -q "搜索最新的 Go 语言新闻"
fkteams agent -n coder -q "解释这个函数的作用"
fkteams agent -n fkteams_helper -q "如何配置 MCP？"
 
# 配合管道
cat error.log | fkteams agent -n coder -q "分析这个错误日志"
git diff HEAD~1 | fkteams agent -n coder -q "审查这次提交"
cat data.csv | fkteams agent -n analyst -q "计算基本统计数据"
 
# JSON 原始事件输出（用于程序化处理）
fkteams agent -n researcher -q "搜索 AI 新闻" --format json
 
# 自动批准工具调用
fkteams agent -n shell -q "清理临时文件" --approve all
fkteams agent -n coder -q "重构 main.go" --approve file,command
 
# 临时运行，不保存历史
fkteams agent -n researcher -q "搜索 AI 新闻" --temporary

`agent` 子命令参数

参数	简写	说明
`list`		列出所有可用智能体
`--name`	`-n`	智能体名称（必填，与 list 互斥）
`--query`	`-q`	直接查询模式
`--temporary`	`--temp`	临时会话，不保存历史
`--format`		输出格式：`default`（格式化）或 `json`（原始事件）
`--approve`		自动批准：`all` / `command` / `file` / `git` / `dispatch`

交互模式下，输入 @ 符号后自动显示智能体列表供选择。

五、会话管理（`session` 子命令）

会话文件保存在 ~/.fkteams/sessions/，以时间戳命名（如 20260302_091249）。

bash

# 列出所有历史会话
fkteams session list
 
# 会话默认保存（退出时写入文件）
fkteams
fkteams -q "你的问题"
 
# 恢复历史会话
fkteams -r "20260302_091249"
fkteams -r "20260302_091249" -q "继续上次的问题"

交互模式内：save_chat_history / load_chat_history / clear_chat_history / save_chat_history_to_markdown / save_chat_history_to_html

六、模型管理（`model` 子命令）

bash

# 列出已配置的模型
fkteams model ls       # 或 fkteams model list
 
# 查询服务商的可用模型
fkteams model lr --name deepseek
fkteams model lr --provider openai
 
# 切换默认对话模型（交互式选择）
fkteams model sw
# 指定配置名
fkteams model sw --name deepseek
# 切换到指定模型
fkteams model sw --name deepseek --model deepseek-reasoner
 
# 移除模型配置（交互式选择）
fkteams model rm
fkteams model rm --name old-config

登录服务商（写入 config.toml，无需手动编辑）

bash

fkteams login openai     --api-key sk-...
fkteams login deepseek   --api-key sk-...
fkteams login claude     --api-key sk-ant-...
fkteams login gemini     --api-key AIza...
fkteams login qwen       --api-key sk-...
fkteams login ollama                          # 无需 API Key
fkteams login ark        --api-key ...
fkteams login openrouter --api-key sk-or-...
fkteams login copilot                         # OAuth 设备码流程
fkteams login copilot --import                # 从 VS Code 已保存的 token 导入
fkteams login custom --base-url https://my-proxy.example.com/v1 --api-key sk-...
 
# 通用可选参数
fkteams login openai --api-key sk-... --model gpt-4o --name my-openai
# --name 指定模型 ID；首次登录会自动设为默认对话模型
 
# 退出登录
fkteams logout

七、技能管理（`skill` 子命令）

技能目录：~/.fkteams/skills/<技能名>/，每个技能必须包含 SKILL.md。

bash

# 列出本地已安装的技能
fkteams skill list    # 或 fkteams skill ls
 
# 搜索技能市场（默认后端：SkillHub）
fkteams skill search <关键词>
fkteams skill search ffmpeg --page 2 --size 20
fkteams skill search ffmpeg --provider SkillHub
 
# 安装技能
fkteams skill install <技能slug>
fkteams skill install video-frames --version 1.0.0
fkteams skill install video-frames --provider SkillHub
 
# 移除技能
fkteams skill remove <技能slug>

八、配置与初始化（`generate` / `init` 子命令）

bash

# 生成示例配置文件（首次使用必须执行）
fkteams generate config
# 生成路径：~/.fkteams/config/config.toml
 
# 生成 OpenAI 兼容 API 密钥
fkteams generate apikey
 
# 初始化运行时依赖
fkteams init           # 交互式选择
fkteams init --all     # 安装全部（uv + bun）
fkteams init --env uv  # 仅安装 uv（Python 脚本工具）
fkteams init --env bun # 仅安装 bun（JS 脚本工具）
fkteams init --mirror  # 生成镜像源配置（国内加速）

关键配置项

toml

# 模型（必填）
[[models]]
name     = "default"
provider = "openai"
base_url = "https://api.openai.com/v1"
api_key  = "sk-..."
model    = "gpt-4o"
 
# 智能体目录
[[agents.items]]
id = "researcher"
name = "研究员"
description = "网络研究员"
tools = ["search", "fetch"]
enabled = true
 
[[agents.items]]
id = "remote-prod"
name = "生产服务器"
description = "通过 SSH 管理生产服务器"
tools = ["ssh"]
ssh = { host = "ip:port", username = "user", password = "pass", known_hosts_file = "~/.ssh/known_hosts" }
enabled = true
 
# 长期记忆
[memory]
enabled = true
 
# Web 服务器
[server]
port = 23456
 
# OpenAI 兼容 API（需要先 fkteams generate apikey）
[openai_api]
api_keys = ["sk-fkteams-your-secret"]

环境变量

变量	默认值	说明
`FEIKONG_APP_DIR`	`~/.fkteams`	应用数据目录
`FEIKONG_PROXY_URL`	—	代理地址（唯一的代理配置方式）
`FEIKONG_MAX_ITERATIONS`	`60`	智能体最大迭代次数（0/-1 不限制）

九、其他子命令

bash

# 检查并更新 fkteams 到最新版本
fkteams update
 
# 列出所有可用工具
fkteams tool list
 
# 显示版本
fkteams --version

十、常见问题（Gotchas）

会话默认保存：退出时会自动写入历史；临时任务可加 --temporary，额外导出可在交互中执行 save_chat_history_to_html 或 save_chat_history_to_markdown。
管道触发非交互模式：哪怕管道为空也会触发，空管道 + 无 -q 会报错。
`fkteams web` vs `fkteams serve`：web 包含前端页面；serve 仅提供 API，无界面。
首次使用需先生成配置：运行 fkteams generate config 后再启动，否则报错。
可选智能体需先在配置中启用：调用未启用的智能体会返回错误。
代理只能通过环境变量设置：config.toml 中没有代理配置项，只用 FEIKONG_PROXY_URL。
`model sw` 只切换默认，不删除配置：要删除用 model rm。
技能安装后需重启 fkteams 才生效：技能在启动时加载，热安装不生效。
`[openai_api]` 不配置 `api_keys` 时所有 API 请求返回 401。

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingdocs/skills/fkteams/SKILL.md

Popularity

Repository stars: 149
Repository forks: 32
7-day trend score: 25

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 17 May 2026, 5 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/wsshow/feikong-teams/fkteams/badge)](https://verified-skill.com/skills/wsshow/feikong-teams/fkteams)

Something wrong with this skill or its page? Tell us.

Install

SKILL.md

fkteams 命令行完整指南

一、快速入门

二、启动与运行模式

模式对照表

Web 界面模式

CLI 交互模式

直接查询模式（非交互，执行后退出）

管道输入模式

纯 API 服务模式

恢复历史会话

全局参数

三、交互模式内置命令

四、单智能体模式（agent 子命令）

智能体目录

agent 命令用法

agent 子命令参数

五、会话管理（session 子命令）

六、模型管理（model 子命令）

登录服务商（写入 config.toml，无需手动编辑）

七、技能管理（skill 子命令）

八、配置与初始化（generate / init 子命令）

关键配置项

环境变量

九、其他子命令

十、常见问题（Gotchas）

Security

Quality evaluation

Source

Popularity

Works with

四、单智能体模式（`agent` 子命令）

`agent` 子命令参数

五、会话管理（`session` 子命令）

六、模型管理（`model` 子命令）

七、技能管理（`skill` 子命令）

八、配置与初始化（`generate` / `init` 子命令）