Every flag of all four skills, organised by skill. The most-used flags sit in the visible table; the long tail collapses into a disclosure block. Every flag here is verified against its SKILL.md — nothing invented. Need to pick a skill first? Use the skill finder.Mọi cờ của cả bốn skill, xếp theo skill. Các cờ dùng nhiều nhất nằm trong bảng hiện; phần đuôi dài cuộn gọn vào khối disclosure. Mỗi cờ ở đây được kiểm chứng từ SKILL.md của nó — không bịa. Cần chọn skill trước? Dùng bộ chọn skill.

InstallCài đặt

Each skill ships its own installer. All four share one Python venv at .claude/skills/.venv/. Requires Python 3.11+.Mỗi skill đi kèm installer riêng. Cả bốn dùng chung một venv Python tại .claude/skills/.venv/. Cần Python 3.11+.

Replace product-spec with release, product-spec-critique, or telemetry for those skills. Any installer bootstraps the shared venv — re-running is safe (idempotent).Thay product-spec bằng release, product-spec-critique, hoặc telemetry cho các skill đó. Bất kỳ installer nào cũng dựng venv dùng chung — chạy lại an toàn (idempotent).

product-spec flagsCờ product-spec

Invoke with /cleanmatic:product-spec [--flag] [target]. Full guide: product-spec skill page.Gọi bằng /cleanmatic:product-spec [--cờ] [đích]. Hướng dẫn đầy đủ: trang skill product-spec.

FlagCờ	What it doesLàm gì
(no flag)	Detect state → present menu (init / BRD / PRD / stories / validate / update / viz / approve / summary).Dò trạng thái → hiện menu (init / BRD / PRD / story / validate / update / viz / approve / tóm tắt).
--product	Init or refresh PRODUCT.md (thin product-context labels).Khởi tạo hoặc làm mới PRODUCT.md (nhãn bối cảnh sản phẩm).
--brd	Create or refine the single BRD (business goals + metrics + stakeholders).Tạo hoặc chỉnh sửa BRD duy nhất (mục tiêu kinh doanh + chỉ số + stakeholder).
--prd [feature]	Create or refine a PRD for a feature area. Multiple PRDs supported.Tạo hoặc chỉnh sửa PRD cho một vùng tính năng. Hỗ trợ nhiều PRD.
--epic [prd]	Create or refine an epic under the given PRD.Tạo hoặc chỉnh sửa một epic dưới PRD đã chỉ định.
--story [epic]	Create or refine a story under the given epic.Tạo hoặc chỉnh sửa một story dưới epic đã chỉ định.
--auto	Brain-dump → decompose into BRD goals / PRDs / epics / stories; confirm-batch on ambiguous splits.Đổ ý tưởng → phân rã thành mục tiêu BRD / PRD / epic / story; xác nhận theo lô trên các phân chia mơ hồ.
--validate	Run structural scripts → layer LLM judgment → human report. Deterministic gate.Chạy script cấu trúc → thêm lớp nhận định LLM → báo cáo người đọc. Cổng tất định.
--approve	Validate → open-questions gate → record owner + date → flip status: approved. Nudges --export and --viz afterward.Validate → cổng câu-hỏi-mở → ghi owner + ngày → chuyển status: approved. Nhắc --export và --viz sau đó.
--update	Delta-update: ask what changed → flag affected downstream nodes for PO review. Never auto-rewrites prose.Cập nhật delta: hỏi đã đổi gì → gắn cờ các node xuôi chiều cho PO xem. Không tự ghi lại văn.
--viz <view>	Render a visualization (20 views: graph/body/governance/learning). See skill page for the full matrix.Vẽ trực quan hóa (20 khung nhìn: graph/body/quản trị/học). Xem trang skill để biết ma trận đầy đủ.
--summary	1-page exec brief. Add --audience release-notes for a delta since last approved.Tóm tắt 1 trang cho lãnh đạo. Thêm --audience release-notes để lấy delta kể từ lần duyệt cuối.
--status	Read-only health nudge: last-validated errors/warns + open-question markers. Does not re-run validate.Kiểm tra sức khỏe chỉ-đọc: lỗi/cảnh báo validate cuối + marker câu-hỏi-mở. Không chạy lại validate.

More product-spec flags — discover · decision · learn · export · format · lang · voice · reflect · strictThêm cờ product-spec — discover · decision · learn · export · format · lang · voice · reflect · strict

