genneral/sys-analysis-design
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update skill and docs

Browse Source
This commit is contained in:
Canhchimlac
2026-09-22 13:46:36 +07:00
parent 343ad8bbbc
commit 51506aabc7
149 changed files with 43752 additions and 300 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.claude/skills/sa-lifecycle/SKILL.md
View File

@@ -71,7 +71,9 @@ Gate đang chặn: AG2 — thiếu QAS (7/9 NFR còn định tính), thiếu SEC
| Kiểm | Cách kiểm | Lệch thì sao |
|---|---|---|
| BA `NFR` ↔ SA `QAS` | Mỗi `NFR-*` của BA có `QAS-*` tương ứng đã lượng hoá chưa | Ghi `OQ`, `QAS` thắng |
| BA `API` ↔ SA `ICD` | Endpoint trong `API` có trong `ICD` không, kiểu dữ liệu có khớp không | Ghi `OQ`, `ICD` thắng |
| BA `API` ↔ SA `ICD`/`CTR` | Endpoint trong `API` có `IF-nnn` và `operationId` trong file OpenAPI của `CTR` không | Ghi `OQ`, file contract thắng |
| BA `SRS` bảng field ↔ SA `PDM` | Mỗi `FLD-*` có cột cùng kiểu/độ dài/null | Ghi `OQ`, hai bên sửa cho khớp, chặn AG2 |
| BA `BR` ↔ SA `DOM` | Mỗi `BR` ràng buộc dữ liệu/tính toán có class kiểm invariant | Thiếu ⇒ `DOM` bổ sung hoặc `OQ` cho BA |
| BA `RBAC` ↔ SA `SEC` | Mỗi `ROLE-nn` map được xuống cơ chế authz chưa | Ghi `OQ`, chặn AG2 |
| BA `BR` ràng buộc kiến trúc | `BR` nào ép consistency/audit/retention đã có `ADR` chưa | Thiếu ⇒ đề xuất ADR |
@@ -131,8 +133,8 @@ Khi người dùng nói "review toàn bộ tài liệu kiến trúc":
| Người dùng nói gì | Skill |
|---|---|
| "chọn công nghệ gì", "so sánh phương án", "ước lượng chi phí hạ tầng", "rủi ro kỹ thuật" | `sa-1-context` |
| "vẽ kiến trúc", "thiết kế hệ thống", "chốt NFR", "thiết kế API/dữ liệu/bảo mật/hạ tầng", "viết ADR" | `sa-2-architecture` |
| "chuẩn code", "dev hỏi thiết kế", "review thiết kế", "kiểm thử kiến trúc", "nợ kỹ thuật" | `sa-3-enablement` |
| "vẽ kiến trúc", "thiết kế hệ thống", "chốt NFR", "thiết kế API/dữ liệu/bảo mật/hạ tầng", "viết ADR", "class diagram", "OpenAPI/AsyncAPI", "schema vật lý", "DDL", "migration" | `sa-2-architecture` (`dom`/`ctr`/`pdm`) |
| "bàn giao cho dev", "dev cần đọc gì", "chuẩn code", "dev hỏi thiết kế", "review thiết kế", "kiểm thử kiến trúc", "nợ kỹ thuật" | `sa-3-enablement` (`handoff` trước) |
| "hệ thống chạy có đạt không", "tối ưu chi phí", "roadmap kỹ thuật", "post-mortem" | `sa-4-evolution` |
| "có quyết định nào chưa ghi không", "kiểm tra coverage", "ADR nào lỗi thời" | `sa-conformance` |
| "yêu cầu nghiệp vụ", "user story", "acceptance criteria", "UAT" | ⟶ bộ `ba-*`, không phải SA |