# public-surface-audit

Скилл ищет приватные токены в отслеживаемых Git-файлах и показывает файл, строку и уровень риска перед публикацией репозитория.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 30
- Автор: chrono-meta
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/chrono-meta/forge-harness/tree/HEAD/plugins/fh-meta/skills/public-surface-audit/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/public-surface-audit

## Что делает

public-surface-audit проверяет только файлы из `git ls-files`: настоящие имена пользователей, абсолютные домашние пути, названия корпоративных ресурсов и приватных хранилищ. Для каждого совпадения он показывает файл, строку, найденный токен и severity. Игнорируемые файлы вроде `CLAUDE.local.md` намеренно не сканируются.

Сканирование объединяет шаблоны из `.claude/rules/.public-surface-patterns.defaults` и приватного `.claude/rules/.public-surface-patterns` либо использует переменную `PSA_PATTERNS`. Allowlist подавляет совпадение только для конкретной пары «файл + токен». Пустой override означает явное отсутствие приватных токенов, а отсутствующий источник шаблонов даёт статус `NOT CONFIGURED`.

Без Git-репозитория скилл завершится до проверки, потому что работает через `git ls-files`. Можно указать путь к репозиторию через `--target <repo path>` или запросить машинный результат с `--json`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill public-surface-audit -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill public-surface-audit -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill public-surface-audit -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install chrono-meta/forge-harness public-surface-audit
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill public-surface-audit -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/chrono-meta/forge-harness --path plugins/fh-meta/skills/public-surface-audit
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill public-surface-audit -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/chrono-meta/forge-harness/tree/HEAD/plugins/fh-meta/skills/public-surface-audit/SKILL.md

## Когда брать
- найти приватные токены в отслеживаемых файлах
- проверить абсолютные пути перед публикацией
- отделить gitignored-файлы от публичной поверхности
- показать строку и severity каждого совпадения
- подавить разрешённые совпадения через allowlist

## Примеры запросов агенту
- Запусти `/public-surface-audit` и проверь публичную поверхность репозитория.
- Проверь другой репозиторий командой `/public-surface-audit --target <repo path>`.
- Дай машинный результат для проверки хуком через `/public-surface-audit --json`.

## Похожие
- [git-guardrails-claude-code](https://affpapa.org/nevibecode/skills/git-guardrails-claude-code.md) — скилл · 499069 установок
- [ponytail-review](https://affpapa.org/nevibecode/skills/ponytail-review.md) — скилл · 57000 установок
- [ponytail-audit](https://affpapa.org/nevibecode/skills/ponytail-audit.md) — скилл · 45400 установок
- [security-audit](https://affpapa.org/nevibecode/skills/cloudflare-security-audit.md) — скилл · 54800 установок
- [security-and-hardening](https://affpapa.org/nevibecode/skills/security-and-hardening.md) — скилл · 70200 установок
- [supabase](https://affpapa.org/nevibecode/skills/supabase.md) — скилл · 8 установок

Из того же набора: [chrono-meta/forge-harness](https://affpapa.org/nevibecode/by/chrono-meta/forge-harness.md) — 40 карточек

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

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