FlagCờ	What it doesLàm gì
--discover <path(s)>	Ingest raw transcripts/notes → candidate personas/problems to seed the Vision/BRD interview. Never auto-commits; the interview confirms each.Đọc transcript/ghi chú thô → ứng viên personas/vấn đề để gieo vào phỏng vấn Vision/BRD. Không tự cam kết; phỏng vấn xác nhận từng cái.
--strict	With --validate: errors block; warnings do not.Với --validate: lỗi chặn; cảnh báo không chặn.
--format <fmt>	Visualization format: ascii · mermaid · html. Default is per-view.Định dạng trực quan: ascii · mermaid · html. Mặc định theo từng khung nhìn.
--group-by <field>	--viz board column grouping: status (default) · horizon · moscow.Nhóm cột --viz board: status (mặc định) · horizon · moscow.
--filter-wont	Hide moscow: wont / scope: out items from tree / roadmap / board views. Nothing silently dropped.Ẩn các mục moscow: wont / scope: out khỏi khung nhìn tree / roadmap / board. Không có gì bị bỏ ngầm.
--export <all|ID|list>	Assemble a spec slice into one self-contained doc under exports/. Pairs with --layers / --depth / --compact-mode / --format.Lắp ráp một lát spec thành tài liệu tự chứa duy nhất dưới exports/. Dùng cùng với --layers / --depth / --compact-mode / --format.
--layers <types>	Filter artifact types for --export / --viz board|explorer: buckets vision,brd,prd,epic,story. Unknown token → rejected (non-zero).Lọc loại artifact cho --export / --viz board|explorer: nhóm vision,brd,prd,epic,story. Token không hợp lệ → bị từ chối (non-zero).
--depth <preset>	--export verbosity: context (default) · full · brief.Độ chi tiết --export: context (mặc định) · full · brief.
--compact-mode <m>	--export compaction: struct (default, deterministic) · llm (requires --format md; rejected with html).Nén --export: struct (mặc định, tất định) · llm (cần --format md; bị từ chối với html).
--decision [list|ID]	Decision Register: view or record an explicit PO ruling (DEC-<n>) in decisions.md. GATE: NO-SILENT-REVERSAL.Sổ quyết định: xem hoặc ghi một phán quyết PO rõ ràng (DEC-<n>) vào decisions.md. GATE: không-đảo-ngầm.
--learn	Learn from reality: record outcomes vs BRD goals (OUT-<n> via record_outcome.py) or ingest real-world feedback. A miss on an approved goal is surfaced, never auto-edited.Học từ thực tế: ghi kết quả so với mục tiêu BRD (OUT-<n>) hoặc đọc phản hồi thực tế. Một miss trên mục tiêu đã duyệt được nêu ra, không tự sửa.
--apply-critique <report>	Walk a product-spec-critique report finding-by-finding (Keep / Change+re-approve / Defer); one DEC-<n> per resolved finding. GATE: NO-SILENT-REVERSAL.Đi qua từng phát hiện của báo cáo product-spec-critique (Giữ / Đổi+duyệt-lại / Hoãn); một DEC-<n> cho mỗi phát hiện đã giải quyết.
--reflect	Retroactive memory harvest: scan git + .memory/, propose unrecorded decisions/self-corrections/voice for PO to confirm then persist.Thu hoạch bộ nhớ hồi tố: quét git + .memory/, đề xuất quyết định/tự-sửa/giọng chưa ghi để PO xác nhận rồi lưu.
--lang <code>	Interview/output language: en (default) · vi. IDs and frontmatter keys stay English.Ngôn ngữ phỏng vấn/đầu ra: en (mặc định) · vi. ID và khóa frontmatter vẫn tiếng Anh.
--voice	Record PO voice preferences into .memory/po-style.yaml (register / vocabulary / recurring-asks / do / dont). One writer home.Ghi sở thích giọng PO vào .memory/po-style.yaml (đại từ / từ vựng / yêu cầu thường gặp / làm / không làm). Một nơi ghi duy nhất.
preferences.py --set KEY=VALUE	Write a PO preference (repeatable; bad enum exits non-zero without writing). Knobs: interview_rigor (light/standard/deep) + action_prompting (standard/proactive).Ghi sở thích PO (có thể lặp lại; enum sai thì thoát non-zero không ghi gì). Núm: interview_rigor (light/standard/deep) + action_prompting (standard/proactive).

product-spec-critique flagsCờ product-spec-critique

