Документация
Оптимизатор описаний скиллов
LZMW/skill-description-optimizerФреймворк для систематического анализа и улучшения описаний Claude Skills. Повышает частоту срабатываний и обнаруживаемость с помощью семи техник оптимизации, многоэкспертной системы и двухфазного рабочего процесса.
Установка
terminal
bash
git clone https://github.com/LZMW/skill-description-optimizer.gitREADME
Skill Description Optimizer / 技能描述优化器
Мета-скилл для оптимизации описаний скиллов по стандарту SDS с применением семи ключевых техник.
使用 SDS 标准和七种核心技术优化技能描述的元技能。
Комплексный фреймворк оптимизации, который систематически анализирует и улучшает описания Claude Skills для максимизации частоты срабатываний и обнаруживаемости.
一个全面的优化框架，系统性地分析和改进 Claude 技能描述，以最大化触发率和可发现性。
Содержание / 目录
| English | 中文 |
|---|---|
| Core Features | 核心功能 |
| Technical Highlights | 技术亮点 |
| Quick Start | 快速开始 |
| Optimization Workflow | 优化工作流 |
| Best Practices | 最佳实践 |
| Quality Standards | 质量标准 |
| Contributing | 贡献指南 |
| Acknowledgments | 致谢 |
Ключевые возможности / 核心功能
Двухфазный рабочий процесс оптимизации / 两阶段优化工作流
Фаза 1: Поисковый анализ / 第一阶段：搜索分析
| Описание | 中文 |
|---|---|
Автоматический поиск всех существующих скиллов (директория .claude/skills/) | 自动搜索所有现有技能（.claude/skills/ 目录） |
Извлечение name и description из каждого скилла | 从每个技能中提取 name 和 description |
| Анализ распределения триггерных слов, частоты ключевых слов, количества сценариев и длины символов | 分析触发词分布、关键词频率、场景数量和字符长度 |
| Генерация отчётов с количественными метриками (средние значения, диапазоны, тепловые карты) | 生成定量指标报告（平均值、范围、热力图） |
Фаза 2: Выполнение оптимизации / 第二阶段：优化执行
| Описание | 中文 |
|---|---|
| Оптимизация на основе стандартов SDS и лучших практик | 基于 SDS 标准和最佳实践进行优化 |
| Обнаружение конфликтов: исключение функционального пересечения с существующими группами скиллов | 冲突检测：确保与现有技能群体没有功能重叠 |
| Применение универсальной формулы и пяти основных шаблонов | 应用通用公式和五大模板 |
| Выполнение семи техник оптимизации | 执行七种优化技术 |
Автоматическая генерация/обновление skill-trigger-handbook.md | 自动生成/更新 skill-trigger-handbook.md |
Режим многоэкспертного взаимодействия / 多专家协作模式
Проект использует систему многоэкспертного взаимодействия для обеспечения комплексной и точной оптимизации:
本项目采用多专家协作系统，确保全面和准确的优化：
| Роль | 中文 | Функция |
|---|---|---|
| Аналитик паттернов | 模式分析师 | Анализирует количественные метрики существующих описаний скиллов / 分析现有技能描述的定量指标 |
| Детектор конфликтов | 冲突检测器 | Обнаруживает функциональные пересечения и конфликты триггерных слов / 检测功能重叠和触发词冲突 |
| Архитектор оптимизации | 优化架构师 | Применяет стандарты SDS и семь техник / 应用 SDS 标准和七种技术 |
| Аудитор качества | 质量审计师 | Выполняет строгие проверочные списки качества / 执行严格的质量检查清单 |
Технические особенности / 技术亮点
Стандарт SDS (Skill Description Standard) / SDS 标准（技能描述标准）
| Правило | Требование | Описание |
|---|---|---|
| Формат | Однострочный английский, в кавычках | Обеспечивает корректный системный парсинг |
| Длина | < 1024 символов (рекомендуется 180–330) | Баланс информационной плотности и читаемости |
| Запрещено | Символы < и > | Предотвращает ошибки парсинга |
Универсальная формула / 通用公式
[功能概述] + [触发条件] + [场景列表] + [兜底条款]
[Function Overview] + [Trigger Conditions] + [Scenario List] + [Catch-all Clause]
Пять шаблонов оптимизации / 五大优化模板
| Шаблон | 中文 |
|---|---|
| Тип «Обработка файлов» — Comprehensive X, When Claude needs to work with... | 文件处理类型 - 全面的 X，当 Claude 需要处理... |
| Тип «Инструмент/Тестирование» — Toolkit for X using Y, Supports... | 工具/测试类型 - 使用 Y 的 X 工具包，支持... |
| Тип «Дизайн/Творчество» — Create X with Y, Use this skill when... | 设计/创意类型 - 使用 Y 创建 X，在...时使用此技能 |
| Тип «Мета-скилл/Руководство» — Guide for creating X that Y, Use when... | 元技能/指南类型 - 创建 Y 的 X 的指南，在...时使用 |
| Тип «Платформо-специфичный» — Knowledge and utilities for X optimized for Y... | 平台特定类型 - 针对 Y 优化的 X 知识和实用工具... |
Семь техник оптимизации / 七种优化技术
| Техника | Описание | Эффект |
|---|---|---|
| Нумерованный список | Используйте (1)(2)(3) для чёткого перечисления сценариев | Распознавание сценариев +40% |
| Примеры в скобках | Приводите конкретные примеры | Точность срабатывания +35% |
| Повторение ключевых слов | Ключевые слова встречаются 2–5 раз | Обнаруживаемость +50% |
| Аннотация технологического стека | Указывайте фреймворки в скобках | Повышение профессионализма |
| Страховочная оговорка | Охватывает незаявленные сценарии | Покрытие +60% |
| Негативные ограничения | Указывайте, что не нужно делать | Частота ложных срабатываний −70% |
| Условия исключения | Чётко определяйте неприменимые сценарии | Повышение точности |
Быстрый старт / 快速开始
Предварительные требования / 前置条件
| Требование | 中文 |
|---|---|
| Claude Code CLI с Agent SDK | 带有 Agent SDK 的 Claude Code CLI |
Существующая директория скиллов (.claude/skills/) | 现有技能目录（.claude/skills/） |
| Права доступа к файловой системе (Glob, Read, Grep, Bash, Write) | 文件系统访问权限（Glob、Read、Grep、Bash、Write） |
Установка / 安装
- Клонируйте репозиторий или скопируйте файлы скилла в директорию скиллов:
克隆仓库或将技能文件复制到您的技能目录：
cp -r skill-description-optimizer ~/.claude/skills/
- Проверьте установку:
验证安装：
bash
ls ~/.claude/skills/skill-description-optimizer/
# Should see: SKILL.md, references/best_practices.md
# 应该看到：SKILL.md, references/best_practices.mdПримеры использования / 使用示例
Пример 1: Оптимизация существующего описания / 示例 1：优化现有描述
Входные данные / 输入:
Help me optimize this skill description: 'Tool for creating PDF documents.'
帮我优化这个技能描述：'创建 PDF 文档的工具。'
Результат / 输出:
Фаза 1: Поисковый анализ / 第一阶段：搜索分析
| Описание | 中文 |
|---|---|
| - Обнаружено существующих скиллов: 4 | - 发现现有技能：4 个 |
| - Анализ паттернов триггерных слов: среднее... | - 触发词模式分析：平均... |