hướng-dẫn-kiến-trúc-phần-mềm

SKILL.md

---
name: hướng-dẫn-kiến-trúc-phần-mềm
description: Áp dụng hướng dẫn kiến trúc phần mềm theo ngữ cảnh khi phân tích ranh giới hệ thống, yêu cầu chất lượng, giao tiếp, phong cách, quyết định, rủi ro hoặc sự phát triển.
---

# Hướng Dẫn Kiến Trúc Phần Mềm

Sử dụng bản nháp di động này để hỗ trợ công việc kiến trúc trên các lĩnh vực phần mềm. Nó không được cài đặt toàn cục. Cuốn sách cung cấp các khái niệm và sự đánh đổi; hướng dẫn này vận hành chúng dưới dạng các kiểm tra điều kiện. Chúng không phải là lệnh dự án hay thay thế cho ý định người dùng, quản trị địa phương hoặc bằng chứng hệ thống đã biết.

## Quy trình làm việc

1. **Xác lập bối cảnh và quyền hạn.** Xác định lĩnh vực, ranh giới hệ thống, kết quả kinh doanh, các ràng buộc về triển khai và dữ liệu, năng lực đội nhóm, bằng chứng đã biết, những điều chưa biết và quyền quyết định. Tôn trọng quyền hạn đã được ủy quyền. Chỉ hỏi những sự thật còn thiếu có thể thay đổi kết quả; nếu không thì đưa ra khuyến nghị có điều kiện.
2. **Xếp hạng các yếu tố thúc đẩy.** Chuyển đổi kết quả của các bên liên quan thành các đặc tính kiến trúc. Kiểm tra từng ứng viên theo định nghĩa ba phần, phân rã các đặc tính tổng hợp và ưu tiên một tập nhỏ.
3. **Lập bản đồ ranh giới và dữ liệu.** Xác định trách nhiệm chức năng, phụ thuộc, giao dịch, quyền sở hữu dữ liệu, liên kết tĩnh, các cuộc gọi thời gian chạy và đặc tính tại mỗi ranh giới liên quan.
4. **So sánh tỷ lệ.** Đối với một lựa chọn quan trọng, so sánh ít nhất hai phương án khả thi dựa trên các ưu tiên, chi phí, rủi ro và bằng chứng đã nêu. Không ép buộc so sánh chính thức cho thay đổi nhỏ, có thể đảo ngược.
5. **Quyết định với lý do.** Nêu rõ khuyến nghị hoặc trạng thái, lý do phù hợp, chi phí chấp nhận, giả định và bằng chứng nào sẽ khiến xem xét lại. Tuân theo quyền hạn được ủy quyền; không tự tạo ra các cổng phê duyệt.
6. **Chỉ định các kiểm tra.** Chọn các biện pháp hoặc hàm đánh giá phù hợp với mức độ rủi ro. Đặt tên phạm vi, tín hiệu, giới hạn và phản ứng của chúng.

## Quy tắc cốt lõi

- Dựa trên bối cảnh ([quy tắc bối cảnh và ưu tiên](references/rulebook.md#context-priorities): F01) và tôn trọng quyền hạn được ủy quyền ([quy tắc quyết định, rủi ro và phát triển](references/rulebook.md#decisions-risk-evolution): D03).
- Rút ra và xếp hạng các đặc tính từ kết quả đo lường được của các bên liên quan ([quy tắc bối cảnh và ưu tiên](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- Giữ trách nhiệm gắn kết và ranh giới trung thực về phụ thuộc và liên kết ([quy tắc ranh giới](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [bảng thuật ngữ](references/glossary.md)).
- Chọn cách giao tiếp phù hợp cho công việc; phân biệt yêu cầu, lệnh và sự kiện, và thiết kế cho thất bại ([quy tắc giao tiếp](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- Xem các kiểu kiến trúc như các lựa chọn có điều kiện và so sánh chi phí của chúng ([quy tắc kiểu](references/rulebook.md#style-choice): S01, S16, D06; [hướng dẫn kiểu](references/style-selection.md)).
- Ghi lại lý do tồn tại các quyết định quan trọng và điều gì sẽ thay đổi chúng ([đánh đổi](references/rulebook.md#context-priorities): F02; [hồ sơ quyết định](references/rulebook.md#decisions-risk-evolution): F03).
- Làm cho rủi ro, sự không chắc chắn và sự phù hợp trong triển khai trở nên rõ ràng ([quy tắc rủi ro và phát triển](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- Quản lý các ràng buộc quan trọng bằng các kiểm tra mà mọi người hiểu ([quy tắc quản trị](references/rulebook.md#decisions-risk-evolution): F09, F10).
- Bảo tồn lựa chọn của đội trong quyền hạn và ràng buộc thực tế ([quy tắc đội và giao tiếp](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- Áp dụng hướng dẫn cụ thể nhà cung cấp chỉ khi dự án bao gồm nhà cung cấp mô hình ([D15 trong rules.json](references/rules.json)).

## Hợp đồng đầu ra

Trả về: bối cảnh và những điều chưa biết; khuyến nghị và trạng thái; các phương án thay thế và chi phí; tác động ranh giới, dữ liệu và giao tiếp; bằng chứng và kiểm tra; và kích hoạt xem xét lại. Mở rộng chi tiết theo mức độ quan trọng của lựa chọn.

## Tham khảo

Đối với một nhiệm vụ, chỉ tải danh mục liên quan trong [rules.json](references/rules.json) hoặc đọc phần tương ứng trong [rulebook.md](references/rulebook.md), không cả hai hoặc toàn bộ bộ tài liệu. Tải [style-selection.md](references/style-selection.md) cho chín kiểu, [glossary.md](references/glossary.md) cho các thuật ngữ dựa trên nguồn, và [source-map.json](references/source-map.json) để định vị các chương được trích dẫn. Các câu lệnh đánh giá tổng hợp có trong [evaluation-cases.json](references/evaluation-cases.json); chúng chưa được chạy. Phương pháp và giới hạn có trong [method-and-validation.md](references/method-and-validation.md).