Workflow AI cho phát triển HIS 4.0

AI có quy trình. Con người giữ quyền quyết định.

H4 giúp đội ngũ dùng AI theo một quy trình có kiểm soát: làm rõ yêu cầu, chọn hướng, lập kế hoạch, triển khai, review và bàn giao bằng artifact đọc lại được.

Cài H4 vào project HIS Xem cách H4 vận hành
skills 12+ Agent Skills
scope BE · FE · workflow
agent Anthropic Skills compatible
install Node-powered setup
Why H4?

Team Dev HIS 4.0 cần một cách dùng AI chung.

BMAD, Superpowers, ClaudeKit và nhiều bộ công cụ khác đã chứng minh giá trị của workflow, skill chuyên trách, planning và review. H4 học từ những thực hành đó, rồi tinh chỉnh cho công việc HIS 4.0 hằng ngày.

Bài toán của H4

Biến kinh nghiệm dùng AI của từng người thành năng lực chung của cả đội.

Đội ngũ không thiếu công cụ AI. Điều còn thiếu là một cách làm chung để AI hiểu đúng yêu cầu, để dev kiểm soát quyết định và để người khác có thể đọc lại toàn bộ ngữ cảnh khi tiếp tục công việc.

  1. 01
    Gọn cho việc hằng ngày
    Bug fix, mở rộng module, tối ưu và tích hợp đều đi theo quy trình vừa đủ.
  2. 02
    Có checklist rủi ro HIS
    Dữ liệu nghiệp vụ khám bệnh, viện phí, BHYT, dược, ký số, ... được hỏi đúng từ đầu.
  3. 03
    Không khóa vào một AI agent
    Skill là Markdown, artifact nằm trong project và có thể đọc lại bằng công cụ khác.
Lợi ích cho team

Team được gì ngay?

H4 không thay thế công cụ AI hiện có. H4 chuẩn hóa cách team dùng AI để giảm lệch yêu cầu, giảm code ngoài scope và giữ lại ngữ cảnh bàn giao.

  • Giảm hiểu sai yêu cầu trước khi mở code.
  • Giảm code lệch scope nhờ duyệt plan trước khi implement.
  • Có artifact bàn giao để người khác tiếp tục đúng ngữ cảnh.
  • Review trước khi ship, tập trung vào lỗi có thể gây sự cố thật.
Mục tiêu: biến kinh nghiệm dùng AI của từng người thành năng lực chung của cả đội.

Không sao chép một framework có sẵn, cũng không bắt đầu từ con số không

Các bộ kit/workflow nổi tiếng đã giải quyết rất tốt bài toán agentic development ở phạm vi rộng. H4 chọn phần hợp với HIS: rõ yêu cầu, plan trước code, review có gate và artifact đọc lại được.

Nguồn cảm hứng
BMAD Method
bmad-code-org/BMAD-METHOD Mã nguồn mở · MIT
Điểm học được là cách chia phase rõ ràng: phase trước tạo artifact, phase sau dùng lại làm context, rồi mới kiểm tra sẵn sàng để implement.
Nguồn cảm hứng
Superpowers
obra/superpowers Mã nguồn mở · MIT
Điểm học được là skill nên đóng vai trò dẫn dắt tiến trình: brainstorm, lập plan, kiểm chứng trước khi kết luận, tránh nói chắc khi chưa đủ căn cứ.
Nguồn cảm hứng
ClaudeKit
claudekit.cc Thương mại — Của người Việt
Điểm học được là cách tổ chức năng lực thành nhiều mảnh phối hợp: agents lo vai trò chuyên biệt, commands điều phối, skills bổ sung quy trình tái sử dụng.
H4 không thay thế các bộ công cụ này. H4 chuẩn hóa phần team HIS 4.0 cần dùng hằng ngày: workflow vừa đủ, checklist rủi ro HIS và artifact nằm ngay trong project.
01 / Workflow

Từ yêu cầu đến thay đổi đã sẵn sàng release.

Bắt đầu với h4-workflow. H4 đánh giá phạm vi và rủi ro, sau đó đưa công việc qua những skill cần thiết với quyết định của dev ở các điểm quan trọng.

  1. 01
    Clarify h4-clarify
    Biến yêu cầu còn mơ hồ thành phạm vi và tiêu chí hoàn thành có thể kiểm chứng.
  2. 02
    Brainstorm h4-brainstorm
    Thách thức ý tưởng đầu tiên, so sánh phương án và chọn hướng đơn giản khả thi nhất.
  3. 03
    Plan h4-plan
    Khóa phạm vi, file ownership, thứ tự thực hiện, xác minh và rollback trước khi code.
  4. 04
    Grill h4-grill
    Stress-test kế hoạch bằng các rủi ro HIS cụ thể và yêu cầu phương án giảm thiểu.
  5. 05
    Implement h4-implement
    Thực thi chính xác kế hoạch đã duyệt, viết code dễ bảo trì và xác minh bằng bằng chứng.
  6. 06
    Review h4-review
    Đối chiếu kế hoạch và truy tìm các lỗi có thể vượt qua CI nhưng gây sự cố production.
  7. 07
    Ship h4-ship
    Đóng công việc có kiểm soát với bàn giao, kiểm tra thông tin nhạy cảm trước khi commit và phê duyệt Git rõ ràng.
Đội hình workflow

Quy trình H4 giữ cho mỗi vai trò tham gia đúng chỗ, có gate rõ ràng và artifact đọc lại được.

