Skip to content

tanviet12/vbsec / skills/antigravity/vbs-scan-security

vbs-scan-security

Flagged

Use when scanning code for security vulnerabilities. Use when user says "scan security", "kiểm tra bảo mật", "security audit", "review security", or invokes `/vbs-scan-security`. For large scans (>20 main-language files OR >30 total OR >14 days) processes chunks sequentially. Outputs bilingual reports (vi/en). Optional `--auto-fix` (agentic patch + verify loop) and `--sca` (live CVE lookup via OSV.dev).

FileKindSize
SKILL.mdskill md28.2 KB
VERSIONother6 B
references/chunking-strategy.mdmarkdown7.2 KB
references/data-flow-classification.mdmarkdown9.5 KB
references/dependency-scan.mdmarkdown9.7 KB
references/i18n/en.mdmarkdown8.7 KB
references/i18n/vi.mdmarkdown9.4 KB
references/language-detection.mdmarkdown7.5 KB
references/load-rules.shexecutablescript5.2 KB
references/output-format.mdmarkdown26.1 KB
references/project-context.mdmarkdown2.7 KB
references/sub-agent-prompts.mdmarkdown16.5 KB
references/validate-report.pyexecutablescript8.7 KB
rules/generic/01-hardcoded-secret.mdmarkdown5.4 KB
rules/generic/02-sql-injection.mdmarkdown5.2 KB
rules/generic/03-xss.mdmarkdown4.9 KB
rules/generic/04-idor.mdmarkdown5.7 KB
rules/generic/05-slopsquatting.mdmarkdown6.1 KB
rules/generic/06-brute-force.mdmarkdown6.9 KB
rules/generic/07-mass-assignment.mdmarkdown6.3 KB
rules/generic/08-insecure-deserialization.mdmarkdown6.3 KB
rules/generic/09-ssrf.mdmarkdown6.7 KB
rules/generic/10-path-traversal.mdmarkdown6.3 KB
rules/generic/11-csrf.mdmarkdown7.8 KB
rules/generic/12-broken-access-control.mdmarkdown7.9 KB
rules/generic/13-weak-password-hashing.mdmarkdown5.2 KB
rules/generic/14-jwt-none-algorithm.mdmarkdown5.3 KB
rules/generic/15-cors-misconfig.mdmarkdown5.3 KB
rules/generic/16-unrestricted-file-upload.mdmarkdown5.9 KB
rules/generic/17-verbose-error-debug-mode.mdmarkdown5.8 KB
rules/generic/18-missing-rate-limit.mdmarkdown10.7 KB
rules/generic/19-race-condition.mdmarkdown11.5 KB
rules/generic/20-outdated-dependency.mdmarkdown7.2 KB
rules/generic/21-command-injection.mdmarkdown6.6 KB
rules/generic/22-vulnerable-dependency.mdmarkdown5.3 KB
rules/generic/23-llm-prompt-injection.mdmarkdown9.7 KB
rules/generic/24-excessive-agency.mdmarkdown10.1 KB
rules/generic/25-tenant-isolation.mdmarkdown10.1 KB
rules/generic/26-authz-path-parity.mdmarkdown10.9 KB
rules/generic/27-excessive-data-exposure.mdmarkdown10.4 KB
rules/generic/28-business-state-integrity.mdmarkdown9.5 KB
rules/generic/29-sensitive-data-in-logs.mdmarkdown9.1 KB
rules/generic/30-auth-session-lifecycle.mdmarkdown9.4 KB
rules/generic/31-resource-exhaustion.mdmarkdown9.0 KB
rules/languages/README.mdmarkdown8.5 KB
rules/languages/dart/01-hardcoded-secret.mdmarkdown7.9 KB
rules/languages/dart/03-xss.mdmarkdown5.2 KB
rules/languages/dart/05-slopsquatting.mdmarkdown4.6 KB
rules/languages/dart/10-path-traversal.mdmarkdown6.3 KB
rules/languages/dart/12-broken-access-control.mdmarkdown8.3 KB
rules/languages/dart/17-verbose-error-debug-mode.mdmarkdown6.7 KB
rules/languages/dart/20-outdated-dependency.mdmarkdown4.7 KB
rules/languages/dart/README.mdmarkdown3.7 KB
rules/languages/dotnet/02-sql-injection.mdmarkdown5.7 KB
rules/languages/dotnet/07-mass-assignment.mdmarkdown6.0 KB
rules/languages/dotnet/08-insecure-deserialization.mdmarkdown5.7 KB
rules/languages/dotnet/17-verbose-error-debug-mode.mdmarkdown5.0 KB
rules/languages/dotnet/21-command-injection.mdmarkdown5.3 KB
rules/languages/dotnet/README.mdmarkdown1.7 KB
rules/languages/go/02-sql-injection.mdmarkdown5.2 KB
rules/languages/go/08-insecure-deserialization.mdmarkdown5.0 KB
rules/languages/go/09-ssrf.mdmarkdown5.8 KB
rules/languages/go/17-verbose-error-debug-mode.mdmarkdown6.1 KB
rules/languages/go/21-command-injection.mdmarkdown5.2 KB
rules/languages/go/README.mdmarkdown2.7 KB
rules/languages/php/02-sql-injection.mdmarkdown5.8 KB
rules/languages/php/08-insecure-deserialization.mdmarkdown6.2 KB
rules/languages/php/11-csrf.mdmarkdown6.2 KB
rules/languages/php/17-verbose-error-debug-mode.mdmarkdown6.5 KB
rules/languages/php/21-command-injection.mdmarkdown6.7 KB
rules/languages/php/README.mdmarkdown2.9 KB
rules/languages/python/02-sql-injection.mdmarkdown7.2 KB
rules/languages/python/07-mass-assignment.mdmarkdown7.3 KB
rules/languages/python/08-insecure-deserialization.mdmarkdown7.3 KB
rules/languages/python/09-ssrf.mdmarkdown7.5 KB
rules/languages/python/11-csrf.mdmarkdown7.6 KB
rules/languages/python/14-jwt-none-algorithm.mdmarkdown7.5 KB
rules/languages/python/15-cors-misconfig.mdmarkdown8.0 KB
rules/languages/python/17-verbose-error-debug-mode.mdmarkdown8.4 KB
rules/languages/python/21-command-injection.mdmarkdown8.5 KB
rules/languages/python/README.mdmarkdown3.4 KB
rules/languages/typescript/02-sql-injection.mdmarkdown7.5 KB
rules/languages/typescript/03-xss.mdmarkdown6.7 KB
rules/languages/typescript/07-mass-assignment.mdmarkdown7.4 KB
rules/languages/typescript/08-insecure-deserialization.mdmarkdown7.0 KB
rules/languages/typescript/09-ssrf.mdmarkdown7.5 KB
rules/languages/typescript/11-csrf.mdmarkdown7.3 KB
rules/languages/typescript/14-jwt-none-algorithm.mdmarkdown7.0 KB
rules/languages/typescript/15-cors-misconfig.mdmarkdown7.2 KB
rules/languages/typescript/17-verbose-error-debug-mode.mdmarkdown7.2 KB
rules/languages/typescript/21-command-injection.mdmarkdown6.7 KB
rules/languages/typescript/README.mdmarkdown3.3 KB
workflows/auto-fix.mdmarkdown18.9 KB
workflows/large-review-sequential.mdmarkdown14.8 KB
workflows/small-review.mdmarkdown10.1 KB

