Skill扩展系统
Skill Extension System
插件化技能注册与执行系统,支持装饰器注册、超时保护和批量执行
子问题
1.技能注册与发现
2.超时保护
3.技能依赖管理
4.批量执行编排
5.方法论技能的主题匹配与 fallback 策略
6.声明式技能的 YAML frontmatter 解析与目录发现
7.环境变量门控的分层启停控制
各项目的解法1 solutions
Signals
横向对比
| 维度 | vibe-blog |
|---|---|
| 注册方式 | 双层:@register 装饰器(代码技能)+ SKILL.md YAML frontmatter(方法论技能) |
| 执行模型 | ThreadPoolExecutor 单线程隔离执行,per-skill 超时配置 |
| 技能分类 | 后处理衍生物(mindmap/flashcard/study_note)+ 写作方法论(deep-research/tech-tutorial) |
| 扩展机制 | 代码技能:新建 .py + @register;方法论技能:新建 SKILL.md 目录 |
| 超时保护 | ThreadPoolExecutor + future.result(timeout=defn.timeout),每技能独立配置 |
| 批量执行 | execute_batch 顺序执行,逐个 try-catch 隔离失败 |
最佳实践
1.@register装饰器简化技能注册
2.统一执行器封装超时和错误处理
3.SKILL.md(YAML frontmatter + Markdown 正文)让非开发者维护方法论技能
4.导入即注册:Python 模块导入副作用触发装饰器,无需显式注册调用
5.public/custom 双目录分类支持内置与用户自定义技能共存