Xây dựng tổ chức tác nhân Claude Code với Headcount

Headcount là gì?

Headcount là một tổ chức tác nhân được xây dựng cho Claude Code. Công cụ này tổ chức các khả năng AI như một công ty, đặt một giám đốc điều hành đứng đầu 16 phòng ban chuyên biệt với tổng cộng 143 kỹ năng.

Thay vì tải một bộ hướng dẫn lớn vào mọi dự án, bạn chỉ cần cài đặt những phòng ban mà dự án cần. Mỗi phòng ban là một plugin Claude Code độc lập, đảm nhiệm một chức năng kinh doanh hoặc kỹ thuật như Công nghệ, Bảo mật, Sản phẩm, Tiếp thị, Tài chính, Vận hành, Doanh thu hoặc Trải nghiệm khách hàng.

Dự án cũng cung cấp sơ đồ tổ chức tương tác để tìm kiếm kỹ năng, mở các phòng ban và truy cập định nghĩa nguồn của chúng.

Tính năng chính

• Phòng ban mô-đun: Chỉ cài đặt những chức năng liên quan đến dự án thay vì tải cả 143 kỹ năng.
• Tự động chọn kỹ năng: Kỹ năng được tải khi yêu cầu phù hợp với lĩnh vực trách nhiệm của chúng.
• Gọi trực tiếp: Gọi một chuyên gia cụ thể khi cần một góc nhìn phân tích nhất định.
• Kỹ năng có không gian tên: Mọi kỹ năng đều sử dụng định dạng department:skill, giúp tránh xung đột tên.
• Điều lệ tác nhân: Các phòng ban có điều lệ trong .claude/agents/, cho phép phân công công việc cho các tác nhân con với phạm vi ghi độc quyền.
• Quy trình liên phòng ban: Các trường hợp sử dụng được ghi chép cho thấy nhiều phòng ban có thể cùng xử lý những tình huống như sự cố bảo mật, phễu bị đình trệ và yêu cầu SOC 2.
• Thẩm quyền cấp đánh giá: Một phòng ban có vai trò đánh giá như Bảo mật có thể dừng công việc tạo ra rủi ro không thể chấp nhận, thay vì chỉ bổ sung thêm một ý kiến.

Cài đặt Headcount

Điều kiện tiên quyết

Headcount được thiết kế cho Claude Code, vì vậy hãy bắt đầu với một môi trường Claude Code đang hoạt động. Việc cài đặt sử dụng các lệnh plugin của Claude Code.

Bước 1: Thêm Marketplace

Thêm kho Headcount làm marketplace plugin:

/plugin marketplace add cbrock84/headcount

Bước 2: Cài đặt một phòng ban

Cài đặt phòng ban mà dự án cần. Ví dụ, thêm phòng ban Bảo mật bằng lệnh:

/plugin install security@headcount

Bạn có thể cài đặt thêm các phòng ban theo cách tương tự. Cách tiếp cận mô-đun này giúp bộ công cụ đang hoạt động luôn tập trung, thay vì tải toàn bộ tổ chức vào mọi dự án.

Bước 3: Xác định các kỹ năng cần dùng

Kỹ năng được gọi bằng không gian tên của phòng ban:

department:skill

Ví dụ:

• security:threat-modeling
• finance:unit-economics
• technology:systematic-debugging
• demand-generation:landing-page-cro-expert

Sử dụng sơ đồ tổ chức tương tác để tìm phòng ban và tên kỹ năng chính xác cho công việc của bạn.

Cách sử dụng cơ bản

Để Headcount chọn chuyên gia

Trong quá trình sử dụng thông thường, hãy mô tả vấn đề một cách tự nhiên. Khi yêu cầu thuộc phạm vi của một phòng ban đã cài đặt, chuyên gia phù hợp sẽ tự động được tải.

Ví dụ, hãy hỏi:

Why isn't this landing page converting?

Yêu cầu này phù hợp với demand-generation:landing-page-cro-expert, chuyên tập trung vào việc chẩn đoán và cải thiện tỷ lệ chuyển đổi của trang đích.

Các ví dụ khác trong dự án gồm:

• Yêu cầu: Hãy đánh giá thiết kế này trước khi chúng ta xây dựng.
  Kỹ năng: security:threat-modeling
• Yêu cầu: Chúng ta có đủ khả năng tuyển người này không?
  Kỹ năng: finance:unit-economics
• Yêu cầu: Tăng trưởng của chúng ta đã đình trệ.
  Kỹ năng: executive:business-growth-consultant

Gọi trực tiếp một kỹ năng

Định tuyến tự động hữu ích khi bạn muốn Headcount chọn chuyên gia phù hợp. Nếu đã biết mình cần góc nhìn nào, hãy gọi trực tiếp kỹ năng bằng tên:

/finance:financial-modeling

Gọi trực tiếp giúp xác định rõ chức năng mong muốn. Ví dụ, hãy dùng mô hình tài chính để dự báo và phân tích kịch bản, trong khi finance:unit-economics tập trung vào biên lợi nhuận đóng góp, chi phí thu hút, thời gian hoàn vốn, giá trị vòng đời và hành vi theo nhóm khách hàng.

Lựa chọn phòng ban cho dự án

Hãy bắt đầu từ những trách nhiệm thực tế của dự án thay vì cài đặt mọi phòng ban có sẵn. Một dự án phát triển phần mềm có thể sử dụng phòng ban Công nghệ cho kiến trúc, kiểm thử, gỡ lỗi, đánh giá mã và triển khai. Sau đó, Bảo mật có thể đảm nhiệm mô hình hóa mối đe dọa và đánh giá kiến trúc.

