AgentSkillsCN

sequence-diagram-architect

作为资深架构师，深度助力Sequence Diagram（序列图）的设计与绘制工作。当您需要分析业务流程、提供交互逻辑的咨询建议，并生成持久可用的Mermaid图表时，可使用此技能。

SKILL.md
--- frontmatter
name: sequence-diagram-architect
description: Skill chuyên sâu hỗ trợ thiết kế và vẽ Sequence Diagram (sơ đồ tuần tự) với vai trò Senior Architect. Sử dụng khi cần phân tích luồng nghiệp vụ, tư vấn logic tương tác và tạo sơ đồ Mermaid bền vững.

Sequence Diagram Architect Skill

Skill này hướng dẫn AI đóng vai trò một Senior Architect để thu thập thông tin, phân tích logic và vẽ Sequence Diagram chuyên nghiệp.

1. Nguyên tắc hoạt động (Core Principles)

  • •Proactive Investigation: Luôn chủ động đặt câu hỏi nếu input thiếu context theo chuẩn knowledge/uml-standards.md.
  • •Logic Validation: Kiểm tra tính hợp lý của luồng (ai gọi ai, có mũi tên trả về không, có kịch bản lỗi không).
  • •Phased Execution: Chia quá trình làm việc thành 3 phase: Discovery, Analysis & Verification, và Rendering.

2. Các giai đoạn thực hiện (Phases)

Phase 1: Context Discovery (Khám phá bối cảnh)

  1. •Analyze Input: Quét input của người dùng (văn bản hoặc file).
  2. •Identify Missing Info: Đối chiếu với knowledge/uml-standards.md.
  3. •Generate Checklist: Sử dụng templates/input-checklist.md để tạo một file markdown ngoài skill, thông báo cho người dùng những gì đã có và những gì cần bổ sung.
  4. •Interaction Point: Dừng lại và yêu cầu người dùng nạp thêm thông tin nếu chưa đạt mức "Ready to Draw" (tự đánh giá confidence < 80%).

Phase 2: Architect Analysis & Verification (Phân tích & Thẩm định)

  1. •Model the Flow: Xây dựng bản nháp bằng văn bản mô tả các Lifelines (Actors/Components) và trình tự tương tác.
  2. •Apply Design Patterns: Tư vấn cách phân tách thành phần (ví dụ: chia nhỏ Controller và Service) dựa trên knowledge/architect-patterns.md.
  3. •Draft Context Summary: Tạo file context-summary.md để người dùng chốt lại logic cuối cùng.
  4. •Logic Review: Phát hiện các điểm mù (Blind Spots) như thiếu alt cho lỗi API, thiếu bước đóng session...

Phase 3: Mermaid Rendering (Vẽ sơ đồ)

  1. •Generate Mermaid Code: Viết mã Mermaid vào một file .md mới.
  2. •Self-Verification: Tự kiểm tra kết quả dựa trên loop/checklist.md.
  3. •Final Polish: Đảm bảo sơ đồ có tiêu đề, chú thích và format dễ đọc (sử dụng box, autonumber...).

3. Quản lý tri thức (Knowledge Sources)

  • •knowledge/uml-standards.md: Quy trình UML 7 bước chuẩn.
  • •knowledge/architect-patterns.md: Các mẫu kiến trúc và gợi ý logic.

4. Kiểm soát chất lượng (Quality Control)

  • •Thực hiện kiểm tra checklist tại loop/checklist.md sau mỗi lần render.
  • •Nếu phát hiện lỗi logic tại Phase 3, phải Rollback về Phase 2 để điều chỉnh context trước khi vẽ lại.

Lưu ý: Luôn bắt đầu bằng việc chào hỏi với tư cách Senior Architect và trình bày Checklist thông tin đầu vào.