Invoke with /cleanmatic:product-spec-critique [scope] [--flags]. Full guide: critique skill page.Gọi bằng /cleanmatic:product-spec-critique [phạm vi] [--cờ]. Hướng dẫn đầy đủ: trang skill critique.

FlagCờ	What it doesLàm gì
[scope]	Artifact ID to critique (PRD-AUTH, PRD-AUTH-E1, …) or all (default). Full ancestry is always pulled as context.ID artifact để chỉ trích (PRD-AUTH, PRD-AUTH-E1, …) hoặc all (mặc định). Ancestry đầy đủ luôn được kéo làm ngữ cảnh.
--product	Run only the product lens (JTBD / Value Prop / Kano / RICE / riskiest-assumption).Chỉ chạy lăng kính product (JTBD / Value Prop / Kano / RICE / giả định rủi ro nhất).
--tech	Run only the tech lens (INVEST / testability / hidden dependencies / NFR gaps).Chỉ chạy lăng kính tech (INVEST / có thể kiểm thử / phụ thuộc ẩn / khoảng trống NFR).
--market	Run only the market lens (Lean Canvas / Porter-light / Blue Ocean / unit-economics / JTBD-competition).Chỉ chạy lăng kính market (Lean Canvas / Porter nhẹ / Blue Ocean / kinh tế đơn vị / JTBD-cạnh tranh).
--craft	Run only the craft lens (clarity / conciseness / consistency / correctness / term drift / vague adjectives).Chỉ chạy lăng kính craft (rõ ràng / súc tích / nhất quán / chính xác / trôi thuật ngữ / tính từ mơ hồ).
--interactive	AskUserQuestion to pick scope + lenses + level before running.AskUserQuestion để chọn phạm vi + lăng kính + mức trước khi chạy.
--level 1..9	Voice intensity. Default = 5 (no-mercy). Aliases 1–6: --warm · --gentle · --blunt · --savage · --no-mercy · --roast. Levels 6–9 carry a danger gate (confirm + AskUserQuestion). Level 9 re-confirms on every run. Universal-harm floor applies at all levels.Độ mạnh giọng. Mặc định = 5 (không nhân nhượng). Bí danh 1–6: --warm · --gentle · --blunt · --savage · --no-mercy · --roast. Mức 6–9 có cổng nguy hiểm (xác nhận + AskUserQuestion). Mức 9 hỏi lại mỗi lần chạy. Lằn ranh an toàn phổ quát áp dụng ở mọi mức.
--lang vi|en	Critique output language. Default vi. IDs and frontmatter keys stay English.Ngôn ngữ đầu ra critique. Mặc định vi. ID và khóa frontmatter vẫn tiếng Anh.
--no-web	Disable the market lens's WebSearch/WebFetch. With no competitors: in BRD, flags missing competitive grounding rather than fabricating.Tắt WebSearch/WebFetch của lăng kính market. Nếu không có competitors: trong BRD, gắn cờ thiếu căn cứ cạnh tranh thay vì bịa.

More critique flags — fresh · refresh-web · inherit · rollup · no-inherit · no-rollupThêm cờ critique — fresh · refresh-web · inherit · rollup · no-inherit · no-rollup

