ptn1411/skill：面向 AI Agent 的授权安全审计技能与 CLI 工具集

Authorized Artifact Auditor

Bộ công cụ và tập hợp skill hỗ trợ phân tích phần mềm, khôi phục cấu trúc nguồn ở mức cần thiết, rà soát bảo mật, kiểm tra phụ thuộc và xây dựng kế hoạch khắc phục cho các hệ thống mà bạn sở hữu hoặc được phép đánh giá.

Dự án cung cấp cả hướng dẫn cho AI agent lẫn các CLI Python có thể chạy độc lập. Mọi workflow đều ưu tiên thu thập bằng chứng, báo cáo có thể kiểm chứng và biện pháp phòng thủ.

Important

Chỉ sử dụng dự án trên artifact, máy chủ, ứng dụng và hạ tầng thuộc quyền sở hữu của bạn hoặc nằm trong phạm vi được ủy quyền rõ ràng. Việc phân tích không mặc nhiên cho phép vượt xác thực, bản quyền, giấy phép, thanh toán hoặc các biện pháp kiểm soát truy cập. Xem MASTER_POLICY.md.

Nhóm	Khả năng
Điều phối	Nhận diện target và chọn workflow phù hợp; có thể tổng hợp nhiều phase vào một báo cáo
Artifact	Fingerprint binary, compiler, packager và framework; khôi phục cấu trúc phục vụ audit được ủy quyền
Web và mạng	Kiểm tra bề mặt dịch vụ, cấu hình TLS/header/CORS và các lỗi web trong phạm vi hợp pháp
Phụ thuộc và hạ tầng	Lập SBOM, rà soát supply chain, Docker, Kubernetes, Terraform và cấu hình cloud
Windows	Threat hunting trên Windows Event Logs và phân tích bằng chứng cục bộ
CVE và PoC công khai	Tra cứu CVE, EDB-ID, sản phẩm và phiên bản trong Exploit-DB mà không tự tải hoặc chạy exploit
Báo cáo	Sinh kết quả có cấu trúc, xếp mức độ nghiêm trọng và đề xuất remediation phòng thủ

Các skill chuyên biệt nằm trong từng thư mục con. Điểm vào chính là SKILL.md; danh sách công cụ ngoài và điều kiện cài đặt nằm trong TOOLS.md.

Cài đặt và Tích hợp

Yêu cầu Python 3.10 trở lên. Hướng dẫn chi tiết từng bước xem tại INSTALL.md.

1. Cài đặt môi trường

git clone https://github.com/ptn1411/skill.git
cd skill
python -m pip install -r requirements.txt

Tip

Các công cụ bên ngoài (Node.js, asar, Android SDK, JADX, Nmap, ilspycmd) chỉ cần cài khi workflow tương ứng yêu cầu. Chi tiết xem tại TOOLS.md.

2. Cài đặt / Đồng bộ Skill vào AI Agent (Gemini CLI, Claude Code, Antigravity)

Dự án cung cấp sẵn script đồng bộ toàn bộ skill vào thư mục cấu hình toàn cục của các AI agent:

# Sao chép skill vào ~/.gemini/config/skills và ~/.claude/skills (khuyên dùng trên Windows)
python scripts\link_skills.py

# Hoặc tạo Directory Junction (NTFS):
python scripts\link_skills.py --mode junction

Đối với các CLI Agent khác (Codex, OpenAI), xem hướng dẫn cấu hình manifest trong INSTALL.md.

Các câu lệnh hay dùng

1. Điều phối & Đánh giá toàn diện (Orchestration & Assessment)

Tự động phân loại mục tiêu (IP, URL web, binary, file bundle, sourcemap) và chạy chuỗi skill tương ứng:

# Chạy chuỗi đánh giá toàn diện mục tiêu mạng / web (Nmap -> Web Recon -> Báo cáo tổng hợp)
python scripts\full_assess.py https://app.example.com --out output\assessment
python scripts\full_assess.py 192.168.1.10 --out output\assessment

# Tự động nhận diện và phân tích artifact nhị phân / ứng dụng / sourcemap
python scripts\orchestrate.py "C:\path\to\owned-app.exe" --out output
python scripts\orchestrate.py "C:\path\to\app-folder" --out output

# Xem trước luồng phân loại (dry-run) mà không thực thi
python scripts\assess.py example.com --dry-run

2. Tra cứu lỗ hổng & Threat Intelligence

Tra cứu thông tin tình báo CVE, exploit công khai mà không cần chạy payload nguy hiểm:

# Tra cứu đa nguồn (CISA KEV, FIRST EPSS, NIST NVD, Exploit-DB, PoC GitHub)
python vulnerability-lookup\scripts\lookup_vuln.py --cve CVE-2024-6387
python vulnerability-lookup\scripts\lookup_vuln.py --cve CVE-2021-44228 --out output\cve-report

# Tìm kiếm mã khai thác và tài liệu trong Exploit-DB cục bộ
python searching-exploit-db\scripts\search_exploit_db.py --cve CVE-2021-44228
python searching-exploit-db\scripts\search_exploit_db.py --query "OpenSSH 9.8"

