Files
solution-erp/.claude/skills
pqhuy1987 9b3c0edba3
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 9m6s
[CLAUDE] Docs: S189 bookstart L15 TRỌN 1 lượt (YC-018/YC-027) — 12 vai/5 vòng + vá 7 bề mặt + 2 RCA + PN-002
Nghi-thức mở phiên chạy trọn một lượt sau khi owner bắt lỗi lead dừng ở BƯỚC 0.7(b)
hỏi consent trong khi PN-001/YC-026/YC-027 đã chốt từ lượt trước (→ PN-002, YC-027 nhắc 1→2).

Vòng @open — 12 vai, 8/12 lượt return dính #53, 0 byte mất (artifact-first vào LỆNH GỐC):
- V1 tooling PASS_WITH_FLAGS-7 + harvest GATE-FAIL-5 → ring1 26Đ/4T/6KC trên 36 claim
- V2 stale 11 FLAG + gap 7 FLAG (deep) → ring2 7Đ/3T/14KC trên 24, enum-gate 18/18
- V3 trio eval MIXED 38-trục/13-REGRESSION → refine 2-action/16-BÁC → audit 24Đ/7T/4KC (98 số byte-exact)
- V4 shard IM ⇒ NO-OP có khai · V5 detector 58+26 INFORM
- Khối chấm điểm → KHÔNG ĐO ĐƯỢC (A8 cấm in điểm; tầng-3 bác phép đếm tầng-2, tầng-1 0 lỗi)
- Phase 3.5 _mind-s-15 block-0 qua mind-check 10/0 → ctx-audit TRUOT 5 FLAG

Vá bề mặt (đều do đội bắt, lead đo lại từng cái):
- CLAUDE.md:77 KHKK 69,71 → 69,71,72 (ring1 phán ef-core-migration/SKILL.md là DƯƠNG-GIẢ ⇒ 1 chỗ là đủ)
- contract-workflow/SKILL.md: "cầu KHKK→HĐ (W5) chưa làm" → ĐÃ LÀM b275893c; giữ vế liên-danh N-HĐ còn nợ THẬT
- WAL: gỡ cụm gộp *conversation tiếp tục* với *phiên-LOGIC chưa khép* (_end L14, 6 bề mặt chọi 1); C5 39/40 OK
- HANDOFF: lật 3 mục NEXT-em đã land ef1d4fbb (harvest-curator 21.308 · reviewer 85,7% · measured 30 row 29/29)
- error-ledger +2 RCA: SCORE-T2-S189 (tầng-2 sai L1+L2) · H24-RESET-S189 (máy gộp đo-ra-0 với không-đo-được)
- tally H24 18 class nấc deep ⇒ deep 1/1 OVERDUE → 0/1 ok; orphan run-folder 0

Load-bearing: ring5 = 0 hit session-start.md ⇒ guard RCA ONESHOT-S188 không fire được ở cửa MỞ ·
YC-027 land 2/4 cửa (tiep/pause = 0) ⇒ cần phép kiểm ĐỦ-CỬA · byte⟂ký-tự: theo ký-tự 0/29 vai
vượt (max 96,5%) ⇒ cảnh báo "2 over-cap" kêu oan (câu 76) · CẤM chạy PROPOSE archive cho
ring2-audit (move-set = {Role baseline, Runs} ⇒ xoá thước của vai KIỂM).

Squash 16 commit wal: trailing chưa-push theo §5.0 (mark RC-pqhuy1987-15-07-2026-15-32-20).
Docs-only ⇒ CI path-filter skip, không deploy.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 01:24:27 +07:00
..
2026-07-31 21:47:23 +07:00

Skill Library — SOLUTION_ERP

Skill này là tài liệu chuyên biệt để Claude (và developer khác) dùng khi cần deep-dive 1 domain area. Claude tự động invoke qua Skill tool dựa trên semantic matching với description trong từng SKILL.md.

Skills hiện có

Domain skills (logic nghiệp vụ)

