Agent Skills

// Skills — агент знает, как готовить
// Tools — агент умеет пользоваться ножом и плитой
// MCP — стандартная розетка для подключения приборов

// Skill: знание рецепта
const skill = {
  name: "italian-cuisine",
  instructions: "Для пасты: вскипятить воду, добавить соль...",
}

// Tool: умение (функция, которую вызывает LLM)
const tool = {
  type: "function",
  function: {
    name: "boil_water",
    description: "Кипятит воду",
    parameters: { type: "object", properties: { temp: { type: "number" } } },
  },
}

// MCP: стандартный способ подключить термометр
// GET /tools/boil_water → JSON-RPC с описанием инструмента

---
name: code-reviewer
description: Проверяет код на соответствие стандартам и best practices
allowed-tools: [read_file, search_code, bash]
---

# Code Reviewer Skill

## Responsibilities
- Проверять код на ошибки, уязвимости и несоответствия стилю
- Предлагать конкретные исправления с примерами кода
- Указывать на потенциальные проблемы производительности

## Workflow
1. Прочитать файл, который нужно проверить
2. Определить язык и фреймворк
3. Проверить:
   - Синтаксические ошибки
   - Утечки памяти и ресурсов
   - Соответствие code style проекта
4. Сформировать отчёт с приоритетами:
   - 🔴 Critical — необходимо исправить
   - 🟡 Warning — рекомендуется исправить
   - 🔵 Suggestion — предложение по улучшению
5. Предложить код исправления для каждого замечания

## Related Files
- See ./standards.md for project-specific code style
- See ./security-checklist.md for security review

// 1. Агент сканирует файловую систему в поиске SKILL.md
async function discoverSkills(skillsDir: string): Promise<SkillMeta[]> {
  const entries = await fs.readdir(skillsDir, { withFileTypes: true })
  const skills: SkillMeta[] = []

  for (const entry of entries) {
    if (!entry.isDirectory()) continue
    const skillPath = path.join(skillsDir, entry.name, "SKILL.md")
    if (!await exists(skillPath)) continue

    const content = await fs.readFile(skillPath, "utf-8")
    const meta = parseFrontmatter(content)
    skills.push({
      name: meta.name,
      description: meta.description,
      path: skillPath,
    })
  }
  return skills
}

// 2. Агент выбирает подходящий скил по запросу пользователя
function matchSkills(query: string, skills: SkillMeta[]): SkillMeta[] {
  return skills
    .map(s => ({ skill: s, score: similarity(query, s.description) }))
    .filter(s => s.score > 0.3)
    .sort((a, b) => b.score - a.score)
    .map(s => s.skill)
}

// 3. Агент загружает инструкции скила (L1)
async function loadSkill(skill: SkillMeta): Promise<string> {
  const content = await fs.readFile(skill.path, "utf-8")
  return stripFrontmatter(content) // только тело SKILL.md
}

// 4. При необходимости — подгружает ресурсы (L2) и запускает скрипты (L3)
async function loadL2Resource(skillDir: string, name: string) {
  return fs.readFile(path.join(skillDir, name), "utf-8")
}

interface Skill {
  name: string
  description: string
  load(): Promise<string>      // L1: инструкции
  readResource(name: string): Promise<string>  // L2: справочники
  runScript(name: string): Promise<string>      // L3: скрипты
}

class Agent {
  private skills: Map<string, Skill> = new Map()

  registerSkill(skill: Skill) {
    this.skills.set(skill.name, skill)
  }

  async findAndExecute(query: string, task: string) {
    // Найти подходящий скил
    const matches = Array.from(this.skills.values())
      .filter(s => query.includes(s.name))

    if (matches.length === 0) {
      return "Нет подходящего скила"
    }

    // Загрузить инструкции (L1)
    const instructions = await matches[0].load()
    console.log("Загружены инструкции:", instructions)

    // Выполнить задачу, следуя инструкциям скила
    return executeWithInstructions(matches[0], task)
  }
}

// Пример: регистрируем скилы
const agent = new Agent()
agent.registerSkill({
  name: "code-reviewer",
  description: "Проверяет код на ошибки и стиль",
  load: () => loadSkillFile("code-reviewer"),
  readResource: (name) => loadResource("code-reviewer", name),
  runScript: (name) => runBash("code-reviewer", name),
})