Agent skill

Funboost Troubleshooting

当使用 funboost 遇到错误、消费不正常、进程退出等问题时使用。触发场景：消费者不启动、消息不消费、进程卡死、event loop 报错、日志不输出、PYTHONPATH 问题、Ctrl+C 无法退出。关键词：troubleshooting, FAQ, 排错, 调试, PYTHONPATH, runforever, Ctrl+C, event loop, 日志。

No licenceAuto-check passedDevelopment

Install Funboost Troubleshooting

skills CLI

$ npx skills add ydf0509/funboost --skill funboost-troubleshooting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install ydf0509/funboost funboost-troubleshooting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/ydf0509/funboost.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/funboost-troubleshooting .claude/skills/funboost-troubleshooting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "funboost-troubleshooting" agent skill from https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting into .claude/skills/funboost-troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "funboost-troubleshooting", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ydf0509/funboost --skill funboost-troubleshooting -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ydf0509/funboost funboost-troubleshooting --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ydf0509/funboost.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/funboost-troubleshooting .agents/skills/funboost-troubleshooting && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "funboost-troubleshooting" agent skill from https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting into .agents/skills/funboost-troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "funboost-troubleshooting", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ydf0509/funboost --skill funboost-troubleshooting -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ydf0509/funboost funboost-troubleshooting --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ydf0509/funboost.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/funboost-troubleshooting .cursor/skills/funboost-troubleshooting && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "funboost-troubleshooting" agent skill from https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting into .cursor/skills/funboost-troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "funboost-troubleshooting", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ydf0509/funboost.git --path .agents/skills/funboost-troubleshooting

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ydf0509/funboost --skill funboost-troubleshooting -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ydf0509/funboost funboost-troubleshooting --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ydf0509/funboost.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/funboost-troubleshooting .gemini/skills/funboost-troubleshooting && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "funboost-troubleshooting" agent skill from https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting into .gemini/skills/funboost-troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "funboost-troubleshooting", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ydf0509/funboost funboost-troubleshooting

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ydf0509/funboost --skill funboost-troubleshooting -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ydf0509/funboost.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/funboost-troubleshooting .github/skills/funboost-troubleshooting && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "funboost-troubleshooting" agent skill from https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting into .github/skills/funboost-troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "funboost-troubleshooting", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ydf0509/funboost --skill funboost-troubleshooting -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ydf0509/funboost funboost-troubleshooting --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ydf0509/funboost.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/funboost-troubleshooting .opencode/skills/funboost-troubleshooting && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "funboost-troubleshooting" agent skill from https://github.com/ydf0509/funboost/tree/master/.agents/skills/funboost-troubleshooting into .opencode/skills/funboost-troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "funboost-troubleshooting", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: funboost-troubleshooting
GitHub stars: 892
Token cost: ~2.2k tokens
SKILL.md length: 561 words
Files: 1
Skills in repo: 19
Repo updated: Aug 11, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Works in 8 steps: Windows 下 Ctrl+C 为什么无法退出程序 → PYTHONPATH 和配置文件找不到 → 消费者不消费 → …
Tasks that involve Async programming
SKILL.md covers 概述, 1. Windows 下 Ctrl+C 为什么无法退出程序, 2. PYTHONPATH 和配置文件找不到 and 3. 消费者不消费, plus 5 more sections
Calls python and python3

What it does

Funboost Troubleshooting is an agent skill from ydf0509/funboost. 当使用 funboost 遇到错误、消费不正常、进程退出等问题时使用。触发场景：消费者不启动、消息不消费、进程卡死、event loop 报错、日志不输出、PYTHONPATH 问题、Ctrl+C 无法退出。关键词：troubleshooting, FAQ, 排错, 调试, PYTHONPATH, runforever, Ctrl+C, event loop, 日志。

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Async programming and Help center and FAQ content. The repository describes itself as: pip install funboost，python全功能分布式函数调度框架,funboost的功能是全面性重量级，用户能想得到的功能99%全都有;funboost的使用方式是轻量级，只有@boost一行代码需要写。支持python所有类型的并发模式和一切知名消息队列中间件，支持如 celery…

When your agent uses it

Tasks that involve Async programming
Tasks that involve Help center and FAQ content

Example prompts

“/funboost-troubleshooting”

Requirements

Python 3

Workflow steps

8 steps, taken from the step headings in SKILL.md.

Windows 下 Ctrl+C 为什么无法退出程序
PYTHONPATH 和配置文件找不到
消费者不消费
Event loop 报错
日志不输出 / 找不到日志文件
安装依赖冲突
AI agent 运行 funboost 脚本注意事项
常见错误信息 → 解决方案对照表

What it can do on your machine

