Bỏ qua tới nội dung
Ông T.vn

aidlc-workflows: quy trình AI viết code có kiểm soát — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về awslabs/aidlc-workflows — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: aidlc-workflows: AI viết code theo quy trình có duyệt từng bước — hướng dẫn cài đặt và dùng →

aidlc-workflows: quy trình AI viết code có kiểm soát — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

aidlc-workflows là bộ quy trình và luật điều hướng AI-DLC do AWS Labs phát hành, biến trợ lý AI lập trình thành một quy trình giao phần mềm có cấu trúc, có bước duyệt của con người. Bạn cài bằng một dòng lệnh, chọn công cụ đang dùng rồi gõ /aidlc kèm yêu cầu. Cài đặt không khó, kể cả khi máy chưa có Node hay Bun.

aidlc-workflows là một bộ quy trình làm việc (workflow) cho các trợ lý AI lập trình, do AWS Labs phát hành. Thay vì bạn ra lệnh rồi để AI tự làm một mạch, bộ này ép AI đi qua các giai đoạn rõ ràng: hiểu yêu cầu, thiết kế, viết code, kiểm thử, rồi vận hành. Ở mỗi chặng quan trọng, AI dừng lại chờ bạn duyệt.

Vấn đề nó giải quyết rất quen thuộc. Khi dự án lớn dần, AI hay “quên” bối cảnh: yêu cầu một đằng, code một nẻo, test không khớp quyết định ban đầu. AI-DLC giữ yêu cầu, quyết định, code, test và vận hành nối với nhau trong một vòng đời có ghi lại đầy đủ. Repo hiện có khoảng 6062 sao và 1080 fork, giấy phép MIT-0.

Bạn nên đọc bài này nếu đang dùng (hoặc muốn thử) Claude Code, Kiro, Codex CLI, Cursor, opencode hay GitHub Copilot và muốn AI làm việc có kỷ luật hơn. Điểm đáng giá nhất: một lõi duy nhất chạy được trên cả bảy công cụ đó, nên bạn đổi công cụ vẫn giữ nguyên cách làm việc. Xem video ngắn bên dưới để thấy nhanh cách nó chạy, rồi quay lại đây làm theo từng bước.

Framework

awslabs/aidlc-workflows

Bộ quy trình AI-DLC của AWS Labs giúp trợ lý AI lập trình làm việc theo từng giai đoạn, có cổng duyệt, chạy trên Claude Code, Kiro, Codex, Cursor, Copilot.

★ 6.1kTypeScriptMIT-0
Xem repo trên GitHub
Video giới thiệu aidlc-workflowsXem trên YouTubeXem trên Facebook

I.aidlc-workflows làm được gì

Theo README, repo gồm một “lõi” trung lập (không phụ thuộc công cụ nào) và các lớp mỏng riêng cho từng công cụ. Những thứ bạn nhận được:

A.Quy trình có giai đoạn rõ ràng

Có 5 giai đoạn và 33 bước, từ khởi tạo đến vận hành. Lợi ích thực tế: bạn không phải tự nhớ “đã làm phân tích chưa, đã viết test chưa”. Quy trình nhắc và dẫn đường thay bạn.

B.Nhiều “nhân sự” AI chuyên trách

Bộ này có 14 agent: 11 chuyên gia theo lĩnh vực, 2 người rà soát (reviewer) và một agent “composer” tự thích ứng. Việc chia vai giúp mỗi phần được xem xét từ đúng góc nhìn, thay vì một AI ôm hết.

C.11 hồ sơ quy trình theo loại việc

Có sẵn hồ sơ cho tính năng mới, sửa lỗi, hạ tầng, bảo mật, bản thử nghiệm (proof of concept), giao hàng cho doanh nghiệp… Bạn chỉ mô tả việc cần làm, AI-DLC tự chọn quy trình hợp, hỏi lại những quyết định còn thiếu. Việc nhỏ không bị ép đi quy trình nặng nề.

D.Cổng duyệt của con người

AI dừng ở các “cổng duyệt” trước khi đi tiếp. Với người không chuyên code, đây là phần quan trọng nhất: bạn vẫn là người quyết định, AI không tự ý đi xa.