Một dự án đưa sản phẩm ra thị trường có thể kết hợp Tiếp thị, Tạo nhu cầu, Doanh thu và Tài chính. Các kỹ năng liên quan gồm định vị và thông điệp, tối ưu hóa chuyển đổi trang đích, định giá và đóng gói, phân tích tiếp thị và kinh tế học đơn vị.

Nguyên tắc thiết kế cốt lõi của Headcount là bổ sung đúng phòng ban cần thiết, không giải quyết mọi vấn đề bằng một prompt quá lớn.

Mẹo nâng cao

Kết hợp định tuyến tự động với lệnh gọi trực tiếp

Bắt đầu bằng một yêu cầu ngôn ngữ tự nhiên khi muốn hệ thống xác định chuyên gia phù hợp. Chuyển sang gọi trực tiếp khi cần một lĩnh vực đã biết, một quy trình có thể lặp lại hoặc một bước đánh giá được xác định rõ.

Ví dụ, bạn có thể khám phá một phương án triển khai với technology:solution-exploration, lập kế hoạch bằng technology:implementation-planning và xác minh kết quả bằng technology:completion-verification.

Sử dụng Người đánh giá độc lập

Đừng xem mọi phòng ban chỉ là nguồn cung cấp nhận xét tùy chọn. Security được xác định là nhóm đánh giá và có thể dừng công việc không an toàn. Với một thiết kế nhạy cảm, hãy thực hiện mô hình hóa mối đe dọa hoặc đánh giá kiến trúc bảo mật trước khi triển khai, thay vì chờ đến lúc đưa vào vận hành.

Một quy trình đánh giá có thể được thể hiện như sau:

1. Khám phá giải pháp được đề xuất và những đánh đổi của giải pháp đó.
2. Lập kế hoạch triển khai.
3. Chạy security:threat-modeling hoặc security:security-architecture-review.
4. Giải quyết các rủi ro có tính chất chặn trước khi tiếp tục.
5. Triển khai và xác minh công việc đã hoàn tất.

Ủy quyền thông qua Điều lệ Tác nhân

Mỗi phòng ban cung cấp một điều lệ tác nhân trong .claude/agents/. Các điều lệ này cho phép một phòng ban hoạt động như một tác nhân phụ với phạm vi ghi riêng biệt.

Phạm vi ghi riêng biệt đặc biệt hữu ích cho công việc song song vì chúng giảm sự chồng lấn giữa các tác nhân. Phòng Technology cũng bao gồm các kỹ năng thiết kế hệ thống phân cấp tác nhân và phân phối công việc với nhiều tác nhân song song, bao quát cấu trúc bộ điều phối và tác nhân phụ cùng các phạm vi công việc không giao nhau.

Sử dụng Namespace Nhất quán

Luôn giữ nguyên tên đầy đủ department:skill trong tài liệu, quy trình có thể lặp lại và các lệnh gọi trực tiếp. Namespace làm rõ phòng ban sở hữu và bảo đảm các khả năng có tên tương tự không xung đột.

Nghiên cứu các Tình huống Liên phòng ban

Tài liệu use case của repository trình bày bảy tình huống vượt qua ranh giới các phòng ban. Các tình huống này bao gồm một khách hàng doanh nghiệp yêu cầu SOC 2, một sự cố bảo mật và một phễu bán hàng bị đình trệ. Các ví dụ cũng cho thấy quyền hạn của nhóm đánh giá có thể dừng công việc ở đâu.

Giữ Cài đặt Tập trung

Hãy cài đặt các phòng ban khi nhu cầu của dự án phát sinh. Việc cài đặt có phạm vi hẹp giúp giảm các chức năng không cần thiết mà vẫn duy trì quyền truy cập vào những chuyên gia phù hợp với công việc hiện tại. Thêm một phòng ban khác khi dự án thực sự phát sinh trách nhiệm mới, chẳng hạn như phân tích tài chính, lập kế hoạch vận hành hoặc đo lường marketing.

Quy trình Làm việc Ví dụ

Giả sử một nhóm đang chuẩn bị trải nghiệm sản phẩm mới. Một quy trình Headcount có cấu trúc có thể như sau:

1. Sử dụng các kỹ năng của Product để kiểm tra hoặc tinh chỉnh giao diện và hệ thống thiết kế.
2. Yêu cầu Technology khám phá kiến trúc giải pháp và lập kế hoạch triển khai.
3. Để Security thực hiện mô hình hóa mối đe dọa cho thiết kế trước khi xây dựng.
4. Sử dụng các kỹ năng phát triển hướng kiểm thử, đánh giá mã và xác minh hoàn tất của Technology trong quá trình phân phối.
5. Đưa Demand Generation vào để tối ưu chuyển đổi trang đích và Marketing vào để định vị hoặc lập kế hoạch chiến dịch.
6. Sử dụng Finance để kiểm tra kinh tế học đơn vị hoặc xây dựng các kịch bản tài chính khi cần.

Trình tự chính xác phụ thuộc vào các phòng ban đã cài đặt và nhu cầu của dự án. Điểm khác biệt quan trọng là mỗi chuyên gia có phạm vi trách nhiệm được xác định rõ, thay vì cùng chia sẻ một prompt không phân biệt.

Kết luận

Headcount biến Claude Code thành một tổ chức tác nhân mô-đun với 16 phòng ban và 143 kỹ năng có namespace. Hãy thêm marketplace của công cụ, chỉ cài đặt những phòng ban mà dự án yêu cầu, mô tả nhiệm vụ một cách tự nhiên để tự động định tuyến và gọi các kỹ năng cụ thể khi cần một góc nhìn chính xác. Với công việc phức tạp, hãy kết hợp điều lệ phòng ban, hoạt động đánh giá độc lập và các quy trình liên chức năng được ghi chép.