Giáo trình tự học miễn phí · Dịch vụ hỗ trợ theo nhu cầu.

Bài 0240phút ước tínhCơ bản

2. Thiết Lập Task Contract: Chuyển Đổi Ý Định Mơ Hồ Thành Ranh Giới Khả Thi

Cách chuyển hóa các yêu cầu chung chung thành Bản giao kèo nhiệm vụ (Task Contract) với 5 câu hỏi cốt lõi, chuyển tư duy từ hành động đối phó sang hoàn thành có kiểm chứng.

Đa số các nhiệm vụ giao cho Agent bắt đầu bằng một ý định rất mơ hồ: 'Hãy cải thiện trang thanh toán' hoặc 'Tối ưu lại database'. Một câu nói như vậy có thể đủ cho một cuộc tán gẫu, nhưng hoàn toàn không đủ cho việc thực thi tự động. Nếu không có hợp đồng nhiệm vụ rõ ràng, Agent sẽ tối ưu hóa cho các hành vi trông có vẻ hợp lý thay vì hoàn thành công việc thật sự.

📜 5 Câu Hỏi Vàng Của Một Task Contract Chuẩn

Trước khi cho phép Agent thực hiện bất kỳ hành động nào, Harness phải biên dịch yêu cầu người dùng thành một Bản giao kèo nhiệm vụ (Task Contract) trả lời chính xác 5 câu hỏi:

![Start With A Task Contract](/static/img/courses/harness-engineering/HRhrqmtWsAE_9Na.jpg)

What outcome must exist? (Kết quả cụ thể nào bắt buộc phải tồn tại?): File mới nào được tạo? Endpoint nào trả về 200? Bảng CSDL nào được thêm cột?
What is inside the scope? (Phạm vi được phép can thiệp là gì?): Chỉ được chỉnh sửa các file trong src/checkout/, không chạm vào phần xác thực src/auth/.
What must not change? (Những bất biến nào tuyệt đối không được phá vỡ?): Không làm tăng bundle size quá 5%, không thay đổi schema CSDL hiện hữu, không đổi tên biến môi trường.
What evidence proves completion? (Bằng chứng nào chứng minh đã hoàn tất?): Lệnh test nào phải pass 100%? Báo cáo audit nào phải đạt 0 warning?
Which actions require human approval? (Những hành động nào bắt buộc dừng lại xin phép con người?): Xóa tệp tin, cập nhật dependency bên thứ ba, gửi API ra hệ thống thanh toán.

 example.py
# CẤU TRÚC ĐẶC TẢ TASK CONTRACT MẪU (task_contract.yaml)
task_id: "TASK-2026-OPTIMIZE-ONBOARDING"
version: "1.0"
objective: "Tái cấu trúc luồng đăng ký tài khoản giảm tỷ lệ drop-off từ bước 2 sang bước 3"

scope:
  allowed_paths:
    - "frontend/src/components/onboarding/*"
    - "frontend/src/styles/onboarding.css"
  forbidden_paths:
    - "backend/auth/*"
    - "database/migrations/*"

invariants:
  - "Tất cả các bài kiểm tra hiện tại trong tests/test_onboarding.py không được hỏng"
  - "Thời gian tải trang không tăng quá 100ms"
  - "Không bổ sung thêm thư viện JavaScript ngoài danh mục"

acceptance_criteria:
  deterministic_checks:
    - command: "npm test -- tests/onboarding.spec.ts"
      expected_exit_code: 0
    - command: "npx lighthouse-ci collect"
      min_score: 95
  proof_artifacts:
    - path: "reports/verification_receipt.json"

policy_gates:
  require_human_confirmation:
    - action: "file_delete"
    - action: "git_push_remote"

🔄 Chuyển Đổi Câu Hỏi Định Hướng Của Agent

Sự hiện diện của Task Contract thay đổi hoàn toàn câu hỏi cốt lõi của Agent:

Khi không có Contract: Agent tự hỏi: "Bây giờ mình nên nói gì hoặc làm gì tiếp theo để nhìn có vẻ bận rộn?" $ ightarrow$ Dẫn tới việc sinh văn bản vô thưởng vô phạt, tạo file rác hoặc xin ý kiến liên tục.
Khi có Contract: Agent tự hỏi: "Hành động cụ thể nào sẽ di chuyển trạng thái môi trường tiến gần hơn tới kết quả đã cam kết trong hợp đồng?" $ ightarrow$ Tối ưu hóa cho các hành động có thể đo lường và xác minh.

Thực hành

Thực hành và tự đánh giá

Hãy viết một bản Task Contract ngắn (theo định dạng YAML hoặc Markdown) cho một nhiệm vụ thực tế của bạn: 'Cập nhật giao diện Dark Mode cho trang quản trị'.

🏢 BẠN MUỐN TRIỂN KHAI CHO CẢ PHÒNG BAN / DOANH NGHIỆP?

Đề Xuất Công Ty Tài Trợ & Đào Tạo In-House Trọn Gói

AI Tinh Gọn hỗ trợ khảo sát hiện trạng, kèm 1-1 on-premise bảo mật dữ liệu, setup hạ tầng riêng và xuất hóa đơn VAT hợp pháp cho doanh nghiệp.

📥 Tải Mẫu Đề Xuất Gửi Sếp → Đăng Ký Tư Vấn Doanh Nghiệp →

Tiến độ tự học lưu trên trình duyệt này. Chỉ đánh dấu khi đã kiểm tra sản phẩm thực hành.