E.Nhật ký kiểm toán và bộ nhớ

README ghi có 134 loại sự kiện được ghi lại, cùng trạng thái lưu bền, kiến thức của nhóm và các quy tắc học được. Nhờ vậy làm lại hôm sau hay đổi người làm, bối cảnh vẫn còn.

F.Một công cụ dòng lệnh aidlc

Bộ cài đặt đặt lệnh aidlc vào máy. Lệnh này dùng để cấu hình dự án (aidlc config) và kiểm tra tình trạng (aidlc doctor).

II.Cần chuẩn bị gì

Chỉ những gì README nói:

  • Hệ điều hành: macOS, Linux, WSL, hoặc Windows (dùng PowerShell).
  • Một công cụ AI lập trình bạn đã dùng được. Bản tối thiểu README nêu: Kiro IDE từ 1.1.70 hoặc Kiro CLI từ 2.24.1 (cho engine v3); Kiro CLI (V2) từ 2.6; Codex CLI từ 0.145.0; opencode từ 1.18.29; GitHub Copilot CLI từ 1.0.74 hoặc VS Code từ 1.130. Với Claude Code và Cursor, README không ghi số phiên bản tối thiểu.
  • Không cần cài Bun hay Node.js nếu cài theo cách thông thường. Chỉ khi chọn cách “copy thủ công” thì mới cần Bun.
  • Mô hình AI: README khuyên dùng mô hình có khả năng suy luận tốt; mô hình đang được khuyến nghị là Claude Opus 4.8. Phần chọn nhà cung cấp mô hình do công cụ bạn dùng lo, không phải AI-DLC.
  • Amazon Bedrock: chỉ cần nếu bạn chọn dùng Bedrock. Khi đó phải bật mô hình và có thông tin đăng nhập AWS hợp lệ. Kiro thì không cần bước này vì quyền dùng mô hình đi kèm Kiro.

AI sinh ra có thể sai, và việc chạy mô hình có thể tốn tiền. README nhắc bạn xem lại kết quả và chi phí trước khi dùng. Lệnh cài ở dưới tải script từ internet rồi chạy ngay, nên chỉ chạy khi bạn tin nguồn (ở đây là trang release chính thức của repo).

III.Cài đặt từng bước

  1. Cài aidlcChạy một dòng lệnh cài đặt theo hệ điều hành
  2. Vào thư mục dự ánMở terminal ngay tại gốc dự án của bạn
  3. Cấu hình công cụChạy aidlc config với tên công cụ bạn dùng
  4. Kiểm traChạy aidlc doctor
  5. Bắt đầuMở công cụ AI và gõ /aidlc kèm yêu cầu

A.Bước 1: Cài đặt AI-DLC

Chọn đúng dòng cho hệ điều hành của bạn. Trên macOS, Linux hoặc WSL, mở Terminal và chạy:

Terminal
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh

Trên Windows, mở PowerShell bình thường và chạy:

PowerShell
irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex

Bộ cài đặt lệnh aidlc cùng toàn bộ phần chạy cho các công cụ. Vài chỗ người mới hay vấp:

  • Trên Windows, hãy mở PowerShell thường, đừng chọn “Run as administrator”. Chạy bằng quyền quản trị bị README cảnh báo là kém an toàn nên sẽ hiện cảnh báo và hỏi lại.
  • Bộ cài tự thêm thư mục chứa aidlc vào PATH của tài khoản Windows hiện tại. Nếu terminal khác chưa nhận lệnh, hãy mở terminal mới.
  • Muốn bỏ qua việc sửa PATH trên Windows, README có cờ -NoModifyPath.
  • Trên macOS, Linux hoặc WSL, nếu bộ cài in ra hướng dẫn về PATH thì làm theo đúng hướng dẫn đó.

Nếu bạn không cài được file chạy gốc hoặc muốn tự quản lý file dự án, README có đường “copy thủ công”: cài Bun, tải file aidlc-copy-runtime-X.Y.Z.tar.gz từ trang release mới nhất, rồi chép nguyên thư mục runtime/<harness>/ vào dự án. Cách này không cần lệnh aidlc. Với người mới, mình khuyên đi đường cài tự động ở trên.

B.Bước 2: Vào thư mục dự án

