Skills 机制

基于 Claude Skills 标准的三层渐进式披露架构。

快速开始

import { SkillRegistry, createSkillActivationTool, buildSkillsSystemPrompt } from '@loom-node/skills';

// 初始化
const registry = new SkillRegistry();
await registry.scanDirectory('./skills');

// 生成系统提示词
const systemPrompt = buildSkillsSystemPrompt(registry);

// 注册激活工具
const skillTool = createSkillActivationTool(registry);

架构

Layer 1: Discovery (启动时)

• 扫描 SKILL.md frontmatter
• 提取 name + description
• 成本: ~50 tokens/skill

Layer 2: Activation (运行时)

• LLM 语义匹配
• 调用 activate_skill 工具
• 加载完整 SKILL.md
• 成本: ~500-2000 tokens/skill

Layer 3: Execution (按需)

• SKILL.md 指令驱动
• LLM 调用 read_file/bash
• 懒加载 scripts/references/assets

技能目录结构

my-skill/
├── SKILL.md           # 必需
├── scripts/           # 可选
├── references/        # 可选
└── assets/            # 可选

SKILL.md 格式

---
name: my-skill
description: Skill description for semantic matching
allowed-tools: read_file, write_file, bash
---

# Skill Instructions

Detailed instructions here...

文档

• REDESIGN.md - 完整设计方案
• MIGRATION.md - 迁移指南
• IMPLEMENTATION.md - 实现总结
• examples/ - 示例技能