FlagCờ	What it doesLàm gì
--fresh / --force	Bypass ALL reuse: force a full fresh run (provenance.reuse = none), re-running every lens even when nothing changed.Bỏ qua MỌI tái sử dụng: ép chạy mới hoàn toàn (provenance.reuse = none), chạy lại mọi lăng kính kể cả không có gì thay đổi.
--refresh-web	Force the market lens to re-fetch URLs (ignore the 14-day web-cache). --no-web still wins over this.Ép lăng kính market tải lại URL (bỏ qua web-cache 14 ngày). --no-web vẫn được ưu tiên hơn.
--no-inherit	Disable parent→child inherited context (prior parent blockers surfaced as child risk). Default ON.Tắt ngữ cảnh kế thừa parent→child (blocker của parent trước được nêu làm rủi ro của child). Mặc định BẬT.
--no-rollup	Disable child→parent descendant rollup (critiqued children's verdicts aggregated onto parent). Default ON.Tắt rollup hậu duệ child→parent (verdict của child đã critique được tổng hợp lên parent). Mặc định BẬT.
--inherit nearest|deep	Inherit depth: nearest (default) = nearest critiqued ancestor per branch; deep = every critiqued ancestor in the chain. Implies inherit ON.Độ sâu kế thừa: nearest (mặc định) = tổ tiên gần nhất đã critique trên mỗi nhánh; deep = mọi tổ tiên đã critique trong chuỗi. Ngầm bật inherit.

release flagsCờ release

Invoke with /cleanmatic:release [--flags] or run the pack builder directly. Full guide: release skill page.Gọi bằng /cleanmatic:release [--cờ] hoặc chạy trực tiếp pack builder. Hướng dẫn đầy đủ: trang skill release.

FlagCờ	What it doesLàm gì
(no flag)	Interactive menu → build manifest → preview → confirm → pack.Menu tương tác → dựng manifest → xem trước → xác nhận → đóng gói.
--manifest <path>	Manifest file (default .claude/pack.manifest.yaml).File manifest (mặc định .claude/pack.manifest.yaml).
--dry-run	Print would-be file list + total size; no tarball written.In danh sách file dự kiến + tổng dung lượng; không tạo tarball.
--version <semver>	Override manifest.version for an ad-hoc build.Ghi đè manifest.version cho build đặc biệt.
--out <dir>	Output directory (default dist/).Thư mục đầu ra (mặc định dist/).
--source-date-epoch <int|env>	Override mtime root for reproducible CI builds (default 0 = fully deterministic).Ghi đè mtime gốc cho build CI có thể tái tạo (mặc định 0 = hoàn toàn tất định).
--json	Emit JSON status to stdout (machine-parseable).Xuất JSON trạng thái ra stdout (máy đọc được).

More release flags — skills · agents · hooks · rules · extra · bundle-name · dry-run --compute-sha · include-settings · include-ck-config · include-scripts · include-schemas · include-shared · max-size · strictThêm cờ release — skills · agents · hooks · rules · extra · bundle-name · dry-run --compute-sha · include-settings · include-ck-config · include-scripts · include-schemas · include-shared · max-size · strict

FlagCờ	What it doesLàm gì
--skills <list>	Comma-separated skill slugs (override manifest).Danh sách slug skill cách nhau dấu phẩy (ghi đè manifest).
--agents <list>	Comma-separated agent slugs (override manifest).Danh sách slug agent cách nhau dấu phẩy (ghi đè manifest).
--hooks <list>	Comma-separated hook filenames (override manifest).Danh sách tên file hook cách nhau dấu phẩy (ghi đè manifest).
--rules <list>	Comma-separated rule filenames (override manifest).Danh sách tên file rule cách nhau dấu phẩy (ghi đè manifest).
--extra <paths>	Extra repo-relative paths to include (no .., no absolute paths).Các đường dẫn tương đối thêm vào (không dùng .., không dùng đường tuyệt đối).
--bundle-name <name>	Override the output filename stem.Ghi đè tên gốc của file đầu ra.
--dry-run --compute-sha	Dry-run + add would-be SHA256 (opt-in; avoids double-pass).Dry-run + thêm SHA256 dự kiến (opt-in; tránh pass kép).
--include-settings	Include .claude/settings.json in the bundle (opt-in).Thêm .claude/settings.json vào bundle (opt-in).
--include-ck-config	Include .claude/.ck.json in the bundle (opt-in).Thêm .claude/.ck.json vào bundle (opt-in).
--include-scripts	Include .claude/scripts/ (CK-framework internals; opt-in).Thêm .claude/scripts/ (nội bộ CK-framework; opt-in).
--include-schemas	Include schemas/ (CK-framework internals; opt-in).Thêm schemas/ (nội bộ CK-framework; opt-in).
--include-shared <list>	Opt-in skills/_shared/<name> components (warn-only if omitted).Thêm thành phần skills/_shared/<tên> (chỉ cảnh báo nếu bỏ qua).
--max-size <bytes>	Reject if compressed tar.gz exceeds limit (default 100 MB).Từ chối nếu tar.gz nén vượt giới hạn (mặc định 100 MB).
--strict	Treat un-included _shared/ references as errors (exit 2).Coi các tham chiếu _shared/ không được thêm vào là lỗi (exit 2).

release.py — changelog lifecyclerelease.py — vòng đời changelog

FlagCờ	What it doesLàm gì
--extract X.Y.Z	Print a version's CHANGELOG section body (the CI release body). Read-only.In phần nội dung CHANGELOG của một phiên bản (nội dung release CI). Chỉ đọc.
--release X.Y.Z	Cut at an explicit version.Cắt release ở phiên bản cụ thể.
--bump major|minor|patch	Cut at the next version computed from the manifest.Cắt release ở phiên bản tiếp theo tính từ manifest.
--pre-release LABEL	Append a pre-release label (e.g. rc.1 → X.Y.Z-rc.1).Gắn nhãn pre-release (ví dụ rc.1 → X.Y.Z-rc.1).
--date YYYY-MM-DD	Override the release date (default: today).Ghi đè ngày phát hành (mặc định: hôm nay).
--apply	Write changes (default is dry-run preview).Ghi thay đổi (mặc định là xem trước dry-run).
--push	Owner opt-in: also create + push the product-spec-vX.Y.Z tag (requires --apply). Fires release CI.Owner opt-in: tạo + push tag product-spec-vX.Y.Z (cần --apply). Kích hoạt CI release.

telemetry flagsCờ telemetry

Invoke with /cleanmatic:telemetry [--flags]. Read-only — no writes. Full guide: telemetry skill page.Gọi bằng /cleanmatic:telemetry [--cờ]. Chỉ đọc — không ghi. Hướng dẫn đầy đủ: trang skill telemetry.

FlagCờ	What it doesLàm gì
--lens all	Full dashboard (usage + session + health + reliability + workflow + validate + memory + product_memory + artifact_heat). Default when no lens specified.Bảng điều khiển đầy đủ (usage + session + health + reliability + workflow + validate + memory + product_memory + artifact_heat). Mặc định khi không chỉ định lăng kính.
--lens usage	Invocation counts, per-skill tokens (approx), never-used catalog entries.Số lần gọi, token theo skill (ước lượng), các mục catalog chưa bao giờ dùng.
--lens session	Session count, avg/median duration, files touched, subagents, skill co-occurrence.Số phiên, thời lượng trung bình/trung vị, file đã đụng, subagent, skill đồng xuất hiện.
--lens health	Per-script runs / errors / error-rate + avg ms (approx).Số lần chạy / lỗi / tỷ lệ lỗi theo script + ms trung bình (ước lượng).
--lens reliability	Subagent success / api_error / timeout / blocked / unknown per type.Thành công / api_error / timeout / blocked / unknown theo loại subagent.
--lens validate	Validate-pass proxy — internal spec quality signal, NOT market outcome.Proxy validate-pass — tín hiệu chất lượng spec nội bộ, KHÔNG phải kết quả thị trường.
--lens memory	Claude memory health: orphans, dead index entries, broken [[links]], staleness.Sức khỏe bộ nhớ Claude: mồ côi, mục index chết, [[liên kết]] hỏng, độ cũ.
--lens forensics	Reconstruct one session (skills / tools / tokens / files / duration). Requires --session <id>.Dựng lại một phiên (skill / công cụ / token / file / thời lượng). Cần --session <id>.
--format ascii|md|mermaid|json	Output format. Default ascii.Định dạng đầu ra. Mặc định ascii.
--lang vi|en	Narration language for fixed labels. Default vi.Ngôn ngữ diễn giải cho nhãn cố định. Mặc định vi.

More telemetry flags — product_memory · artifact_heat · workflow · days · top · session · all-sessionsThêm cờ telemetry — product_memory · artifact_heat · workflow · days · top · session · all-sessions

FlagCờ	What it doesLàm gì
--lens product_memory	Spec-store health: last-validated age, missing state files, critique-cache size.Sức khỏe spec-store: tuổi validate cuối, file trạng thái thiếu, kích thước critique-cache.
--lens artifact_heat	Artifact-edit frequency: most-edited spec artifacts (heat ranking) within --days window.Tần suất chỉnh sửa artifact: các artifact spec được chỉnh nhiều nhất (xếp hạng nhiệt) trong cửa sổ --days.
--lens workflow	Actual skill chains vs declared chains; deviations from data/skill-chains.yaml.Chuỗi skill thực tế so với đã khai; các lệch khỏi data/skill-chains.yaml.
--days N	Restrict analysis to the last N days.Giới hạn phân tích trong N ngày gần nhất.
--top N	Show top N results in ranked lenses.Hiện N kết quả hàng đầu trong các lăng kính xếp hạng.
--session <id>	Target a specific session ID (required by --lens forensics).Nhắm tới một ID phiên cụ thể (bắt buộc với --lens forensics).
--all-sessions	Include all sessions in forensics analysis.Bao gồm tất cả phiên trong phân tích forensics.