Which skill do I run?Mình nên chạy skill nào?
Command finderChọn skill
match the goal
Match the goal, not the name. Find where you are in the cycle, scan the "if you're trying to…" rows, and run the skill on the right. This mirrors the routing map hs:find-skills reads — when two skills overlap, the tie-breakers below settle it.Khớp theo mục tiêu, không theo tên. Tìm bạn đang ở đâu trong vòng đời, đọc các dòng "nếu bạn đang muốn…", rồi chạy skill bên phải. Đây là bản đồ định tuyến mà hs:find-skills đọc — khi hai skill chồng nhau, phần phân định bên dưới quyết.
Step 1 — where are you?Bước 1 — bạn đang ở đâu?
Five stages. Most work lives in one of them at a time — find yours, then read its rows below.Năm chặng. Phần lớn việc nằm ở một chặng tại một thời điểm — tìm chặng của bạn, rồi đọc các dòng của nó bên dưới.
PlanLập kế hoạch
starting somethingbắt đầu việc gì đó
→
BuildXây / sửa
writing or it's brokenđang viết hoặc đang hỏng
→
VerifyKiểm chứng
checking it's rightkiểm cho đúng
→
ShipShip
ready to releasesẵn sàng phát hành
Starting & planningBắt đầu & lập kế hoạch
| If you're trying to…Nếu bạn đang muốn… | RunChạy |
|---|---|
| Turn a real feature into a verified, phased planBiến một feature thật thành plan có kiểm chứng, chia phase | /hs:plan |
| Shape an ambiguous ask before you can plan itĐịnh hình một yêu cầu mơ hồ trước khi plan được | /hs:discover |
| Gather and verify evidence from many sourcesThu thập và kiểm chứng bằng chứng từ nhiều nguồn | /hs:research |
| Debate trade-offs before committing to a directionTranh luận đánh đổi trước khi chọn hướng | /hs:brainstorm |
| Understand an unfamiliar codebase firstHiểu một codebase lạ trước đã | /hs:understand |
| Surface edge cases & risks before buildingLộ ra edge case & rủi ro trước khi xây | /hs:scenario · /hs:predict |
Building & fixingXây & sửa
| If you're trying to…Nếu bạn đang muốn… | RunChạy |
|---|---|
| Execute an approved plan, phase by phaseThực thi một plan đã duyệt, từng phase | /hs:cook |
| Start a brand-new project from scratchBắt đầu một dự án mới hoàn toàn | /hs:bootstrap |
| Fix a bug whose cause you already knowSửa một bug đã biết nguyên nhân | /hs:fix |
| Find the root cause before fixingTìm nguyên nhân gốc trước khi sửa | /hs:debug |
| Run the whole bug lifecycle: reproduce → classify → fixChạy toàn bộ vòng đời bug: tái hiện → phân loại → sửa | /hs:triage |
| Improve a measurable metric by iterating in-sessionCải thiện một metric đo được bằng cách lặp trong phiên | /hs:loop |
| Run a plan unattended (AFK)Chạy một plan không giám sát (AFK) | /hs:afk |
Checking & reviewingKiểm & review
| If you're trying to…Nếu bạn đang muốn… | RunChạy |
|---|---|
| Run & validate the tests for your changeChạy & validate test cho thay đổi của bạn | /hs:test |
| Review a local diff / commit for bugs & securityReview một diff / commit cục bộ cho bug & bảo mật | /hs:code-review |
| Review a GitHub PR (with optional auto-fix / reply)Review một PR GitHub (kèm auto-fix / reply tùy chọn) | /hs:review-pr |
| Scan for secrets, CVEs, injection, authz gapsQuét secret, CVE, injection, khe-hở authz | /hs:security-scan |
| Run an adversarial multi-lens critique → one verdictChạy critique đối nghịch nhiều lăng kính → một verdict | /hs:critique |
ShippingShip
| If you're trying to…Nếu bạn đang muốn… | RunChạy |
|---|---|
| Take a finished branch through the gated ship pipelineĐưa một nhánh xong qua pipeline ship có gate | /hs:ship |
| Just commit / push / open a PR (with conventional commits)Chỉ commit / push / mở PR (với conventional commit) | /hs:git |
| Record what you learned this sessionGhi lại điều bạn học được trong phiên này | /hs:journal |
Operating the harness itselfVận hành chính harness
| If you're trying to…Nếu bạn đang muốn… | RunChạy |
|---|---|
| Configure the harness posture (voice, guards, language)Cấu hình posture harness (giọng, guard, ngôn ngữ) | /hs:setup |
| See how the harness is actually being used (hot/cold skills, gate blocks)Xem harness đang được dùng ra sao (skill hay/ít dùng, gate block) | /hs:insights |
| Get one ranked "what to improve next" proposalLấy một đề xuất xếp hạng "cải tiến gì tiếp theo" | /hs:compound |
| Make the harness adapt to a non-Python target repoCho harness thích nghi repo đích không-phải-Python | /hs:techstack |
When two skills both fitKhi hai skill cùng hợp
The disambiguation rules from the routing map — the exact calls hs:find-skills makes.Các quy tắc phân định từ bản đồ định tuyến — đúng những lựa chọn mà hs:find-skills đưa ra.
- Bug:Bug: clear cause →
hs:fix; unknown cause →hs:debug; full lifecycle →hs:triage.rõ nguyên nhân →hs:fix; chưa rõ →hs:debug; cả vòng đời →hs:triage. - Review:Review: small diff / commit →
hs:code-review; GitHub PR / branch →hs:review-pr.diff / commit nhỏ →hs:code-review; PR / nhánh GitHub →hs:review-pr. - Unfamiliar code:Code lạ:
hs:understandfirst, thenhs:plan.hs:understandtrước, rồihs:plan. - Fuzzy problem:Vấn đề mơ hồ:
hs:discoverbeforehs:plan; many sources needed →hs:research.hs:discovertrướchs:plan; cần nhiều nguồn →hs:research. - Diagram:Sơ đồ: inline-doc →
hs:mermaidjs; editable canvas →hs:excalidraw; publish-grade →hs:tech-graph; explain a change →hs:preview.trong-tài-liệu →hs:mermaidjs; canvas sửa được →hs:excalidraw; chất lượng xuất bản →hs:tech-graph; giải thích thay đổi →hs:preview. - Extend the harness:Mở rộng harness: a skill →
hs:skill-creator; a hook / script / rule / agent →hs:harness-creator.một skill →hs:skill-creator; một hook / script / rule / agent →hs:harness-creator.
Still not sure?Vẫn chưa chắc?
Let the router decideĐể router quyết
Describe the task in your own words. hs:find-skills parses the intent, queries the live catalog (so it never proposes a phantom skill), and returns the exact invoke command — plus a supporting skill if the work spans two.Mô tả việc bằng lời của bạn. hs:find-skills phân tích ý định, truy vấn catalog trực tiếp (nên không bao giờ đề xuất skill ma), và trả về đúng lệnh gọi — kèm một skill hỗ trợ nếu việc trải dài hai skill.
/hs:find-skills add rate-limiting to the upload endpointthêm rate-limit cho endpoint uploadparse
intentý định
plan / build / debug / review / ship / metaplan / build / debug / review / ship / meta
query
live catalogcatalog trực tiếp
catalog.py · load_catalog()return
exact commandlệnh chính xác
no phantom skillskhông skill ma
💡
Prefer the most specific skill — router skills (
find-skills, triage, understand, autoresearch) are for genuine orchestration, not for "I'm unsure". For the full list with descriptions, see the catalog; for commands in tables, the cheatsheet.Ưu tiên skill cụ thể nhất — skill router (find-skills, triage, understand, autoresearch) dành cho điều phối thật, không phải cho "tôi chưa chắc". Danh sách đầy đủ kèm mô tả ở catalog; lệnh dạng bảng ở tra cứu nhanh.