Read from SKILL.md and the folder at commit 2b866e5. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Funboost Troubleshooting loads about 2.2k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 561 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~53
When it runs · the whole SKILL.md, loaded when a task matches: ~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 561 words (~2,249 tokens).

“本 skill 面向用户和 AI agent，在 funboost 运行异常时按症状快速定位原因。”

— opening of SKILL.md by ydf0509

name: funboost-troubleshooting

Outline of SKILL.md

Funboost 故障排查
概述
1. Windows 下 Ctrl+C 为什么无法退出程序
2. PYTHONPATH 和配置文件找不到
2.1 为什么必须设置
2.2 设置方式
2.3 配置加载优先级
2.4 常见错误
3. 消费者不消费
4. Event loop 报错
4.1 RuntimeError: This event loop is already running
4.2 attached to a different loop / aiohttp 连接池报错
4.3 在 FastAPI / 已有 event loop 中阻塞
4.4 ASYNC 模式内写同步阻塞代码
5. 日志不输出 / 找不到日志文件
5.1 日志位置
5.2 BoosterParams 日志相关字段
5.4 AI agent 捕获输出（推荐）
5.5 排查清单
6. 安装依赖冲突
6.1 总体原则（FAQ 10.0）
6.2 pydantic
6.3 pywin32（仅 Windows）
6.5 SQLite 队列 read-only（Linux/macOS）
7. AI agent 运行 funboost 脚本注意事项
7.1 必须设置 PYTHONPATH
7.2 消费脚本不会自动退出
7.3 超时 / sleep 时间估算
7.4 禁止行为
8. 常见错误信息 → 解决方案对照表

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/funboost-troubleshooting of ydf0509/funboost.

Open the folder on GitHubat commit 2b866e5

Compare with similar skills

Funboost Troubleshooting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Funboost Troubleshooting compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Funboost Troubleshooting this skillydf0509/funboost	892	—	~2.2k	Automated safety check: Pass	None	1 mo ago
Modern Csharp Coding Standardssketch7/FluentlyHttpClient	121	3 repos	~2.7k	Automated safety check: Pass	MIT	20 days ago
Akka.NET Best PracticesAaronontheweb/dotnet-skills	1.2k	1 repos	~3.3k	Automated safety check: Pass	MIT	21 days ago
Windmill Rust Backend Patternswindmill-labs/windmill	18k	—	~869	Automated safety check: Pass	Custom licence	yesterday
Pre PR AblationPopupMaker/Popup-Maker	110	—	~2.5k	Automated safety check: Pass	None	3 days ago
Documentation Guidejmfederico/pi-web	866	—	~1.7k	Automated safety check: Pass	MIT	2 days ago

Similar skills

Modern Csharp Coding Standards
sketch7/FluentlyHttpClient
Write modern, high-performance C code using records, pattern matching, value objects, async/await, Span<T/Memory<T, and best-practice API design patterns.
121 GitHub starsUsed in 3 repos~2.7k tokens
DevelopmentAuto-check passed
Akka.NET Best Practices
Aaronontheweb/dotnet-skills
Guidance for Akka.NET actor systems covering EventStream versus DistributedPubSub, supervision, Props versus DependencyResolver, work distribution and testable cluster code.
1.2k GitHub starsUsed in 1 repo~3.3k tokens
DevelopmentAuto-check passed
Windmill Rust Backend Patterns
windmill-labs/windmill
Sets Rust conventions for the Windmill backend: error types, SQLx queries, JSON handling, async rules, module layout and rust-analyzer navigation.
18k GitHub stars~869 tokensUpdated yesterday
DevelopmentAuto-check passed
Pre PR Ablation
PopupMaker/Popup-Maker
Use before finalizing or opening/updating a PR for non-trivial code changes, especially third-party integrations, compatibility layers, hooks and filters, lifecycle code, providers, abstractions…
110 GitHub stars~2.5k tokensUpdated 3 days ago
DevelopmentAuto-check passed
Documentation Guide
jmfederico/pi-web
Repository documentation placement and writing guidance. An agent skill from jmfederico/pi-web.
866 GitHub stars~1.7k tokensUpdated 2 days ago
DevelopmentAuto-check passed
Repository Governance Lifecycle
Arenukvern/mcp_flutter
Master orchestration for repository governance, North Star impact, sub-Star boundaries, and repair-first or evidence-first drift checks.
386 GitHub stars~1.5k tokensUpdated 5 days ago
DevelopmentAuto-check passed

More from ydf0509/funboost

All 19 skills in this repo

