Управление с умения: откриване, активиране и приоритет
На тази страница
Урокът е актуализиран на 2 ноември 2026 г. въз основа на страницата Skills от документацията на Vibe: добавени са местоположенията
.agents/skills/, официалният ред на откриване (персонализирани пътища, проект, потребител) и командата/reload. Документацията не дефинира правило за приоритет при две умения с едно и също име; предишната версия описваше такова. Източник: Skills.
Как Vibe открива уменията
Да напишете умение е едно; да знаете кое всъщност се изпълнява, е съвсем друго. Документацията уточнява реда, по който Vibe открива уменията:
- Персонализирани пътища, декларирани във
config.tomlчрезskill_paths; - Проектни умения, разположени в
./.vibe/skills/или./.agents/skills/, зареждани само ако папката е надеждна; - Потребителски умения, разположени в
~/.vibe/skills/или~/.agents/skills/.
Папките .agents/skills/ следват отворената спецификация за умения на агенти (Agent Skills): умение, съхранено там, се споделя с други агенти, които приемат същата спецификация. Активната сесия открива добавени или променени умения; ако промяната не се появи, въведете /reload.
Структура на директорията с умения
Глобалните умения се намират във Вашата домашна директория, всяко в своя собствена папка, съдържаща SKILL.md. Те са достъпни навсякъде, във всеки проект, където стартирате Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Локалните умения, от друга страна, се версионират заедно с кода на проекта. Това е естественото място за умение за внедряване или миграция, което зависи от точната инфраструктура на хранилището и няма смисъл на друго място.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Накрая, съществуват персонализирани пътища, използвани за препращане към умения, разположени на други места във Вашата система. Вие декларирате тези пътища в конфигурацията:
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
Това е предпочитаният механизъм за споделяне на умения в рамките на екип, чрез мрежова папка или клонирано Git хранилище, което всеки актуализира от своя страна.
Активиране и деактивиране на умения
По подразбиране всички открити умения са активни. Две симетрични настройки Ви позволяват да поемете контрол. Чрез enabled_skills преминавате към бял списък: активни са само изброените умения; всички останали се игнорират.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Чрез disabled_skills оставате на черен списък: всички умения са активни, с изключение на посочените от Вас. Това е правилният избор, когато едно единствено умение временно Ви пречи.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Шаблони за филтриране
И двете полета приемат три форми на входни данни. Най-простата е точното име, което работи, стига списъкът да остане кратък:
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Шаблоните с глобове (glob patterns) поемат контрола, щом имената Ви следват определена конвенция. Символът * съвпада с всяка последователност от знаци, позволявайки Ви да обработите цяло семейство с един ред:
# Активиране на всички умения, започващи с "test-"
enabled_skills = ["test-*"]
# Деактивиране на всички експериментални умения
disabled_skills = ["experimental-*", "beta-*"]
За случаи, които глобовете не покриват – алтернатива, шаблон в средата на името, числов суфикс – поставете префикса re: преди израза, за да използвате регулярен израз:
# Активиране на умения, чието име съдържа "review" или "audit"
enabled_skills = ["re:review|audit"]
# Деактивиране на версионирани умения (напр. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # буквализиран низ: обратната наклонена черта не нуждае от екраниране
Две умения с едно и също име
Документацията не описва правило за приоритет при две умения с едно и също име в различни местоположения. Затова не разчитайте на имплицитно “презаписване”: дайте им различни имена (code-review-backend вместо второ code-review) и проверете какво всъщност се зарежда. В менюто /, описанието на всяко умение започва с неговия обхват: project, user или vibe, което е достатъчно, за да откриете дубликат. Умение, наименувано като вградена команда, не се появява в това меню.
Конфигурация на ниво проект
Всички тези настройки се комбинират във файл .vibe/config.toml, разположен в корена на проекта. Примерът по-долу показва трите лоста заедно: ограничаване на списъка до релевантни умения, изключване на тези, които не са, и добавяне на споделената папка на бекенд екипа.
# mon-projet/.vibe/config.toml
# Активиране само на умения, релевантни за този проект
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Или деактивиране на тези, които не са релевантни
disabled_skills = ["doc-writer"]
# Добавяне на допълнителни пътища
skill_paths = ["/home/equipe/backend-skills"]
За да проверите кои умения са действително налични, отворете менюто / в сесията: всяко умение се появява там със своя обхват. Това е първият рефлекс, когато очаквана slash команда липсва, преди да опитате /reload и да проверите статуса на доверие на папката.
Ключови изводи
- Vibe открива умения в
~/.vibe/skills/,.vibe/skills/и персонализираниskill_paths - Локалните умения имат приоритет пред глобалните умения
- Използвайте
enabled_skillsилиdisabled_skills, за да контролирате активирането - Шаблоните с глобове (
test-*) и регулярните изрази (re:review|audit) опростяват филтрирането - Създайте
.vibe/config.tomlза всеки проект, за да персонализирате контекста - Споделяйте умения в екипа чрез
skill_paths, сочещи към обща папка