# linux-at-spi2

Скилл linux-at-spi2 для агента, который нажимает кнопки в GTK- и Qt-приложениях на Linux через AT-SPI2 и D-Bus, с блокировкой полей паролей и журналом операций.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 190 установок · ★ 48 у репозитория
- Автор: martinholovsky
- Лицензия: Unlicense · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/linux-at-spi2/SKILL.md
- Обновлён: 2025-12-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/linux-at-spi2

## Что делает

Скилл даёт агенту рабочие шаблоны для AT-SPI2 — слоя доступности Linux, через который GTK- и Qt-приложения отдают дерево объектов по D-Bus. Внутри обёртка `SecureATSPI`, поиск элементов с ограничением по времени и глубине, монитор событий. Агент получает маршрут от рабочего стола `Atspi.get_desktop(0)` до нужного узла и способ вызвать у него действие.

С действиями есть нюанс. Обёртка по умолчанию создаётся в тире `read-only`, и нажатие в нём не пройдёт: клики открываются только на тире `standard`. Терминалы вроде `gnome-terminal` и `konsole`, менеджеры паролей и узлы с ролью `PASSWORD_TEXT` лежат в списках блокировок, а имена со словами password, secret или token возвращаются как `[REDACTED]`.

Для запуска нужны Python-привязки: `pyatspi2` либо `gi.repository.Atspi`, плюс `dbus-python`. Обращения идут через сессионную шину, на вызов ставится таймаут 5000 мс.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill linux-at-spi2 -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/linux-at-spi2/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/linux-at-spi2/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill linux-at-spi2 -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/linux-at-spi2/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill linux-at-spi2 -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/linux-at-spi2/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install martinholovsky/claude-skills-generator skills/linux-at-spi2
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/linux-at-spi2/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill linux-at-spi2 -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/martinholovsky/claude-skills-generator --path skills/linux-at-spi2
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/linux-at-spi2/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill linux-at-spi2 -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/linux-at-spi2/SKILL.md

## Когда брать
- обойти дерево доступности окна и собрать список кнопок с именами
- нажать элемент в Qt-приложении без координат и xdotool
- подписаться на смену фокуса и активацию окон
- не пустить автоматизацию в менеджер паролей и терминал
- уложить обход большого дерева в таймаут

## Примеры запросов агенту
- Обойди дерево доступности активного окна и собери имена всех кнопок через `pyatspi2`.
- Сделай обёртку на `SecureATSPI`, которая отклоняет обращения к `gnome-terminal` и пишет журнал в `atspi.security`.
- Подпишись на события `object:state-changed:focused` и `window:activate` и логируй, когда меняется фокус.

## Похожие
- [linux-lateral-movement](https://affpapa.org/nevibecode/skills/linux-lateral-movement.md) — скилл · 3900 установок
- [Ghost](https://affpapa.org/nevibecode/mcp/ghost.md) — MCP-сервер · ★ 28 у репозитория
- [debian-linux-triage](https://affpapa.org/nevibecode/skills/debian-linux-triage.md) — скилл · 9197 установок
- [fedora-linux-triage](https://affpapa.org/nevibecode/skills/fedora-linux-triage.md) — скилл · 8800 установок
- [linux-hardening](https://affpapa.org/nevibecode/skills/linux-hardening.md) — скилл · 890 установок
- [linux-kernel-modules](https://affpapa.org/nevibecode/skills/linux-kernel-modules.md) — скилл · 733 установки

Из того же набора: [martinholovsky/claude-skills-generator](https://affpapa.org/nevibecode/by/martinholovsky/claude-skills-generator.md) — 50 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