Mở terminal và đi tới thư mục gốc của dự án bạn muốn AI làm việc. Đây là chỗ nhiều người sai: cấu hình sẽ được ghi vào thư mục hiện tại, nên đứng sai thư mục là cấu hình sai chỗ.

Terminal
cd /path/to/your-project

Thay /path/to/your-project bằng đường dẫn thật tới dự án của bạn.

C.Bước 3: Cấu hình theo công cụ bạn dùng

Ví dụ với Claude Code:

Terminal
aidlc config --harness claude

Thay claude bằng một trong các giá trị: kiro, kiro-v2, codex, cursor, opencode, copilot. Ghi nhớ nhanh theo bảng của README:

  • Claude Code dùng claude, mở bằng lệnh claude, gọi bằng /aidlc.
  • Kiro (IDE hoặc Kiro CLI v3) dùng kiro.
  • Kiro CLI bản V2 dùng kiro-v2.
  • Codex CLI dùng codex, mở bằng codex, gọi bằng $aidlc (có dấu đô la, không phải dấu gạch chéo).
  • Cursor dùng cursor; opencode dùng opencode; GitHub Copilot dùng copilot.

Nếu chạy aidlc config mà không có --harness và đang ở trong terminal, công cụ sẽ mở phần cài đặt tương tác để bạn chọn dần.

Lưu ý riêng cho Kiro IDE: nếu bạn mở thư mục chưa tin cậy trong terminal của Kiro, Kiro sẽ hỏi có tin thư mục không. Chỉ chọn Trust Folder & Continue với dự án của chính bạn hoặc dự án bạn đã kiểm tra, vì tin cậy nghĩa là các hook trong thư mục .kiro được phép chạy lệnh trên máy bạn. Không chắc thì chọn Cancel và xem lại thư mục trước.

D.Bước 4: Kiểm tra bằng doctor

Terminal
aidlc doctor

Lệnh này kiểm tra tình trạng cài đặt. README cũng khuyên chạy nó đầu tiên mỗi khi gặp sự cố.

E.Bước 5: Mở công cụ AI và bắt đầu

Mở công cụ bạn đã chọn trong thư mục dự án (ví dụ gõ claude), rồi mô tả việc cần làm:

text
/aidlc Build a REST API for inventory management

Với Codex CLI, dùng $aidlc thay cho /aidlc. Với Kiro IDE, trước tiên hãy chọn aidlc trong bộ chọn agent ở khung chat. Câu lệnh mẫu trong README viết bằng tiếng Anh; README không nói gì về việc dùng tiếng Việt, nên nếu bạn gõ tiếng Việt, hãy tự thử và xem kết quả.

IV.Kiểm tra đã chạy được chưa

Có ba dấu hiệu theo tư liệu:

  • Lệnh aidlc doctor chạy xong mà không báo lỗi. README không mô tả chính xác màn hình kết quả, nên nếu có cảnh báo, hãy đọc kỹ nội dung và đối chiếu với phần Troubleshooting trong tài liệu của dự án.
  • Gõ /aidlc (hoặc $aidlc với Codex) trong công cụ AI được nhận ra như một lệnh của AI-DLC.
  • Khi bạn mô tả việc cần làm, AI-DLC chọn một quy trình phù hợp, hỏi những quyết định còn thiếu, và dừng ở cổng duyệt trước khi đi tiếp. Nếu AI cứ làm một mạch không hỏi gì, rất có thể cấu hình chưa đúng thư mục.

V.Dùng vào việc thật

Bối cảnh dưới đây là ví dụ minh hoạ dựa trên khả năng README mô tả (hồ sơ quy trình cho tính năng, sửa lỗi, hạ tầng, bảo mật, thử nghiệm). Kết quả thực tế phụ thuộc mô hình và công cụ bạn dùng.

A.Chủ shop muốn có hệ thống quản lý kho đơn giản

Bạn bán hàng online, thuê một bạn lập trình viên mới ra trường, hai người cùng dùng Claude Code. Thay vì giao một câu “làm cho anh cái app kho”, bạn gõ câu mẫu của chính README:

text
/aidlc Build a REST API for inventory management

