Mục tiêu không phải hoàn hảo, mà là dùng được ngay

Nhiều team trì hoãn vì nghĩ phải xây một hệ thống prompt rất lớn.

Thực ra, để bắt đầu, bạn chỉ cần một bộ tối thiểu gồm 5 phần:

  • roles/
  • rules/
  • workflows/
  • skills/
  • evals/

Cấu trúc thư mục gợi ý

.agent/
  roles/
    developer.md
    reviewer.md
    writer.md
  rules/
    safety.md
    coding-standards.md
  workflows/
    debug-issue.md
    code-review.md
    quick-docs.md
  skills/
    add-api-endpoint/
      SKILL.md
    write-tests/
      SKILL.md
  evals/
    review-agent-cases.md
    docs-agent-cases.md

Nội dung tối thiểu cho từng phần

Role

Mỗi role nên có:

  • identity
  • responsibilities
  • decision boundaries
  • communication style

Rules

Mỗi rule file nên chứa:

  • điều cấm rõ ràng
  • nguyên tắc an toàn
  • các invariant nội bộ

Workflow

Mỗi workflow nên trả lời:

  • khi nào dùng
  • các bước thực hiện
  • output mong muốn

Skill

Mỗi skill nên nói rõ:

  • task nào thì dùng
  • task nào thì không dùng
  • checklist thực hiện
  • pitfall thường gặp

Evals

Mỗi bộ eval nên có:

  • input mẫu
  • tiêu chí pass/fail
  • lỗi nghiêm trọng bắt buộc phát hiện

Nếu bộ phận kế toán dùng AI, có thể thêm một thư mục nhỏ riêng như:

.agent/
  skills/
    reconcile-report/
      SKILL.md
  evals/
    reconciliation-cases.md

Trong đó reconcile-report có thể quy định:

  • nguồn dữ liệu nào được phép dùng
  • khi nào phải đánh dấu “chưa đủ dữ liệu”
  • format bảng chênh lệch bắt buộc
  • nguyên tắc không tự suy đoán số tiền còn thiếu

Một template prompt ngắn cho team

# Identity
Bạn là một engineering agent làm việc trong Go microservices repo.

# Mission
Ưu tiên tính đúng đắn, an toàn, và khả năng bảo trì.

# Scope
Được đọc code, sửa code, và chạy validation cục bộ.
Không tự ý làm thay đổi phá vỡ tương thích nếu chưa có xác nhận.

# Context
Repo dùng Clean Architecture, DDD, Kratos, PostgreSQL, Redis và Dapr.

# Workflow
Hiểu hiện trạng, chọn thay đổi nhỏ nhất, thực hiện, kiểm tra, báo cáo.

# Output Contract
Nêu rõ thay đổi đã làm, file liên quan, kết quả verify, và rủi ro còn lại.

# Uncertainty
Nếu thiếu dữ liệu cho quyết định lớn, dừng và hỏi ngắn gọn.

Template này chưa phải cuối cùng, nhưng đủ để team bắt đầu thống nhất cách làm việc.

Nếu viết cho nghiệp vụ kế toán, có thể đổi template ngắn thành:

# Identity
Bạn là trợ lý đối soát dữ liệu tài chính.

# Mission
Ưu tiên tính chính xác, không suy đoán, và tách rõ dữ liệu đủ căn cứ với dữ liệu còn thiếu.

# Scope
Được so sánh số liệu, phát hiện chênh lệch, và tóm tắt điểm bất thường.
Không được tự điền số còn thiếu hoặc kết luận khi chưa đủ chứng từ.

# Context
Dữ liệu gồm báo cáo bán hàng, sao kê thanh toán, và bảng đối soát nội bộ.

# Output Contract
Trả kết quả theo 3 mục: khớp, lệch, thiếu dữ liệu.

# Uncertainty
Nếu thiếu căn cứ, ghi rõ "chưa đủ dữ liệu để kết luận".

Lộ trình áp dụng trong 3 bước

Bước 1

Chọn 1 hoặc 2 use case lặp lại nhiều nhất.

Ví dụ:

  • code review
  • viết docs

Bước 2

Tạo prompt chuẩn đầu tiên cho các use case đó.

Bước 3

Theo dõi output trong 1 đến 2 tuần, rồi sửa dựa trên lỗi lặp lại.

Đừng cố chuẩn hoá tất cả mọi thứ ngay ngày đầu.

Ý chính cuối cùng

Prompt Standard tốt là Prompt Standard mà cả team dùng được, hiểu được, và sửa được.

Nếu chỉ có một người hiểu hệ thống prompt, thì hệ thống đó chưa thực sự chuẩn hoá.

Một bộ standard tốt nên:

  • rõ
  • vừa đủ
  • dễ bảo trì
  • gắn với công việc thật

Bạn có thể quay lại Series hub để đọc lại toàn bộ lộ trình, hoặc dùng series này như tài liệu nhập môn nội bộ cho team.