Everything, in tablesTất cả, trong bảng
CheatsheetTra cứu nhanh
scan & go
Every skill, event, rule, rubric, and venv command in scannable tables. Need the why behind a row? See catalog (full skill descriptions) · finder (pick by intent) · glossary (term definitions).Mọi skill, sự kiện, quy tắc, rubric, lệnh venv trong bảng tra nhanh. Cần biết tại sao một dòng tồn tại? Xem catalog (mô tả đầy đủ) · finder (chọn theo ý định) · glossary (định nghĩa thuật ngữ).
🔣
Reading a skill call:
{fw}:{skill} — framework prefix then skill name. Always start a deep-analysis session with orc:bootstrap. Skill count verified by audit:Đọc một lệnh skill: {fw}:{skill} — tiền tố framework rồi tên skill. Luôn bắt đầu phiên phân tích sâu bằng orc:bootstrap. Số skill được xác minh bởi audit:
Skill catalog — 68 project-owned skills orc=17 psy=16 cre=10 gro=8 mat=4 com=5 evl=8
All 68 skills — by frameworkToàn bộ 68 skill — theo framework
Full descriptions in the catalog. Invoke with {fw}:{skill}.Mô tả đầy đủ trong catalog. Gọi với {fw}:{skill}.
MAT — Materials (4)MAT — Tư liệu (4)
mat:loader | Stage 1–2 ingest: classify, CRAAP-score, frontmatterGiai đoạn 1–2 thu nhận: phân loại, chấm CRAAP, frontmatter |
mat:indexer | Stage 3–4 contradiction/gap detection + integration gateGiai đoạn 3–4 phát hiện mâu thuẫn/khoảng trống + cổng tích hợp |
mat:archive | Soft-delete/archival with audit trailXóa-mềm/lưu trữ kèm vết kiểm toán |
mat:rescore | Flag materials needing CRAAP re-evaluationGắn cờ tư liệu cần chấm lại CRAAP |
PSY — Psychology (16)PSY — Tâm lý học (16)
psy:wave | 3-wave full 5P clinical formulationFormulation 5P lâm sàng 3-đợt đầy đủ |
psy:crossref | Cross-character 10-dimension consistency validationXác thực nhất quán 10 chiều liên nhân vật |
psy:ref-audit | Profile → reference accuracy checkKiểm tra độ chính xác hồ sơ → reference |
psy:ref-scan | Reference → profile coverage sweepQuét phạm vi bao phủ reference → hồ sơ |
psy:ref-create | Create reference files following the schemaTạo file reference theo schema |
psy:ref-maintain | Reference library cleanup and maintenanceDọn dẹp và bảo trì thư viện reference |
psy:crisis-assess | DSM-5/ICD-11 crisis + risk assessment — never cachedĐánh giá khủng hoảng + rủi ro DSM-5/ICD-11 — không bao giờ cache |
psy:hypothesis | Predict behavior under hypothetical scenariosDự đoán hành vi trong tình huống giả định |
psy:arc-tracker | Growth trajectories — hypothesis vs realityQuỹ đạo tăng trưởng — giả thuyết vs thực tế |
psy:narrative-twist | Handle revealed falsehoods + cascade updatesXử lý sự thật bị lộ + cập nhật cascade |
psy:propagate | Cross-character event cascade propagationLan truyền cascade sự kiện liên nhân vật |
psy:timeline-sync | Cross-character timeline consistency validationXác thực nhất quán dòng thời gian liên nhân vật |
psy:profile-lite | Compress profiles to ~5% of original sizeNén hồ sơ xuống ~5% kích thước gốc |
psy:profile-compare | Side-by-side dimension comparison across charactersSo sánh chiều cạnh song song giữa các nhân vật |
psy:health-check | Profile completeness scoring (25-file schema)Chấm điểm tính đầy đủ hồ sơ (schema 25-file) |
psy:relation-intelligence | Mine dyad graph for relationship-driven content anglesKhai thác đồ thị dyad để tìm góc nội dung theo quan hệ |
CRE — Content Creation (10)CRE — Sáng tạo nội dung (10)
cre:post-writer | End-to-end content pipeline — draft → scan → publishQuy trình nội dung đầu-cuối — soạn → quét → xuất bản |
cre:exploring | 7-question exploration → CONTEXT.md discovery briefKhám phá 7-câu hỏi → CONTEXT.md discovery brief |
cre:angle-discovery | Mine 6 frameworks → ranked angles for contentKhai thác 6 framework → góc độ xếp hạng cho nội dung |
cre:multiplatform | 1→N platform-native variants from one brief1→N biến thể gốc-nền-tảng từ một brief |
cre:repurpose | Adapt existing content 1→1 across platformsTái sử dụng nội dung hiện có 1→1 qua các nền tảng |
cre:prompt-leverage | 5-layer prompt strengthening for richer outputTăng cường prompt 5 lớp cho đầu ra phong phú hơn |
cre:evidence-scanner | Per-claim evidence-tier check + Rule-09 privacy gateKiểm bậc bằng chứng từng claim + cổng bảo mật Rule-09 |
cre:humanize | De-AI-slop scan (VN+EN) with optional rewriteQuét AI-slop (VN+EN) với tùy chọn viết lại |
cre:voice-audit | Voice/tone consistency check across contentKiểm tra nhất quán giọng/tông trong nội dung |
cre:privacy-guard | Pre-publish privacy and confidentiality scanQuét bảo mật và bí mật trước khi đăng |
GRO — Growth (8)GRO — Tăng trưởng (8)
gro:career-path | Career trajectory mapping and stage analysisLập bản đồ quỹ đạo và phân tích giai đoạn sự nghiệp |
gro:competency-map | Skills/competency inventory + gap analysisKiểm kê kỹ năng/năng lực + phân tích khoảng trống |
gro:learning-profile | Learning style and knowledge acquisition patternsPhong cách học tập và mẫu tiếp thu kiến thức |
gro:mentoring-track | Mentoring relationship documentationTài liệu hóa mối quan hệ cố vấn |
gro:career-forecast | LLM career projection — always [FORECAST — NOT FACTUAL]Dự báo sự nghiệp LLM — luôn [FORECAST — NOT FACTUAL] |
gro:compare | Side-by-side career comparison across charactersSo sánh sự nghiệp song song giữa các nhân vật |
gro:milestone-tracker | Career milestones — actual vs plannedCột mốc sự nghiệp — thực tế vs kế hoạch |
gro:validate | Cross-check growth data for consistencyKiểm tra chéo dữ liệu tăng trưởng về tính nhất quán |
EVL — Evaluation (8)EVL — Đánh giá (8)
evl:score | Generic rubric scoring engine — gather → judge → aggregateĐộng cơ chấm rubric tổng quát — gom → phán → tổng hợp |
evl:standardize | Psychometric battery preset (Big Five + Dark Triad + attachment)Preset bộ đo tâm lý (Big Five + Dark Triad + gắn bó) |
evl:fit | Role/casting-fit — CAST / CONDITIONAL / NO + vetoPhù hợp vai/diễn — CAST / CONDITIONAL / NO + veto |
evl:compatibility | Dyad compatibility scoring on the relationship rubricChấm điểm tương thích dyad trên rubric quan hệ |
evl:compare | Cross-character ranking on one rubricXếp hạng liên nhân vật trên một rubric |
evl:track | Score-over-time diff + event attributionDiff điểm theo thời gian + quy trách nhiệm sự kiện |
evl:validate | Rubric + scorecard structural integrity checkerKiểm tra tính toàn vẹn cấu trúc rubric + scorecard |
evl:rubric-import | Map external framework → canonical rubric draftÁnh xạ framework ngoài → bản thảo rubric chuẩn |
ORC — Orchestration (17)ORC — Điều phối (17)
orc:bootstrap | Load project context — the entry hubTải bối cảnh dự án — hub đầu vào |
orc:session-state | Track session state + event queueTheo dõi trạng thái phiên + hàng đợi sự kiện |
orc:intake | Route work type → skill chainĐịnh tuyến loại công việc → chuỗi skill |
orc:classify | Risk classification + MAT gate triggersPhân loại rủi ro + kích hoạt gate MAT |
orc:domain-router | Route domain events downstreamĐịnh tuyến sự kiện miền xuôi dòng |
orc:cascade | Resolve multi-step cross-domain event cascadesGiải quyết cascade sự kiện đa-miền nhiều bước |
orc:audit | Cross-domain event consistency — declared vs ranNhất quán sự kiện liên miền — khai báo vs thực chạy |
orc:event-log | Persistent event audit trail (JSONL append-only)Vết kiểm toán sự kiện bền vững (JSONL append-only) |
orc:decisions | Append-only decision records with evidence citationsBản ghi quyết định append-only với trích dẫn bằng chứng |
orc:compounding | Extract session learnings → persistent memoryRút học từ phiên → bộ nhớ bền vững |
orc:dream | Periodic memory consolidation across sessionsCủng cố bộ nhớ định kỳ qua các phiên |
orc:agent-memory | Per-agent calibration memory storeKho bộ nhớ hiệu chỉnh theo từng agent |
orc:observe | Cross-framework passive telemetry → instinct signalsĐo từ xa thụ động liên framework → tín hiệu bản năng |
orc:graph | Knowledge-graph query/visualize/validate + analytics subcommandsTruy vấn/trực quan/xác thực đồ thị tri thức + lệnh con analytics |
orc:santa | Dual-reviewer quality gateCổng chất lượng hai reviewer |
orc:council | 4-voice decision framework for contested choicesFramework quyết định 4 giọng cho các lựa chọn tranh cãi |
orc:skill-stocktake | Skill catalog count + CE-02 conformance auditĐếm catalog skill + kiểm tra tuân thủ CE-02 |
COM — Common Utilities (5)COM — Tiện ích chung (5)
com:git | Project-aware git operations with conventional commitsGit ops nhận biết dự án với conventional commit |
com:health-check | Session health monitoring and diagnostic reportGiám sát sức khỏe phiên và báo cáo chẩn đoán |
com:rules | Modular rules management — load/update domain rulesQuản lý rule mô-đun — tải/cập nhật rule miền |
com:skill-analytics | Skill/script observability — 11 read-only lenses + profile-drift gateQuan sát skill/script — 11 lăng kính chỉ-đọc + cổng profile-drift |
com:release | Cut a versioned pack release — Keep a Changelog + manifest bumpCắt phát hành gói có phiên bản — Keep a Changelog + bump manifest |
Event namesTên sự kiện
The five named events that wire the pipeline. ORC routes them; no framework writes cross-domain. Full definitions in the glossary.Năm sự kiện có tên nối quy trình. ORC định tuyến; không framework nào ghi chéo miền. Định nghĩa đầy đủ trong glossary.
| EventSự kiện | Emitted byPhát bởi | TriggersKích hoạt |
|---|---|---|
MAT.integrated | MAT · mat:indexer | PSY.refresh |
PSY.refresh | PSY · psy:wave | CRE.recalibrate · EVL.rescore |
GRO.assessed | GRO · any GRO skill | PSY.refresh · CRE.recalibrate · EVL.rescore |
EVL.scored | EVL · evl:score | CRE.recalibrate |
CRE.recalibrate | CRE · cre:post-writer | Content strategy refreshLàm mới chiến lược nội dung |
17 rules — index17 quy tắc — chỉ mục
Source: docs/rules/01-17-*.md. Rules are enforced at runtime — not style suggestions.Nguồn: docs/rules/01-17-*.md. Quy tắc được cưỡng chế lúc runtime — không phải gợi ý phong cách.
| RuleQuy tắc | FileFile | DomainMiền |
|---|---|---|
| 01 | 01-profile-structure.md | 25-file schema, directory layout, namingSchema 25-file, bố cục thư mục, đặt tên |
| 02 | 02-clinical-reference-usage.md | How to use DSM-5/ICD-11/attachment refs responsiblyCách sử dụng ref DSM-5/ICD-11/gắn bó có trách nhiệm |
| 03 | 03-evidence-tiers.md | T1–T5 definitions, CRAAP, tier gate at MATĐịnh nghĩa T1–T5, CRAAP, cổng bậc tại MAT |
| 04 | 04-mat-pipeline.md | Ingest stages, integration gate, contradiction handlingCác giai đoạn thu nhận, cổng tích hợp, xử lý mâu thuẫn |
| 05 | 05-psy-formulation.md | 5P model, 3-wave protocol, wave sequence rulesMô hình 5P, giao thức 3-đợt, quy tắc trình tự đợt |
| 06 | 06-crisis-protocol.md | Crisis assessment — no-cache invariant, escalationĐánh giá khủng hoảng — bất biến không-cache, leo thang |
| 07 | 07-hypothesis-forecast.md | [FORECAST] labelling, T5 constraints, no-promote ruleGán nhãn [FORECAST], ràng buộc T5, quy tắc không-thăng hạng |
| 08 | 08-cre-content-standards.md | Content quality, voice consistency, humanize requirementsChất lượng nội dung, nhất quán giọng, yêu cầu humanize |
| 09 | 09-confidentiality-privacy.md | Publish gate, privacy tags, forbidden-in-publish listCổng xuất bản, nhãn bảo mật, danh sách cấm-trong-xuất-bản |
| 10 | 10-gro-growth-standards.md | Growth data quality, milestone evidence, forecast labellingChất lượng dữ liệu tăng trưởng, bằng chứng cột mốc, gán nhãn dự báo |
| 11 | 11-cross-validation.md | Multi-character consistency, timeline sync, propagationNhất quán đa nhân vật, đồng bộ dòng thời gian, lan truyền |
| 12 | 12-domain-boundaries.md | No cross-domain writes; event bus only; Rule 12 is the fenceKhông ghi chéo miền; chỉ event bus; Rule 12 là hàng rào |
| 13 | 13-orc-workflow.md | Workflow tracks: MAT→PSY→CRE + GRO/EVL cascadesMạch workflow: MAT→PSY→CRE + cascade GRO/EVL |
| 14 | 14-cache-commit-standards.md | Verdict-labels-only cache; no raw profile bytes committedCache chỉ nhãn phán quyết; không byte hồ sơ thô được commit |
| 15 | 15-knowledge-graph.md | Graph usage, advisory-only signals, authoritative:false tagsSử dụng đồ thị, tín hiệu chỉ-tư vấn, nhãn authoritative:false |
| 16 | 16-distribution.md | No corpus in public pack; PII filter; character-agnosticKhông corpus trong gói công khai; lọc PII; character-agnostic |
| 17 | 17-evl-framework.md | EVL rubric schema, scorecard structure, verdict cache policySchema rubric EVL, cấu trúc scorecard, chính sách cache phán quyết |
The 4 built-in rubrics4 rubric tích hợp sẵn
Source: docs/rubrics/. Add your own to docs/rubrics/imported/ via evl:rubric-import.Nguồn: docs/rubrics/. Thêm rubric của bạn vào docs/rubrics/imported/ qua evl:rubric-import.
| RubricRubric | Use caseTrường hợp dùng | SkillSkill |
|---|---|---|
psychometric-big-five | Big Five + Dark Triad + attachment batteryBộ đo Big Five + Dark Triad + gắn bó | evl:standardize |
role-casting-fit | Casting / role suitability → CAST / CONDITIONAL / NOPhù hợp vai diễn → CAST / CONDITIONAL / NO | evl:fit |
clinical-risk-safety | Risk level scoring for content safety decisionsChấm mức rủi ro cho quyết định an toàn nội dung | evl:score |
relationship-compatibility | Dyad / pairing compatibility on key axesTương thích dyad / cặp đôi trên các trục chính | evl:compatibility |
venv & script invocationvenv & gọi script
All Python scripts under .claude/skills/ use the project venv. Never use the system Python — packages (google-genai, pypdf, etc.) are installed into the venv by install.sh.Mọi script Python dưới .claude/skills/ dùng venv dự án. Không bao giờ dùng Python hệ thống — các gói (google-genai, pypdf, v.v.) được cài vào venv bởi install.sh.
| CommandLệnh | PurposeMục đích |
|---|---|
.claude/skills/.venv/bin/python3 .claude/skills/{fw}-{skill}/scripts/{script}.py | Standard venv invocation for any framework skill scriptGọi venv chuẩn cho bất kỳ script skill framework nào |
bash .claude/skills/install.sh | Bootstrap the venv and install all required packagesKhởi tạo venv và cài tất cả gói cần thiết |
pytest -q -m 'not gemini' | Run the test suite (skip Gemini API tests — requires key)Chạy bộ test (bỏ qua test Gemini API — cần key) |
python3 e2e/run-full-pipeline.py | End-to-end pipeline smoke test (MAT→PSY→EVL→CRE)Smoke test quy trình đầu-cuối (MAT→PSY→EVL→CRE) |
python3 e2e/validate-all-against-schemas.py | Validate all rubrics + scorecards against JSON schemasValidate toàn bộ rubric + scorecard theo JSON schema |
TroubleshootingKhắc phục sự cố
Common failure modes and their fixes.Các chế độ lỗi phổ biến và cách sửa.
| SymptomTriệu chứng | CauseNguyên nhân | FixSửa |
|---|---|---|
ModuleNotFoundError | Running script with system Python, not venvChạy script với Python hệ thống, không phải venv | Run bash .claude/skills/install.sh then use .venv/bin/python3Chạy bash .claude/skills/install.sh rồi dùng .venv/bin/python3 |
Skill count drift vs CLAUDE.mdLệch số skill vs CLAUDE.md | Skill added/renamed without updating the catalogSkill được thêm/đổi tên mà không cập nhật catalog | Run orc:skill-stocktake; update docs/MODULES.md + CLAUDE.mdChạy orc:skill-stocktake; cập nhật docs/MODULES.md + CLAUDE.md |
| Stale knowledge-graph cacheCache đồ thị tri thức cũ | Profile files updated but graph not rebuiltFile hồ sơ được cập nhật nhưng đồ thị chưa rebuild | Run orc:graph --rebuild to refresh the SHA256 cacheChạy orc:graph --rebuild để làm mới cache SHA256 |
Publish gate blocking on [UNVERIFIED]Cổng xuất bản chặn vì [UNVERIFIED] | Claims without cited MAT-tier sources in the draftClaim không có nguồn MAT-bậc trích dẫn trong bản thảo | Run cre:evidence-scanner — add T1–T3 citations or remove the claimsChạy cre:evidence-scanner — thêm trích dẫn T1–T3 hoặc bỏ claim |
| Privacy-guard blocking publishPrivacy-guard chặn xuất bản | Draft contains data above the permitted privacy tierBản thảo chứa dữ liệu vượt bậc bảo mật được phép | Run cre:privacy-guard — strip clinical labels / DSM-ICD identifiersChạy cre:privacy-guard — tước nhãn lâm sàng / định danh DSM-ICD |
| Character not found at runtimeKhông tìm thấy nhân vật lúc runtime | characters.yaml missing or path misconfiguredcharacters.yaml bị thiếu hoặc đường dẫn cấu hình sai | Run orc:bootstrap — it resolves paths via characters.yaml + paths.pyChạy orc:bootstrap — nó phân giải đường dẫn qua characters.yaml + paths.py |
| e2e test fails on schema validationTest e2e thất bại khi validate schema | Rubric or scorecard structure does not match JSON schemaCấu trúc rubric hoặc scorecard không khớp JSON schema | Run evl:validate on the offending file; check .claude/schemas/Chạy evl:validate trên file lỗi; kiểm tra .claude/schemas/ |
💡
Want the why behind a row? Glossary for term definitions · Catalog for full skill descriptions · Finder to pick by intent · Gates & privacy for the publish gate model · Architecture for internals.
Muốn biết tại sao một dòng tồn tại? Glossary cho định nghĩa thuật ngữ · Catalog cho mô tả skill đầy đủ · Finder để chọn theo ý định · Gates & privacy cho mô hình cổng xuất bản · Architecture cho nội bộ.