Business Analyst Biến yêu cầu ban đầu thành phạm vi rõ ràng, có tiêu chí nghiệm thu và ràng buộc cần lưu ý. skill · h4-clarify
Solution Architect Tìm hướng giải pháp phù hợp, cân nhắc trade-off và thử phá plan trước khi viết code. skill · h4-brainstorm, h4-grill
Technical Lead Giữ scope không trôi, kiểm tra plan và chặn các rủi ro có thể ảnh hưởng production. skill · h4-plan, h4-review
Senior Software Engineer Implement theo plan, chứng minh bằng build/test và chuẩn bị handoff hoặc MR an toàn. skill · h4-implement, h4-ship
02 / Skills

Mỗi skill giải quyết một phần việc rõ ràng.

H4 chia skills thành 3 tầng: workflow điều phối công việc, utility giữ ngữ cảnh và chất lượng code, project conventions giúp AI viết đúng chuẩn HIS 4.0 BE/FE.

Tầng 1 · Workflow skills core
h4-workflow → clarify → brainstorm → plan → grill → implement → review → ship
Tầng 2 · Utility skills
h4-context Kiểm tra, cô đọng và phục hồi ngữ cảnh.
h4-clean-code Giữ code dễ hiểu, dễ bảo trì.
h4-commit Commit đúng chuẩn HIS 4.0: JIRA ID, tiếng Việt, conventional commit, kiểm tra dữ liệu nhạy cảm.
Tầng 3 · Project conventions
Backend · HIS 4.0 BE
h4-be-coding-style Layering, DTO/API, mapper và transaction.
h4-be-entity-lookup Xác minh entity, key, relationship và package trước khi viết code.
h4-be-crud-generator Scaffold Repository, Service, ServiceImpl và Controller theo base HIS 4.0.
h4-be-jpa-optimizer Tối ưu JPA/SQL có bằng chứng: N+1, projection, fetch shape và batch.
h4-be-sql-to-jpa-converter Chuyển Oracle PL/SQL sang Java/JPA, giữ logic gốc.
Frontend · HIS 4.0 FE
h4-fe-coding-style Angular, component boundary, form state, API integration và validation UX.
h4-fe-onehealth-ui Chọn đúng OneHealth UI component và wrapper @his4/common.
03 / Modes

Quy trình vừa đủ cho từng mức độ rủi ro.

H4 điều chỉnh độ sâu của quy trình theo từng công việc. Việc nhỏ giữ nhịp nhanh; thay đổi ảnh hưởng dữ liệu, nghiệp vụ hoặc môi trường vận hành được phân tích sâu hơn.

--quick
Quick
Nội dung, cấu hình, tinh chỉnh giao diện hoặc sửa đổi nhỏ có phạm vi rõ và rủi ro thấp.
rủi ro thấp
--standard
Standard
Luồng mặc định cho sửa lỗi, phát triển tính năng, tái cấu trúc và điều chỉnh tích hợp hàng ngày.
vừa phải
--hard
Hard
Công việc liên quan dữ liệu nghiệp vụ khám bệnh, viện phí, BHYT, dược, ký số, ...
cao · cần gate
--review-only
Review only
Đánh giá diff, commit, patch hoặc MR có sẵn; chỉ rõ vấn đề và mức độ ưu tiên xử lý.
chỉ đọc
04 / Install

Đưa H4 vào project trong vài phút.

Clone bộ kit một lần, sau đó dùng cùng installer cho các project microservices HIS 4.0 khác nhau. Không cần package manager, dependency hay bước build.

Node.js ≥ 18 Git cho auto-update Zero dependency Single-file installer
install.mjs / one-time setup
01
Clone kit một lần
$git clone https://scm.devops.vnpt.vn/his/his4/lib/his4-agent-kit.git ~/h4-kit
02
Vào project HIS cần sử dụng
$cd /path/to/his-project
03
Cài mới hoặc cập nhật
$node ~/h4-kit/install.mjs install
✓ Đã cài toàn bộ skills · lưu phiên bản · khởi tạo thư mục workflow
install cho cả cài mới và cập nhật
Installer tự nhận biết trạng thái project, cập nhật danh sách skill và lưu phiên bản đang sử dụng.
doctor kiểm tra tình trạng H4
Phát hiện skill bị thiếu, lệch phiên bản hoặc cấu hình project chưa đầy đủ.
remove gỡ cài đặt an toàn
Chỉ xóa các skill do H4 quản lý và mặc định giữ lại lịch sử công việc trong .ai-workflows/.
--local để thử phiên bản đang phát triển
Cài trực tiếp các skill trong máy vào project thử nghiệm mà không tải lại từ kho mã nguồn.

H4 không nhằm biến AI thành người viết code chính. H4 giúp dev dùng AI có kiểm soát hơn: quyết định rõ hơn, bàn giao đủ ngữ cảnh hơn và ship thay đổi có trách nhiệm hơn.

HIS 4.0 Agents Kit / chỉ dẫn thực tế, điểm kiểm soát rõ ràng, kết quả có thể kiểm chứng.

Bắt đầu

Mô tả công việc đầu tiên của bạn.

1. Cài H4 vào project HIS 4.0. 2. Chạy /h4-workflow với mô tả công việc. 3. Review artifact trước khi cho AI code.

$/h4-workflow "mô tả công việc HIS 4.0 của bạn" --standard
Explorer · billing_service
Mô phỏng một session OpenCode thực tế trên HIS 4.0 Backend — từ đọc code, tạo artifact, build, review đến ship và commit có kiểm soát.