Skill Mục đích Trigger ví dụ Trạng thái
contract-workflow State machine 9 phase + versioned workflow per ContractType + role × phase guard + SLA + auto-gen mã HĐ RG-001 "approve contract", "chuyển phase", "versioned workflow", "HĐ cũ giữ cũ" Tier 3 + Phase 6 cross-ref PE workflow
form-engine Render template docx/xlsx + FieldSpec JSON + DynamicForm + PDF export LibreOffice "export contract as word", "điền form", "render template", "PDF export" Active
permission-matrix Role × MenuKey × CRUD + seed + 3-layer resolution + inherit Contracts/Workflows/PurchaseEvaluations "permission denied", "gán role", "menu không hiện", "inherit permission" Active (Phase 6 +Pe_/PeWf_)

Ops/infra skills (devops + security + schema)

Skill Mục đích Trigger ví dụ Trạng thái
dependency-audit-erp Scan CVE NuGet + npm 2 FE, respect pin constraint (MediatR 12.4.1, Swashbuckle 6.9.0) "npm audit", "dotnet vulnerable", "deps scan", "nâng cấp package" New Tier 3
ef-core-migration Tạo/revert EF Core 10 migration, 3-file rule, DesignTimeDbContextFactory, migration history (mới nhất → row cuối bảng skill; số → docs/STATUS.md) "thêm migration", "EF migration", "schema update", "snapshot lỗi" Updated S168 (ff7f655) · nội-dung tới row Mig cuối hiện hành — soát @S172; số bảng + số Mig → docs/STATUS.md (B1, KHÔNG neo số ở ô này)
iis-deploy-runbook 3 IIS site + win-acme cert + gitea-runner + LibreOffice + debug 500/502/SignalR prod + G-084 IPv4/IPv6 hardening "prod 500", "IIS fail", "cert hết hạn", "restart app pool", "deploy IIS", "port hijack" Updated (G-084)

Format chuẩn 1 skill

Mỗi skill là 1 folder với ít nhất SKILL.md + optional examples/ + references/:

.claude/skills/<skill-name>/
├── SKILL.md                  ← Entry point: description, when-to-use, workflow
├── examples/                 ← Code snippets mẫu (optional)
│   └── *.cs | *.tsx
└── references/               ← Link đến file code thật, docs (optional)

Frontmatter SKILL.md (BẮT BUỘC when-to-use để skill auto-trigger):

---
name: skill-name-kebab-case
description: 1-3 câu mô tả skill làm gì + stack specificity (để embedding match chính xác)
when-to-use:
  - "trigger phrase 1"
  - "trigger phrase 2"
  - "keyword tiếng Việt"
---

# Skill Name

## Context
...

## Workflow / Commands
...

## Pitfalls
...

## Code pointers
- `path/to/file.cs`

Tạo skill mới — checklist

  1. Tạo folder .claude/skills/<kebab-case-name>/
  2. Viết SKILL.md với frontmatter + sections: Context / Workflow / Code pointers / Common pitfalls
  3. Add row vào bảng "Skills hiện có" phía trên
  4. Update docs/CLAUDE.md (dòng skill count)
  5. Commit [CLAUDE] Skill: add <name>

Nguyên tắc design skill

PROJECT-SPECIFIC, không clone generic:

  • Skill user-level global đã có sẵn (code-reviewer, sql-database-assistant, focused-fix, ...)
  • Skill project-level phải encode kiến thức SOLUTION_ERP-only mà generic không có:
    • Commit convention [CLAUDE] <scope>: ...
    • Path pattern src/Backend/SolutionErp.*/...
    • Pin constraint (MediatR 12.4.1, Swashbuckle 6.9.0, TypeScript 6 erasableSyntaxOnly)
    • Gotcha-referenced (dẫn chiếu docs/gotchas.md#N)
    • Workflow Vietnamese-first

Keep it actionable:

  • Commands copy-pastable (không pseudocode)
  • Paths đầy đủ (không src/...)
  • Version pinned (không "latest")
  • Dẫn chiếu gotcha/migration # cụ thể
  • docs/CLAUDE.md — quick rules + full stack context
  • docs/gotchas.md — bẫy đã gặp (số + các mục mới nhất → docs/STATUS.md — B1, KHÔNG chép digest ở đây: bản sao thối im lặng, gỡ @S172 sau khi đo lệch 7 mục)
  • docs/changelog/migration-todos.md — roadmap 5 phase + Tier 3