dym-scientific-agent-skills-dong-gop-validate-test-scan

Skill: dym-scientific-agent-skills-dong-gop-validate-test-scan — Đóng góp: validate, test, scan

Track ĐÓNG GÓP. Mọi lệnh chạy từ gốc repo skill đã clone.

Vì sao dùng: đây là các cổng CI thật. Chạy trước là biết PR đỏ ở đâu trong vài giây thay vì chờ vòng CI. Sinh ra cái gì: kết quả pass/fail cục bộ khớp với cái CI sẽ nói, cộng comment markdown của scanner nếu bạn chạy wrapper.

---

Thiết lập môi trường

Đường chính thức:

uv sync

Nếu máy chưa có uv (như máy đã dùng để kiểm chứng bundle này), cổng nhanh nhất vẫn chạy được bằng venv thuần, vì tests/_meta chỉ cần thư viện chuẩn + pytest:

python3.13 -m venv .venv
./.venv/bin/pip install pytest
./.venv/bin/python -m pytest tests/_meta -q

Repo yêu cầu Python 3.13+ (pyproject.toml → requires-python = ">=3.13").

Cổng 1 — spec conformance

# một skill
uv run skills-ref validate skills/<name>

# cả bộ, đúng như CI làm
for d in skills/*/; do uv run skills-ref validate "$d"; done

Đã chạy thật trên cả 163 thư mục (qua venv thuần, không uv): 0 lỗi. Output khi hợp lệ: Valid skill: skills/depmap, exit 0.

.github/workflows/skill-spec-validation.yml chạy đúng thứ đó ở mọi PR chạm skills/, cộng các luật repo mà skills-ref không kiểm: metadata.version có mặt, allowed-tools là chuỗi ngăn cách bằng dấu cách, scalar trong metadata được quote, và cảnh báo khi vượt 500 dòng.

Không có uv? skills-ref cài được thẳng:

./.venv/bin/pip install "skills-ref @ git+https://github.com/agentskills/agentskills.git#subdirectory=skills-ref"
./.venv/bin/skills-ref validate skills/<name>

Nó còn hai subcommand hữu ích khi debug: read-properties (in property của skill dạng JSON) và to-prompt (sinh XML <available_skills> mà agent thực sự thấy).

Cổng 2 — tests/_meta, tín hiệu nhanh nhất trong repo

uv run --with pytest python -m pytest tests/_meta -q

Đã chạy thật: 10 passed, 1213 subtests passed in 1.82s. Thuần thư viện chuẩn, không package khoa học nào, vài giây.