Funboost Multi Consumer Startup
ydf0509/funboost
当需要在 funboost 中连续启动多个函数消费（多个消费者同时运行）时使用。触发场景：一个脚本里同时跑多个 @boost 任务函数的消费、为不同队列启动多个消费者。关键词：连续启动, 多个消费者, consume, multi consume, 同时消费, 启动多个, 多个队列消费。
892 GitHub stars~502 tokensUpdated 1 mo ago
Auto-check passed
Developing Funboost Broker
ydf0509/funboost
当需要为 funboost 框架添加新的消息中间件时使用。触发场景：实现自定义 Publisher/Consumer 类、使用 registercustombroker 注册新 broker、使用 overridecls 定制现有 broker 行为。关键词：new broker, AbstractPublisher, AbstractConsumer…
892 GitHub stars~1.7k tokensUpdated 1 mo ago
Auto-check passed
Developing Funboost Mixin
ydf0509/funboost
当需要为 funboost 创建 Consumer 或 Publisher 的 Mixin 扩展类时使用。触发场景：添加监控、熔断、限流、链路追踪等横切关注点，编写自定义前置/后置处理钩子。关键词：mixin, consumeroverridecls, publisheroverridecls, ConsumerMixin, 自定义消费者, hook, 拦截器, 熔断器, 监控…
892 GitHub stars~2.1k tokensUpdated 1 mo ago
Auto-check passed
Developing Funboost Testing
ydf0509/funboost
当需要为 funboost 框架编写测试、运行测试脚本、或验证新 broker/mixin 实现时使用。触发场景：编写测试脚本、验证消费者/发布者功能、AI Agent 运行 funboost 脚本。关键词：test funboost, 写测试, 运行测试, testframe, regression test, 验证消费, AI testing, os.exit, timeout。
892 GitHub stars~1.5k tokensUpdated 1 mo ago
Auto-check passed
Funboost Advanced Retry
ydf0509/funboost
当需要配置 funboost 的高级重试策略时使用。触发场景：指数退避重试、死信队列、熔断器、任务去重过滤、自定义错误处理。关键词：retry, maxretrytimes, dead letter, DLX, exponential backoff, circuit breaker, isusingadvancedretry…
892 GitHub stars~1.6k tokensUpdated 1 mo ago
Auto-check passed
Funboost Async Programming
ydf0509/funboost
当需要在 funboost 中使用异步（async/await）编程时使用。触发场景：async def 消费函数、aiopush/aiopublish、concurrentmode=ASYNC、event loop 报错。关键词：async, await, asyncio, aiopush, aiopublish, ConcurrentModeEnum.ASYNC, 异步消费, 协程。
892 GitHub stars~3.4k tokensUpdated 1 mo ago
Auto-check passed

Questions about Funboost Troubleshooting

What does Funboost Troubleshooting do?

When should I use Funboost Troubleshooting?

Funboost Troubleshooting fits situations like: tasks that involve Async programming; tasks that involve Help center and FAQ content.

How do I install Funboost Troubleshooting in Claude Code?

Run `npx skills add ydf0509/funboost --skill funboost-troubleshooting -a claude-code`. Or copy the skill folder (.agents/skills/funboost-troubleshooting in ydf0509/funboost) into .claude/skills/funboost-troubleshooting in your project. Claude Code loads it when a task matches its description.

How do I install Funboost Troubleshooting in Codex?

Run `npx skills add ydf0509/funboost --skill funboost-troubleshooting -a codex`. Or copy the skill folder (.agents/skills/funboost-troubleshooting in ydf0509/funboost) into .agents/skills/funboost-troubleshooting in your project. Codex loads it when a task matches its description.

Can I use Funboost Troubleshooting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ydf0509/funboost --skill funboost-troubleshooting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/funboost-troubleshooting, .gemini/skills/funboost-troubleshooting, .github/skills/funboost-troubleshooting and .opencode/skills/funboost-troubleshooting in your project.

What does Funboost Troubleshooting need to run?

Going by SKILL.md and its folder, Funboost Troubleshooting needs the command-line tools its instructions call (python and python3). Our summary lists: Python 3.

Does Funboost Troubleshooting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Funboost Troubleshooting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Funboost Troubleshooting use?

No licence was found for Funboost Troubleshooting or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Funboost Troubleshooting use?

About 2.2k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Funboost Troubleshooting?

Skills that share tags, products or a category with Funboost Troubleshooting: Modern Csharp Coding Standards (sketch7/FluentlyHttpClient, 121 stars), Akka.NET Best Practices (Aaronontheweb/dotnet-skills, 1.2k stars), Windmill Rust Backend Patterns (windmill-labs/windmill, 18k stars) and Pre PR Ablation (PopupMaker/Popup-Maker, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Funboost Troubleshooting?

ydf0509 (a GitHub user) maintains it in ydf0509/funboost, which has 892 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on August 11, 2026.

Source: ydf0509/funboost on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Funboost Troubleshooting

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from ydf0509/funboost

Related

Questions about Funboost Troubleshooting