references/chunking-strategy.md

View on GitHub
# Chunking Strategy

Cách chia file thành chunks cho LARGE mode (sub-agent delegation). Mỗi chunk được 1 sub-agent quét song song.

## Mục tiêu

- Sub-agent có **scope rõ ràng**: 1 chunk = 1 phần logic của repo (không phải 1 file lẻ)
- Mỗi chunk có **đủ context** để reasoning (không bị cắt mid-function)
- **Cân bằng tải**: chunks tương đương kích cỡ
- **Không quá nhiều chunks**: target 3-10 chunks (sub-agent overhead cao, đừng có 50 chunk 2 file mỗi cái)

## Strategy mặc định (v0.8+): Lát dọc theo khu nghiệp vụ

Chia theo **thư mục cấp một** cắt đứt luồng dữ liệu: với kiến trúc nhiều tầng (handler → core/service → repo ở thư mục khác nhau, cộng tool agent / MCP ở chỗ thứ tư), agent con quét `handlers/` không thấy repo lọc tenant thế nào, agent quét `repo/` không biết input đến từ đâu. Lỗi đắt nhất (tenant, quyền lệch giữa các đường, lộ dữ liệu, logic trạng thái) nằm đúng ở chỗ nối đó.

Nên mỗi chunk là **một lát dọc**: mọi file của một khu nghiệp vụ, đủ các tầng.