3. Rà soát Hạ tầng, Cloud & Chuỗi cung ứng (Cloud, Docker & SBOM)

# Kiểm tra Dockerfile, Kubernetes YAML, Terraform, Cloud configs
python container-cloud-auditor\scripts\analyze_container_cloud.py . --out output\container-cloud

# Lập SBOM, audit phụ thuộc, phát hiện dependency confusion và package độc hại
python sbom-supply-chain-auditor\scripts\analyze_supply_chain.py . --out output\sbom

4. Rà soát Web & Quét mạng (Web Recon & Network Scanner)

# Trinh sát thụ động Web (Security Headers, TLS, CORS, rò rỉ endpoint)
python web-app-scanner\scripts\web_recon.py https://example.com --out output\web-recon

# Kiểm tra SQLi có kiểm soát trên tham số (yêu cầu cờ --authorized)
python web-app-scanner\scripts\sqli_test.py "https://example.com/item?id=1" --authorized

# Quét cổng & dịch vụ bằng Nmap tích hợp
python network-scanner\scripts\nmap_scan.py 192.168.1.0/24 --profile quick --out output\nmap

5. Khôi phục cấu trúc & Rà soát nhị phân (Binary & Reverse Engineering)

Phục vụ phân tích cấu trúc, audit mã nguồn và tìm kiếm secret bị mã hóa cứng:

# Nhận diện ngôn ngữ, trình biên dịch, packager của file nhị phân
python binary-identifier\scripts\identify_app.py target.exe

# Bung gói ứng dụng Electron / ASAR để audit offline
python electron-builder-unpacker\scripts\unpack_electron_builder.py app-dir --out output\electron-unpacked

# Audit cấu hình bảo mật Electron (IPC, webPreferences, preload bridges)
python electron-app-analyzer\scripts\analyze_electron.py output\electron-unpacked --out output\electron-analysis

# Khôi phục mã nguồn từ file JS sourcemap (.map)
python javascript-deobfuscator\scripts\extract_sourcemap.py "https://example.com/app.js.map" output\recovered-js

# Phân tích tĩnh gói ứng dụng Android APK/XAPK nội bộ
python android-apk-pentester\scripts\analyze_apk.py app.apk --out output\apk-analysis

# Threat hunting trên Windows Event Logs (dò tìm tấn công, tài khoản mới, xóa log)
python windows-log-hunter\scripts\hunt_eventlog.py --out output\hunt

6. Kiểm thử & Phát triển Skill mới

# Chạy toàn bộ unit test hồi quy của dự án
python -m unittest discover -s tests -v

# Kiểm tra tính hợp lệ hợp đồng (contract) của một skill mới
python orchestrator-plugin-sdk\scripts\validate_skill_contract.py container-cloud-auditor

Cấu trúc dự án

skill/
├── SKILL.md                 # Điều phối và phạm vi chung
├── MASTER_POLICY.md         # Ranh giới ủy quyền và an toàn
├── INSTALL.md               # Hướng dẫn cài đặt chi tiết
├── TOOLS.md                 # Công cụ ngoài theo workflow
├── scripts/                 # Dispatcher và orchestrator
├── tests/                   # Kiểm thử hồi quy toàn dự án
├── <skill-name>/            # Skill chuyên biệt
│   ├── SKILL.md
│   ├── scripts/
│   └── references/
└── output/                  # Báo cáo và artifact do công cụ tạo

Kiểm thử

Chạy toàn bộ unit test trước khi gửi thay đổi:

python -m unittest discover -s tests -v

Khi thêm hoặc sửa một skill, kiểm tra contract của skill đó:

python orchestrator-plugin-sdk\scripts\validate_skill_contract.py <skill-name>

Không commit dữ liệu nhạy cảm, token, thông tin xác thực, memory dump, traffic capture hoặc output thu từ hệ thống thật. Báo cáo công khai phải che giá trị bí mật và chỉ giữ vị trí hoặc fingerprint cần thiết.

Đóng góp

Issue, tài liệu, test, workflow phòng thủ và cải tiến khả năng tương thích đều được chào đón.

Fork repository và tạo branch cho thay đổi của bạn.
Giữ mỗi pull request tập trung vào một vấn đề hoặc một skill.
Với skill mới, thêm SKILL.md, test có ý nghĩa và đăng ký skill trong dispatcher hoặc tài liệu liên quan.
Chạy toàn bộ test và kiểm tra không có secret hoặc output nhạy cảm trong diff.
Mở pull request, mô tả mục tiêu, phạm vi ủy quyền giả định và bằng chứng kiểm thử.

Bạn có thể mở issue để báo lỗi, đề xuất tính năng hoặc thảo luận trước một thay đổi lớn.

Ủng hộ dự án

Nếu dự án giúp ích cho công việc nghiên cứu hoặc phòng thủ của bạn, bạn có thể ủng hộ để duy trì tài liệu, test và các workflow mới. Mọi khoản đóng góp đều hoàn toàn tự nguyện.

Ngân hàng: TPBank
Chủ tài khoản: PHAM THANH NAM
Số tài khoản: 69238686888

Cảm ơn bạn đã sử dụng, phản hồi và đóng góp cho dự án.