AI-DLC chọn quy trình, hỏi các điểm còn thiếu (ví dụ cần quản lý những gì), rồi dừng ở cổng duyệt. Bạn đọc, đồng ý hoặc sửa, rồi mới cho đi tiếp. Kết quả là bạn hiểu mình đang được làm gì, thay vì nhận về một đống code không ai giải thích.

Cái đáng tiền nhất của AI không phải là viết nhanh, mà là biết dừng lại hỏi bạn đúng lúc.

Ông T

B.Lập trình viên mới sửa lỗi trong dự án có sẵn

Bạn vừa vào một dự án và được giao sửa lỗi. Chạy aidlc config --harness cursor (hoặc công cụ bạn đang dùng) ở thư mục dự án, rồi mô tả lỗi sau /aidlc. Vì có hồ sơ quy trình cho việc sửa lỗi, AI đi theo luồng phù hợp thay vì viết lại cả tính năng. Các quyết định được ghi lại, nên đồng nghiệp xem lại sẽ hiểu vì sao sửa như vậy.

C.Nhóm nhỏ dùng nhiều công cụ AI khác nhau

Trong nhóm, người thích Claude Code, người thích Cursor, người dùng GitHub Copilot. Vì AI-DLC dùng chung một lõi, mỗi người chạy aidlc config --harness với công cụ của mình trong cùng dự án và vẫn làm theo cùng một quy trình, cùng cổng duyệt. Đây là điểm khác biệt lớn so với việc mỗi người tự viết một bộ prompt riêng.

D.Người phụ trách quy trình muốn kiểm soát và truy vết

Bạn làm quản lý và cần biết AI đã làm gì, duyệt ở đâu. Nhật ký kiểm toán và bằng chứng rà soát gắn với nguồn giúp bạn xem lại các quyết định. README có tài liệu riêng (Harness Engineer Guide) cho việc chỉnh các bước, agent, quy tắc theo ý tổ chức; đây là phần dành cho người đã quen cơ bản.

VI.Lỗi hay gặp và cách xử lý

Luôn bắt đầu bằng cách chạy aidlc doctor ở thư mục gốc dự án. Các lỗi README liệt kê:

A.Báo không tìm thấy lệnh aidlc

Trên Windows, hãy tắt hẳn rồi mở lại ứng dụng terminal hoặc IDE. Một tab mới trong cửa sổ đã mở từ trước khi cài vẫn giữ PATH cũ. Trên macOS, Linux hoặc WSL, làm theo hướng dẫn PATH mà bộ cài đã in ra.

B.Phiên bản dự án và phần chạy bị lệch

Chạy lại aidlc config ở thư mục dự án để đồng bộ.

C.Codex không chạy hook

Bạn cần tin cậy (trust) các hook của dự án theo hướng dẫn trong tài liệu Codex của repo. Đây là bước bảo mật của chính Codex, không phải lỗi của AI-DLC.

D.Truy cập Amazon Bedrock thất bại

Kiểm tra đã bật đúng mô hình được cấu hình chưa, thông tin đăng nhập AWS có hợp lệ không và vùng (region) có đúng không.

E.Kỹ năng đã làm mới nhưng không có tác dụng

Hãy mở một phiên mới của công cụ AI. Nếu các bước của plugin biến mất sau khi làm mới, README bảo chạy /aidlc plugin sync.

VII.Có nên dùng không

Điểm mạnh: quy trình rõ ràng, có cổng duyệt của con người, có nhật ký truy vết, chạy được trên bảy công cụ AI phổ biến, cài đặt một dòng lệnh và không đòi cài Node hay Bun. Giấy phép MIT-0 rất thoáng, repo còn được cập nhật trong vài tháng gần đây và có tài liệu riêng cho từng công cụ.

Giới hạn: bộ này khá “nặng” với việc nhỏ lẻ. Nếu bạn chỉ cần AI sửa một dòng code, đi qua quy trình nhiều giai đoạn là thừa. Phần khái niệm (giai đoạn, agent, hồ sơ, cổng duyệt) cần chút thời gian để làm quen. Tài liệu chính viết bằng tiếng Anh. README cũng nhắc rằng AI có thể sai nên bạn phải tự xem lại kết quả và chi phí. Chất lượng đầu ra còn phụ thuộc mô hình bạn chọn, và README khuyên dùng mô hình suy luận mạnh.