1. **Tìm khu nghiệp vụ** bằng tên chung xuyên tầng: `handlers/invoice.go`, `service/invoice.go`, `repo/invoice_repo.go`, `mcp/tools/invoice.ts`, `migrations/*invoice*` → khu `invoice`. Nguồn gợi ý: file đăng ký route (`router.go`, `routes/*.ts`), tên bảng trong migration, thư mục `modules/<khu>` / `features/<khu>` / `domain/<khu>` nếu repo đã chia sẵn (khi đó dùng luôn).
2. **Gán file vào khu**: theo tên (stem chung), rồi theo import (handler import service nào). File dùng chung (middleware auth / tenant, db helper, config, logger) → gắn vào **mọi** lát dọc dưới dạng "đọc tham khảo" (không tính vào file_count), và vào chunk liên khu.
3. **Chunk liên khu** (`kind: cross-cutting`), luôn có khi repo có ≥ 2 khu: nhận danh sách mọi file mã, chỉ soát TENANT-ISOLATION, AUTHZ-PATH-PARITY, EXCESSIVE-DATA-EXPOSURE, SENSITIVE-DATA-IN-LOGS và luật dự án — so sánh các đường ghi / đọc cùng đối tượng giữa các khu (xem prompt trong [`sub-agent-prompts.md`](sub-agent-prompts.md)).
4. File không thuộc khu nào (script, cấu hình, frontend thuần UI) → gom theo thư mục như strategy cũ bên dưới.

Không tìm được khu (repo phẳng, ít tầng) → dùng strategy theo thư mục bên dưới.

## Strategy dự phòng: Top-level folder

Chia theo **top-level folder** dưới git root, mỗi folder = 1 chunk.

```
my-repo/
├── api/           ← chunk 1
├── web/           ← chunk 2
├── shared/        ← chunk 3
└── scripts/       ← chunk 4
```

File ở root (vd: `package.json`, `Dockerfile`, `.env.example`) → 1 chunk riêng tên `root`.

## Rules để cân bằng

1. **Chunk có >50 file** → split thành chunk nhỏ hơn theo sub-folder
   ```
   api/  (120 files) → split:
     ├── api/handlers/  ← chunk
     ├── api/middleware/ ← chunk
     └── api/services/   ← chunk
   ```

2. **Folder có <5 file** → merge vào chunk khác cùng tính chất
   ```
   utils/ (3 files) + helpers/ (4 files) → 1 chunk "utils+helpers"
   ```

3. **Detected primary language ≠ folder language** → ưu tiên giữ chunk theo lang để sub-agent có thể apply đúng overlay
   - Vd: `frontend/` toàn `.ts`, `backend/` toàn `.go` → 2 chunk, mỗi cái có lang riêng

4. **Test files**: gộp `__tests__/`, `*_test.go`, `*.spec.ts` vào CHUNK CHA của code chúng test. Lý do: rule áp dụng cho test code khác với prod code (vd: HARDCODED-SECRET trong test với fixture data thường không phải critical).

