Przejdź do treści
Biblioteka skilli
Bezpieczeństwo · Przegląd i audyt

deepsec

/deepsec

Konfiguruje i uruchamia przeglądy bezpieczeństwa kodu, szuka luk w repozytoriach i porządkuje kandydatów na podatności.

Repozytorium
deepsec ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
9
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: install.sh

Co robi i kiedy

Konfiguruje i uruchamia przeglądy bezpieczeństwa kodu, szuka luk w repozytoriach i porządkuje kandydatów na podatności.

Oryginalny opis (EN)

Configure, execute, and triage DeepSec deep security reviews on codebases. Use when asked to setup deepsec, run deepsec scans, audit a repository for vulnerabilities, triage security candidates, or configure findings storage.

Jak działa

  1. Invariants
  2. Mode Router
  3. Workflow Steps
  4. Stop Conditions & Fallback Behavior
Sekcje z nagłówków SKILL.md, w oryginale · 104 linii, 657 słów
Podgląd SKILL.md
---
name: deepsec
description: Configure, execute, and triage DeepSec deep security reviews on codebases. Use when asked to setup deepsec, run deepsec scans, audit a repository for vulnerabilities, triage security candidates, or configure findings storage.
user-invocable: true
---

# DeepSec Agentic Skill

Autonomous security review orchestrator providing deterministic candidate scanning, LLM-powered investigation, second-pass false positive revalidation, and priority triage.

## Invariants

1. **Strictly Defensive Perimeter:**
   Zero exploit generation, weaponized payload creation, or offensive shellcode generation. The agent's sole purpose is detection, vulnerability characterization, and remediation guidance.
   *Why this rule exists:* Prevents autonomous execution engines from authoring malicious software or violating safety policies.

2. **Budget & Concurrency Fences:**
   Worker concurrency must not exceed `8`. Maximum expenditure (`max_cost_usd`) must be asserted prior to dispatching AI investigation batches.
   *Why this rule exists:* Prevents runaway recursive AI calls from consuming excessive API tokens or overwhelming local resources.

3. **Two-Pass Verification:**
   Unvalidated regex matches must never be reported as confirmed vulnerabilities. Every candidate must pass through the LLM investigation and secondary revalidation stages before inclusion in the final report.
   *Why this rule exists:* Static regex matchers exhibit high false-positive rates on common variable names and comments.

4. **Non-Destructive Scanning:**
   Target repository files must remain strictly read-only during scanning and triage. Scans must never alter user source code.
   *Why this rule exists:* Guarantees reproducibility and prevents corruption of application state.

---

## Mode Router

Classify user intent into one of four execution modes:

| Mode | Trigger Phrases | Action | Output |
|---|---|---|---|
| `SETUP` | "setup deepsec", "configure deepsec settings" | Detect runtime, generate `.deepsec/config.json` | Validated config file |
| `SCAN` | "run deepsec scan", "scan repository" | Execute regex pre-filter to populate storage | Candidate inventory in `.deepsec/data/<project>/` |
| `INVESTIGATE` | "investigate candidates", "process and revalidate" | Run batched AI analysis and false-positive filter | Confirmed findings in `.deepsec/data/<project>/` |
| `REPORT` | "triage findings", "export deepsec report" | Compute P0/P1/P2 scores, render markdown table | `REPORT.md` and terminal summary |

---

## Workflow Steps

### Step 1: Detect Runner (`freedom: low`)

Execute runtime detection to select native binary vs Node.js fallback:

```bash
skills/deepsec/scripts/detect-runtime.sh
```

- If `native` (`bk deepsec`): Use zero-dependency compiled binary.
- If `node` (`npx deepsec`): Use Node.js runtime.
- If no runner detected: Offer automated native compilation (`cargo build --release`) or inform the user.
- Reference: [Runner Comparison](references/runner-comparison.md)

### Step 2: Configure Engine (`freedom: low`)

Ensure `.deepsec/config.json` exists and satisfies budget constraints:

```bash
skills/deepsec/scripts/validate-config.sh .deepsec/config.json
```

- If missing, copy template from `assets/config.template.json` to `.deepsec/config.json`.
- Set `concurrency` between `1` and `8` (default: `4`).
- Assert `max_cost_usd` is positive (default: `5.0`).
- Reference: [Configuration Reference](references/configuration.md)

### Step 3: Candidate Scanning (`freedom: low`)

Run the pre-filter candidate extraction over target repository paths:

- Native: `bk deepsec scan --dir .`
- Node fallback: `npx deepsec scan`

Validates that `.deepsec/data/<project>/` contains populated `FileRecord` JSON objects with discovered candidate regex matches.

### Step 4: Batched AI Investigation & Revalidation (`freedom: medium`)

Dispatch candidate batches to the configured LLM:

- Native: `bk deepsec process --project <project_id> && bk deepsec revalidate --project <project_id>`
- Node fallback: `npx deepsec process`

Workers evaluate source context, rule criteria, and sanitize false positives. If the spend limit is reached, workers halt immediately with status saved to disk.

### Step 5: Triage & Report Generation (`freedom: medium`)

Compute deterministic priority tiers (`P0`, `P1`, `P2`) and emit structured findings:

- Native: `bk deepsec triage --project <project_id> && bk deepsec report --project <project_id>`
- Node fallback: `npx deepsec report`

Report format:
- Summary table categorized by Priority (`P0` / `P1` / `P2`).
- Detailed finding cards containing: Finding ID, CWE, affected file and line number, verified risk scenario, and recommended fix.
- Reference: [Triage Matrix](references/triage-matrix.md)

---

## Stop Conditions & Fallback Behavior

1. **Missing API Keys:** If neither `GEMINI_API_KEY`, `OPENAI_API_KEY`, nor `ANTHROPIC_API_KEY` is present in the environment, halt before Step 4 and prompt the user to provide API credentials.
2. **Budget Exhaustion:** If current spend exceeds `max_cost_usd`, pause execution, persist completed records to `.deepsec/data/<project>/`, and inform the user of partial progress.
3. **Lock Contention:** If `.deepsec/data/<project>/` contains an active worker lock from a running PID, wait or confirm whether the process is defunct before claiming.
Pliki w paczce (9)
  • .gitignore 1 KB
  • .skills.json 1 KB
  • LICENSE 1 KB
  • README.md 4 KB
  • SKILL.md 5 KB
  • install.sh 1 KB
  • marketplace.json 1 KB
  • package.json 1 KB
  • skill-spec.json 5 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · imMamdouhaboammar/deepsec100MIT
salexandr0s/ai-config95Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki d2ce2cebd7ab (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100security-specialist
    Prowadzi audyty bezpieczeństwa kodu: pełne skany, przeglądy diffów, modele zagrożeń, triage podatności, wskazówki naprawcze i śledzenie ustaleń.
  • 100security-audit
    Przeprowadza audyt bezpieczeństwa kodu pod kątem podatności, luk w izolacji i błędów logiki.
  • 100security-audit
    Sprawdza kod i zależności pod kątem podatności przy przeglądzie PR, przed wdrożeniem lub na prośbę o audyt bezpieczeństwa.
  • 100security-audit
    Uruchamia audyt bezpieczeństwa projektu: podatności zależności, skanowanie sekretów, wzorce OWASP i nagłówki HTTP.
  • 100audit-security
    Przeprowadza audyt bezpieczeństwa: sprawdza podatności, zgodność z OWASP, wycieki sekretów i ogólny stan bezpieczeństwa aplikacji.
  • 100security-auditor
    Działa jako ekspert od podatności (OWASP Top 10 i typowe problemy bezpieczeństwa), wspierając audyty i przeglądy kodu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.