技能系统
Skill System
可扩展的 Agent 技能加载系统，支持 Markdown 技能文件的发现、校验和渐进式加载
子问题
1.技能发现与优先级
2.依赖检查(CLI/ENV)
3.渐进式加载策略
4.frontmatter 元数据解析
5.always-on 技能的上下文预算管理
6.技能创建与打包的标准化流程
7.技能摘要格式选择(XML vs JSON vs Markdown)
各项目的解法1 solutions
Signals
横向对比
| 维度 | FastCode |
|---|---|
| 技能格式 | SKILL.md Markdown 文件 + YAML frontmatter + 嵌套 JSON metadata |
| 发现机制 | 目录约定式扫描，workspace 优先覆盖 builtin 同名技能 |
| 加载策略 | 三级渐进式：元数据摘要(XML)→body(strip frontmatter)→资源(scripts/references/assets) |
| 依赖检查 | shutil.which(bins) + os.environ(env)，不满足标记 unavailable 并展示缺失项 |
| 常驻机制 | always: true 标记，满足依赖的 always 技能全文注入 context |
| 元数据解析 | 零依赖：正则 split frontmatter + json.loads 解析嵌套 metadata 字段 |
最佳实践
1.workspace 技能覆盖 builtin 技能实现自定义扩展
2.frontmatter 中嵌套 JSON 字符串避免引入 YAML 解析库
3.XML 格式摘要比 JSON 更适合 LLM 结构化理解
4.技能目录结构约定(scripts/references/assets)实现关注点分离