## Strategy thay thế: Theo extension cluster

Khi repo không có cấu trúc folder rõ (flat repo, mix mọi thứ ở root), chia theo extension cluster:

```
flat-repo/
├── *.go (8 files)        ← chunk "go"
├── *.py (5 files)        ← chunk "python"
├── *.js (3 files)        ← chunk "js"
├── Dockerfile, .env*     ← chunk "config"
```

## Strategy theo file count

| Tổng files | Số chunks target | Files/chunk |
|---|---|---|
| 30-60 | 3-5 | ~10-15 |
| 60-150 | 5-8 | ~15-25 |
| 150-300 | 8-12 | ~20-30 |
| >300 | 12-15 | ~25-30 |

KHÔNG quá 15 chunks. Sub-agent spawn overhead + main-agent aggregate context = chậm hơn nếu split nhỏ.

## Pseudocode

```python
def chunk_files(files, max_files_per_chunk=30, target_chunks_max=15):
    # 1. Group by top-level folder
    groups = {}
    for f in files:
        top = f.split("/")[0] if "/" in f else "root"
        groups.setdefault(top, []).append(f)

    # 2. Split big chunks
    final = []
    for folder, fs in groups.items():
        if len(fs) > max_files_per_chunk:
            # Split by sub-folder
            sub_groups = {}
            for f in fs:
                parts = f.split("/")
                sub = parts[1] if len(parts) > 1 else parts[0]
                sub_groups.setdefault(f"{folder}/{sub}", []).append(f)
            for sub_folder, sub_fs in sub_groups.items():
                final.append({"name": sub_folder, "files": sub_fs})
        else:
            final.append({"name": folder, "files": fs})

    # 3. Merge tiny chunks
    tiny = [c for c in final if len(c["files"]) < 5]
    if len(tiny) >= 2:
        merged_name = "+".join(c["name"] for c in tiny)
        merged_files = [f for c in tiny for f in c["files"]]
        final = [c for c in final if len(c["files"]) >= 5]
        final.append({"name": merged_name, "files": merged_files})

    # 4. If still too many chunks, merge sequentially
    while len(final) > target_chunks_max:
        final.sort(key=lambda c: len(c["files"]))
        c1, c2 = final.pop(0), final.pop(0)
        final.append({"name": f"{c1['name']}+{c2['name']}", "files": c1["files"] + c2["files"]})

    return final
```

LLM agent dùng Glob + lý luận để chia, không cần chạy Python literal. Pseudocode trên là strategy dự phòng; với lát dọc, bước 1 thay `top = f.split("/")[0]` bằng "khu nghiệp vụ của f" (stem chung / import), các bước cân bằng (split chunk > 30 file theo khu con, merge khu < 5 file) giữ nguyên.

## Output format cho main orchestrator

Sau khi chunk, main agent có list dạng:

```
[
  {"name": "api/handlers", "files": ["api/handlers/user.ts", "api/handlers/order.ts", ...], "count": 12},
  {"name": "api/middleware", "files": [...], "count": 8},
  {"name": "frontend/src/components", "files": [...], "count": 25},
  ...
]
```

Mỗi chunk được TodoWrite tạo 1 task. Sub-agent nhận chunk + prompt template (xem [`sub-agent-prompts.md`](sub-agent-prompts.md)).

## Edge cases

| Scenario | Cách xử lý |
|---|---|
| Repo có submodule | Skip submodule (không scan). Note trong report. |
| Generated code chiếm 80% chunk | Split: chunk "generated" (low priority) + chunk source. Có thể skip "generated" nếu user confirm. |
| Monorepo với 50+ apps | Chunk theo app (ưu tiên top-level `apps/<name>`), không split deeper. |
| 1 file >5000 dòng | Để nguyên 1 chunk (đừng split 1 file). Note "large file, đọc kỹ". |
| Repo siêu nhỏ (10 files) | Không LARGE mode — fallback SMALL. SKILL.md đã guard điều này. |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall