Skip to content
← Tất cả các chương

Chương 04

Skill và agent

DWP độc lập với agent, nhưng nó kỳ vọng hai khối xây dựng lặp lại — skill và agent — và một cách định hướng có chủ đích trong một repository trước khi bất kỳ công việc nào bắt đầu.

Skill so với agent

Hai khái niệm này dễ bị nhầm lẫn nhưng phục vụ những mục đích khác nhau:

  • Skill là các quy trình tái sử dụng được gọi theo tên. Một skill đóng gói một quy trình lặp lại được — chạy test, sửa lint, tạo một component — để agent và con người gọi nó theo cùng một cách mỗi lần.
  • Agent là các nhân công chuyên biệt với một vai trò xác định — người rà soát, người thực thi, kiến trúc sư. Mỗi agent có một trách nhiệm tập trung và hoạt động trong phạm vi của nó.

Một cách nói tắt hữu ích: một skill là cách làm một tác vụ lặp lại; một agent là ai chịu trách nhiệm cho một loại công việc.

Một bộ kit sống: repository nuôi lớn skill của riêng nó

Khởi tạo biến một repository thành harness của agent; nó không đóng băng repository lại. Bộ kit được dụng ý để lớn lên khi các quy trình của repository trở nên rõ ràng. DWP cung cấp một sub-skill author — được gọi qua /skill-create và /agent-create — suy luận về bố cục và quy ước .agents/ hiện có của repository, rồi viết một skill, agent, hay bộ ủy thác command mỏng phù hợp với chúng. Repository tự sáng tác bộ kit của riêng nó thay vì kế thừa một bộ chung chung.

Sub-skill author rất có dụng ý về sự phù hợp. Nó tạo một skill cho một quy trình lặp lại mà người ta chạy bằng tay, một agent cho một vai trò lặp lại với nhu cầu mô hình hay công cụ riêng biệt, và một command chỉ như một điểm vào mỏng định tuyến tới một skill hay agent. Nó bỏ qua bất cứ thứ gì chung chung không khớp với một quy trình thực, và nó giữ catalog .agents/docs/ đồng bộ với bất cứ thứ gì nó thêm vào. Cùng sub-skill đó hậu thuẫn cho tác vụ Skills & Agents Discovery bắt buộc, vốn đối chiếu catalog với những gì thực sự có trên đĩa — và /dwp-verify xác nhận sự đối chiếu đó một cách khách quan, báo không đạt nếu catalog và các tệp lệch nhau.

Các addon bảo trì

Ngoài việc sáng tác, DWP còn đi kèm các addon bảo trì tự nguyện — không bao giờ bắt buộc để một repository trở thành AI-first. Addon dependency-upgrade là ví dụ tiêu biểu: nó suy luận về trình quản lý gói thực tế của repository (npm, pnpm, hay yarn với ncu; pip, poetry, hay uv; Cargo; Go modules; Bundler; Composer) thay vì giả định một loại, rồi nâng cấp theo các lô nhỏ, chạy cổng kiểm chứng thực của repository sau mỗi lô, hoàn nguyên bất kỳ lô nào thất bại, và tóm tắt mà không tự động commit. Addon design-system là ví dụ về giao diện: khi một repository có một bề mặt giao diện hướng tới người dùng, nó sinh ra một DESIGN.md (tại docs/DESIGN.md, được tham chiếu từ AGENTS.md) ghi lại các quy ước thực của repository theo từng profile được phát hiện — UI trực quan (màu sắc, kiểu chữ, khoảng cách, component, quy tắc khả truy cập), đầu ra CLI (phong cách terminal ngữ nghĩa, panel và spinner, xuống cấp TTY/NO_COLOR), và hội thoại (giọng thông điệp, giải phẫu thông điệp, và cách render theo từng nền tảng) — để bất kỳ agent nào cũng tạo ra đầu ra giao diện nhất quán, đúng thương hiệu. Profile trực quan bật mặc định khi một hệ thống thiết kế được phát hiện; các profile CLI và hội thoại được khuyến nghị khi được phát hiện và luôn được hỏi; addon không bao giờ được đề xuất cho một repository không có bất kỳ bề mặt giao diện nào. Các addon được chấp nhận một cách tường minh trong quá trình khởi tạo; từ chối một addon vẫn để lại repository hoàn toàn tuân thủ.

Khởi tạo repository dựa trên suy luận

Trước khi tạo hay thực thi một kế hoạch, một agent khởi tạo với repository. Khởi tạo là dựa trên suy luận, không dựa trên script: agent đọc cấu trúc, tài liệu và cấu hình của repository để xây dựng một mô hình tư duy thay vì chạy một script cài đặt cố định.

Trong quá trình khởi tạo, agent xác định kiểu hình của repository (độc lập so với điều phối), các lệnh build, test và lint, các quy ước hiện có về phong cách, cấu trúc và đặt tên, cùng các skill và agent đã sẵn có. Sự thấu hiểu này là điều cho phép agent lập kế hoạch và thực thi theo cách phù hợp với repository thay vì chống lại nó.

Bộ công cụ test và kiểm chứng nhận được sự chú ý đặc biệt, vì các cổng kiểm chứng là điều làm cho đầu ra của một kế hoạch trở nên đáng tin cậy. Khi một repository đã có test và trình lint, việc khởi tạo ghi lại các lệnh và quy ước thực của chúng. Khi nó không có, việc khởi tạo không chỉ đơn thuần ghi nhận khoảng trống — nó đề xuất một thiết lập phù hợp với ngăn xếp công nghệ và viết nó vào hướng dẫn kiểm thử của repository, để mọi kế hoạch tương lai đều có một cổng thực để chạy thay vì một cổng chưa xác định.

Thư mục .agents/ và symlink .claude → .agents

DWP gom tất cả những gì định nghĩa hành vi agent — skill, command, định nghĩa agent, tài liệu nội bộ và thiết lập — dưới một thư mục chuẩn duy nhất, .agents/. Cái tên báo hiệu rằng nội dung được chia sẻ giữa các agent thay vì gắn với bất kỳ một công cụ nào.

Để tương thích ngược với các công cụ trước nay đọc từ .claude/, đường dẫn đó là một symlink tới .agents/:

ls -la .claude
# .claude -> .agents

Mọi đường dẫn .claude/... phân giải trong suốt tới phần tương đương .agents/... của nó, nên công cụ cũ vẫn hoạt động trong khi nội dung mới tham chiếu vị trí chuẩn .agents/. Skill và agent được chỉnh sửa qua các tệp thực dưới .agents/, không bao giờ qua symlink.