Skill finderBộ chọn skill
Match the goal, not the name. The four skills each own a distinct job — they overlap at the edges. Scan the "if you want to…" tables to land on the right one, then use the tie-breaker rules when two skills both seem to fit. Still unsure? The last section points you to worked examples.Khớp theo mục tiêu, không theo tên. Bốn skill mỗi cái giữ một công việc riêng — chúng chồng nhau ở rìa. Đọc bảng "nếu bạn muốn…" để chọn đúng cái, rồi dùng quy tắc phân định khi hai skill có vẻ cùng hợp. Vẫn chưa chắc? Phần cuối trỏ đến các ví dụ thật.
Pick by what you wantChọn theo điều bạn muốn
Four goal clusters — one per skill. Each cluster names the concrete things that skill handles. The pills show who it is designed for.Bốn nhóm mục tiêu — mỗi skill một nhóm. Mỗi nhóm liệt kê những việc cụ thể skill đó xử lý. Các nhãn pill cho biết nó thiết kế cho ai.
/cleanmatic:product-spec
Product Owner
Define, structure, and govern a product spec. Use this when you are building or evolving the spec itself — from first interview to approved story.Định nghĩa, cấu trúc, và quản trị spec sản phẩm. Dùng khi bạn đang xây hoặc phát triển bản thân spec — từ phỏng vấn đầu tiên đến story đã duyệt.
- Start a product from scratch (Vision → BRD → PRD → Epic → Story)Bắt đầu sản phẩm từ đầu (Vision → BRD → PRD → Epic → Story)
- Add a new feature area (
--prd), epic (--epic), or story (--story)Thêm vùng tính năng mới (--prd), epic (--epic), hoặc story (--story) - Decompose a brain-dump into a structured spec (
--auto)Phân rã "bãi ý tưởng" thành spec có cấu trúc (--auto) - Seed the spec from raw transcripts or notes (
--discover)Gieo spec từ transcript thô hay ghi chú (--discover) - Run the structural + LLM validation gate (
--validate)Chạy cổng kiểm tra cấu trúc + LLM (--validate) - Sign off an artifact (
--approve) or log a ruling (--decision)Ký duyệt artifact (--approve) hoặc ghi phán quyết (--decision) - Update the spec without losing prior decisions (
--update)Cập nhật spec mà không mất quyết định cũ (--update) - Produce a 1-page exec brief or release-notes delta (
--summary)Tạo tóm tắt 1 trang cho lãnh đạo hoặc delta release-notes (--summary) - Visualize the spec tree, roadmap, board, or MoSCoW coverage (
--viz)Trực quan hóa cây spec, lộ trình, bảng, hay phủ MoSCoW (--viz) - Act on a critique report finding-by-finding (
--apply-critique)Xử lý báo cáo critique từng phát hiện một (--apply-critique) - Record real outcomes vs BRD goals after launch (
--learn)Ghi kết quả thực tế so với mục tiêu BRD sau khi ra mắt (--learn)
/cleanmatic:product-spec-critique
Product Owner
Get an honest, opinionated tear-down of an existing spec. Use this after the spec exists and you want to know whether it is any good — not just structurally sound.Nhận đánh giá thẳng thắn, có quan điểm về spec hiện tại. Dùng sau khi spec đã tồn tại và bạn muốn biết nó có tốt không — không chỉ là vững về cấu trúc.
- Find out why a spec would fail in the market (market lens)Tìm hiểu vì sao spec sẽ thất bại trên thị trường (lăng kính market)
- Catch features nobody needs, fake personas, solution-first thinking (product lens)Phát hiện tính năng không ai cần, personas bịa, tư duy giải-pháp-trước (lăng kính product)
- Find untestable AC, non-INVEST stories, hidden dependencies (tech lens)Tìm AC không thể kiểm thử, story không INVEST, phụ thuộc ẩn (lăng kính tech)
- Audit writing quality — vague adjectives, term drift, wall-of-text (craft lens)Kiểm tra chất lượng viết — tính từ mơ hồ, trôi thuật ngữ, tường văn bản (lăng kính craft)
- Pre-stakeholder gut-check on a PRD, epic, or story by IDKiểm tra nhanh trước khi trình stakeholder về PRD, epic, hay story theo ID
- Tune the voice from gentle coaching to brutal honesty (
--level 1..9)Chỉnh giọng từ cố vấn nhẹ nhàng đến thẳng thắn không khoan nhượng (--level 1..9) - Re-run cheaply after a fix — reuses prior lens work when the spec is unchangedChạy lại rẻ sau khi sửa — tái dùng kết quả lăng kính cũ khi spec không đổi
/cleanmatic:release
Developer
Pack and ship the harness bundle. Use this when you need to share the .claude/ rig with another repo or cut an official versioned release.Đóng gói và ship bundle harness. Dùng khi bạn cần chia sẻ bộ .claude/ cho repo khác hoặc cắt release phiên bản chính thức.
- Bundle a curated subset of
.claude/into a deterministic, versionedtar.gzĐóng gói tập con được chọn của.claude/thànhtar.gztất định, có phiên bản - Preview the file list and size before building (
--dry-run)Xem trước danh sách file và dung lượng trước khi build (--dry-run) - Build from an existing manifest (
--manifest) or compose one interactivelyBuild từ manifest có sẵn (--manifest) hoặc soạn tương tác - Lock the CHANGELOG, bump the version, and hand off the tag-push for CI (
release.py)Khoá CHANGELOG, tăng phiên bản, và bàn giao tag-push cho CI (release.py) - Seed a teammate's repo from this repo's working
.claude/setupGieo repo của đồng nghiệp từ bộ.claude/đang chạy của repo này
/cleanmatic:telemetry
Product Owner
Read how your tooling is actually running — in plain Vietnamese. Use this after you have been using the harness for a while and want an honest usage + health read. It never writes anything.Đọc bộ đồ nghề của bạn đang chạy thế nào — bằng tiếng Việt thuần. Dùng sau khi bạn đã dùng harness một thời gian và muốn đọc mức dùng + sức khỏe trung thực. Nó không bao giờ ghi gì.
- See which skills get used and which are never touched (
--lens usage)Xem skill nào hay dùng và skill nào chưa bao giờ chạm (--lens usage) - Find scripts that error or run slow (
--lens health)Tìm script lỗi hoặc chạy chậm (--lens health) - Check subagent success / failure rates (
--lens reliability)Kiểm tra tỷ lệ thành công / thất bại của subagent (--lens reliability) - See if the last
--validatepassed — as an internal quality proxy (--lens validate)Xem lần--validatecuối có pass không — như proxy chất lượng nội bộ (--lens validate) - Audit memory tidiness — orphans, dead links, staleness (
--lens memory)Kiểm tra sự gọn gàng của bộ nhớ — mồ côi, link chết, độ cũ (--lens memory) - Reconstruct a single session's full activity (
--lens forensics --session <id>)Dựng lại toàn bộ hoạt động của một phiên (--lens forensics --session <id>) - Get the full dashboard in one run (
--lens all, the default)Lấy bảng điều khiển đầy đủ trong một lần chạy (--lens all, mặc định)
Tie-breakersPhân định khi hai skill cùng hợp
When two skills seem to overlap, these rules settle it. They reflect the design intent documented in the SKILL.md files.Khi hai skill có vẻ chồng nhau, các quy tắc này giải quyết. Chúng phản ánh mục đích thiết kế được ghi trong các file SKILL.md.
-
Define vs critique:Định nghĩa vs critique:
No spec yet, or you are still building it →
product-spec. Spec already exists and you want to know if it is any good →product-spec-critique. Critique is a consumer — it reads what product-spec wrote; it can't run without an existing spec. Chưa có spec, hoặc bạn vẫn đang xây →product-spec. Spec đã tồn tại và bạn muốn biết nó có tốt không →product-spec-critique. Critique là consumer — nó đọc những gì product-spec đã viết; không chạy được nếu không có spec sẵn. -
Validate vs critique:Validate vs critique:
Want a deterministic pass/fail on structure →
product-spec --validate(the CI gate). Want an opinionated read on whether it is worth building →product-spec-critique(never a CI gate; non-deterministic by design). Muốn pass/fail tất định về cấu trúc →product-spec --validate(cổng CI). Muốn đánh giá có quan điểm về việc nó có đáng xây không →product-spec-critique(không bao giờ là cổng CI; không tất định theo thiết kế). -
Act on critique vs just read it:Xử lý critique vs chỉ đọc:
You have a critique report and want to record decisions from it →
product-spec --apply-critique <report>. You just want the tear-down →product-spec-critique. Bạn có báo cáo critique và muốn ghi quyết định từ nó →product-spec --apply-critique <báo cáo>. Bạn chỉ muốn đọc phần mổ xẻ →product-spec-critique. -
Ship a bundle vs observe usage:Ship bundle vs quan sát mức dùng:
Need to package and distribute the
.claude/rig →release(developer, writes a tarball). Need to read how the rig is being used on a machine →telemetry(PO, read-only, no writes). Cần đóng gói và phân phối bộ.claude/→release(developer, ghi tarball). Cần đọc bộ đó đang được dùng thế nào trên một máy →telemetry(PO, chỉ đọc, không ghi). -
Telemetry validate lens vs product-spec --validate:Lăng kính validate của telemetry vs product-spec --validate:
--lens validatein telemetry is a proxy — it reads whether the last validate run passed. Runproduct-spec --validateto actually validate the spec now. They are different actions: observe vs execute.--lens validatetrong telemetry là proxy — nó đọc lần chạy validate cuối có pass không. Chạyproduct-spec --validateđể thực sự validate spec ngay bây giờ. Đây là hai hành động khác nhau: quan sát vs thực thi. -
record outcome vs observe health:ghi kết quả vs quan sát sức khỏe:
Want to record a PO-declared outcome (target vs actual for a BRD goal) →
product-spec --learn. Want to read the internal quality proxy of whether validate passed →telemetry --lens validate. The former writes; the latter reads. Muốn ghi kết quả do PO khai (mục tiêu so với thực tế cho mục tiêu BRD) →product-spec --learn. Muốn đọc proxy chất lượng nội bộ xem validate có pass không →telemetry --lens validate. Cái trước ghi; cái sau đọc. -
release (cut) vs release (observe):release (cắt) vs release (quan sát):
Cutting a versioned release of the bundle →
release. Observing how the installed skills are being used on someone's machine →telemetry. No overlap: one is the build tool, one is the usage reader. Cắt release phiên bản của bundle →release. Quan sát cách các skill đã cài đang được dùng trên máy ai đó →telemetry. Không chồng nhau: cái kia là build tool, cái này là đọc mức dùng.
What none of them doNhững gì không skill nào làm
Scope boundaries that apply across all four skills — not skill-by-skill gaps, but design constraints of the whole harness.Ranh giới phạm vi áp dụng cho cả bốn skill — không phải khoảng trống theo từng skill, mà là ràng buộc thiết kế của toàn bộ harness.
- No production code. The harness specifies, critiques, packs, and observes — it never writes application code. That is the build team's job.Không viết code production. Harness đặc tả, chỉ trích, đóng gói và quan sát — không bao giờ viết code ứng dụng. Đó là việc của đội build.
- No autonomous scope decisions. Scope (
in/out/core-value) is always the PO's call. The harness flags, surfaces, and asks — it never assumes scope. (GATE-NEVER-ASSUME.)Không tự quyết phạm vi. Phạm vi (in/out/core-value) luôn là quyết định của PO. Harness gắn cờ, nêu ra và hỏi — không bao giờ giả định phạm vi. (GATE-NEVER-ASSUME.) - No silent reversals of approved content. Any contradiction with an
approvedartifact is a stop point — surfaced verbatim with Keep · Change · Hybrid choices. Never auto-fixed. (GATE-NO-SILENT-REVERSAL.)Không đảo ngầm nội dung đã duyệt. Mọi mâu thuẫn với artifactapprovedlà điểm dừng — nêu nguyên văn với các lựa chọn Giữ · Đổi · Kết hợp. Không bao giờ tự sửa. (GATE-NO-SILENT-REVERSAL.) - No market-effectiveness measurement. Telemetry measures machinery health, not market outcomes. Even
--learnin product-spec records PO-declared outcomes offline — it is not a market analytics tool.Không đo hiệu quả thị trường. Telemetry đo sức khỏe máy móc, không phải kết quả thị trường. Kể cả--learntrong product-spec chỉ ghi kết quả do PO khai offline — đó không phải công cụ analytics thị trường. - No network calls at runtime. After install, all four skills run offline. (One caveat: if Mermaid failed to vendor at install time, product-spec's graph views fall back to a CDN script at browser-render — re-run the installer to vendor it.)Không gọi mạng khi chạy. Sau khi cài, cả bốn skill chạy offline. (Một ngoại lệ: nếu Mermaid không được vendor khi cài, khung nhìn đồ thị của product-spec sẽ fallback sang CDN lúc render trình duyệt — chạy lại installer để vendor nó.)
Still unsure?Vẫn chưa chắc?
Two resources that cover the full story: a step-by-step guided tour, and a worked end-to-end journey.Hai tài nguyên bao quát toàn bộ câu chuyện: bản hướng dẫn từng bước, và hành trình thực tế từ đầu đến cuối.
QuickstartBắt đầu nhanh
Install → first command → first output. Start here if you have never run any of the four skills before.Cài đặt → lệnh đầu tiên → đầu ra đầu tiên. Bắt đầu từ đây nếu bạn chưa chạy bất kỳ skill nào trong bốn cái.
End-to-end journeyHành trình từ đầu đến cuối
Follow a real product from blank page to shipped bundle — every skill in context, in order. Read this to see how the four skills interlock.Theo dõi một sản phẩm thật từ trang trắng đến bundle đã ship — mỗi skill trong ngữ cảnh, theo thứ tự. Đọc để thấy bốn skill móc nối với nhau thế nào.
validate, DEC-<n>, voice level, and deterministic pack.Khi đã biết skill nào cần chạy, tra cứu nhanh có mọi cờ trong bảng để tham khảo nhanh. Glossary có định nghĩa chính xác cho các thuật ngữ như validate, DEC-<n>, voice level, và deterministic pack.