Khi nào chọn cách khác: nếu bạn chỉ thích hỏi đáp nhanh hoặc làm đồ chơi một lần, cứ dùng trợ lý AI như bình thường. Còn nếu dự án sẽ lớn dần, nhiều người cùng làm, cần biết ai quyết định gì và vì sao, thì AI-DLC đáng để thử trên một dự án nhỏ trước, rồi mới mở rộng.

4.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

aidlc-workflows có miễn phí không?

Repo dùng giấy phép MIT-0 nên bạn dùng tự do. Tuy nhiên chi phí gọi mô hình AI phụ thuộc công cụ và nhà cung cấp bạn chọn, README nhắc bạn nên xem lại chi phí trước khi dùng. Mức giá cụ thể thì tư liệu chưa có thông tin.

Có cần cài Node.js hay Bun không?

Với cách cài thông thường bằng dòng lệnh của README thì không cần Bun hay Node.js. Chỉ khi chọn đường copy thủ công (không dùng lệnh aidlc) bạn mới cần cài Bun.

Chạy được trên Windows không?

Được. README có lệnh PowerShell riêng cho Windows, cài cho tài khoản hiện tại và tự thêm thư mục vào PATH. Bạn nên mở PowerShell thường, không chạy bằng quyền quản trị. Người dùng macOS, Linux hoặc WSL dùng lệnh curl.

Hỗ trợ những công cụ AI nào?

Claude Code, Kiro CLI, Kiro IDE, Codex CLI, Cursor, opencode và GitHub Copilot. Bạn chọn công cụ bằng cờ --harness khi chạy aidlc config, ví dụ claude, kiro, kiro-v2, codex, cursor, opencode hoặc copilot.

Có cần GPU không?

Tư liệu không nhắc đến yêu cầu GPU. AI-DLC là bộ quy trình chạy trong các công cụ AI lập trình, còn mô hình do công cụ hoặc nhà cung cấp bạn chọn xử lý.

Code và dữ liệu của tôi có an toàn không?

README không nói chi tiết về xử lý dữ liệu. Nó chỉ cảnh báo hai điều: hãy chỉ tin cậy (trust) thư mục dự án của chính bạn hoặc đã kiểm tra, vì hook có thể chạy lệnh trên máy; và hãy xem lại kết quả do AI sinh ra. Dữ liệu gửi đi đâu còn tuỳ công cụ và mô hình bạn dùng.

AI-DLC khác gì việc tự viết prompt cho AI?

AI-DLC đóng gói sẵn quy trình 5 giai đoạn, 33 bước, nhiều agent chuyên trách, cổng duyệt và nhật ký truy vết, dùng chung được cho nhiều công cụ. Prompt tự viết thì không có sẵn những phần đó. README không so sánh trực tiếp với công cụ khác.

Chuyển nhanh tới mục

  1. I.aidlc-workflows làm được gì
    1. A.Quy trình có giai đoạn rõ ràng
    2. B.Nhiều “nhân sự” AI chuyên trách
    3. C.11 hồ sơ quy trình theo loại việc
    4. D.Cổng duyệt của con người
    5. E.Nhật ký kiểm toán và bộ nhớ
    6. F.Một công cụ dòng lệnh aidlc
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Bước 1: Cài đặt AI-DLC
    2. B.Bước 2: Vào thư mục dự án
    3. C.Bước 3: Cấu hình theo công cụ bạn dùng
    4. D.Bước 4: Kiểm tra bằng doctor
    5. E.Bước 5: Mở công cụ AI và bắt đầu
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn có hệ thống quản lý kho đơn giản
    2. B.Lập trình viên mới sửa lỗi trong dự án có sẵn
    3. C.Nhóm nhỏ dùng nhiều công cụ AI khác nhau
    4. D.Người phụ trách quy trình muốn kiểm soát và truy vết
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo không tìm thấy lệnh aidlc
    2. B.Phiên bản dự án và phần chạy bị lệch
    3. C.Codex không chạy hook
    4. D.Truy cập Amazon Bedrock thất bại
    5. E.Kỹ năng đã làm mới nhưng không có tác dụng
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.