skill:setup
Dev mode setup для awesome-claude репы — создаёт симлинки skills/, commands/, rules/ в .claude/ напрямую через bash. Идемпотентен: повторный вызов выводит "Already linked". Если .claude/<dir> уже существует как обычная директория — предупреждает и просит подтверждение перед заменой.
- License 许可
- MIT
- 最近更新
- 2026-05-12
- Stars
- ★ 22
- Forks
- 5
01 前言 Front Matter
- name
- skill:setup
- model
- sonnet
- description
- Dev mode setup для awesome-claude репы — создаёт симлинки skills/, commands/, rules/ в .claude/ напрямую через bash. Идемпотентен: повторный вызов выводит "Already linked". Если .claude/<dir> уже существует как обычная директория — предупреждает и просит подтверждение перед заменой.
- allowed-tools
- Bash, Read, AskUserQuestion
02 资源文件 1
- 参考文档cases/setup.md1.5 KB
03 SKILL.md 正文
skill:setup — dev mode симлинки
Шаги
1. Pre-checks
Через Bash проверь что текущая директория — корень awesome-claude (содержит skills/, commands/, rules/):
test -d skills && test -d commands && test -d rules || { echo "ERROR: not in awesome-claude repo root"; exit 1; }
Если нет — остановись с сообщением not in awesome-claude repo root.
2. Create .claude/ if missing
mkdir -p .claude
3. Для каждой из директорий skills, commands, rules — обработать состояние:
for dir in skills commands rules; do
target=".claude/$dir"
source="$(pwd)/$dir"
if [ -L "$target" ]; then
current=$(readlink "$target")
if [ "$current" = "$source" ]; then
echo "$target: Already linked"
continue
fi
echo "$target: symlink points to $current, expected $source"
# ask for confirmation to retarget
elif [ -e "$target" ]; then
echo "WARNING: $target exists as a real directory — will be replaced"
# ask for confirmation
fi
done
4. Confirmation для замены реальной директории
Если на шаге 3 обнаружена реальная директория или симлинк на другой источник — вызови AskUserQuestion:
.claude/<dir> exists as <real directory | symlink to other path>. Replace with symlink to $(pwd)/<dir>?
Options: Replace | Skip | Abort all
При Abort all — остановись без изменений.
5. Создать симлинки
Для каждого <dir> который требует обновления:
ln -sfn "$(pwd)/<dir>" ".claude/<dir>"
echo "$target: linked → $source"
6. Verify rules index
После создания симлинков проверь, что .claude/rules/index.md существует и содержит YAML-блок с реестром правил:
test -f .claude/rules/index.md || echo "WARN: .claude/rules/index.md not found — rules registry missing"
grep -q '```yaml' .claude/rules/index.md && echo "index.md: registry OK" || echo "WARN: index.md has no YAML block"
Если index.md отсутствует — предупредить пользователя: файл нужно создать вручную или обновить awesome-claude до версии с поддержкой rules-index.
7. Final report
skill:setup completed:
- .claude/skills → $(pwd)/skills [linked|already-linked|skipped]
- .claude/commands → $(pwd)/commands [...]
- .claude/rules → $(pwd)/rules [...]
- .claude/rules/index.md: [registry OK | WARN: missing]
Edits in skills/, commands/, rules/ are now visible to Claude Code without manual copying.
Что скилл НЕ делает
- НЕ устанавливает зависимости (это
skill:deps). - НЕ читает
manifest.yaml. - НЕ запускает другие скиллы.
- НЕ изменяет содержимое
skills/,commands/,rules/— только создаёт симлинки.
04 同仓库更多 Skills
skill:test-skill
Тест одного скилла: несколько кейсов, стабы, семантические проверки. Читает cases/<ns>/<skill>.md, для каждого Case поднимает стаб, запускает скилл в агенте, проверяет contains + semantic.
skill:test-all
Запускает все тесты скиллов. Обнаруживает тест-спеки в .claude/skills/*/*/cases/, запускает каждый через логику test-skill, выводит сводную таблицу, проверяет TDD-coverage матрицу.
skill:release
Финальный шаг контрибьюторского workflow — релиз awesome-claude. Bump-version в manifest.yaml, commit, version tag. Останавливается если working tree не чистый.
skill:onboarding
Guided entry point для контрибьютора awesome-claude. Показывает полный contributor workflow и текущий следующий шаг по состоянию репы. НЕ запускает другие скиллы автоматически — только показывает, что вызвать дальше.
skill:deps
Установка/проверка зависимостей awesome-claude из manifest.yaml: CLI-инструменты из секции tools:, субмодули из repos: через sdd:sync. Read-only по manifest.yaml — никогда не пишет в него (для добавления записей используй ручное редактирование или sdd:repo). Валидирует схему manifest.yaml: ошибка и стоп если отсутствует один из version, tools, repos.
sdd:test
Generate and run check artifacts for a spec. Self-sufficient: MCP preflight, 2-agent generation, автоматически по всем Requirements, auto state transition.