Claude Code

Cài đặt

Trong Claude Code, thêm marketplace một lần, rồi cài kênh Stable:

/plugin marketplace add minhphamdonhat/Agentville
/plugin install agentville@minhphamdo

Chọn phạm vi (scope) khi được hỏi, rồi chạy /reload-plugins nếu Claude Code nhắc bạn.

Từ shell, các bước tương tự là:

claude plugin marketplace add minhphamdonhat/Agentville
claude plugin install agentville@minhphamdo --scope project

Trong thẻ Code của ứng dụng máy tính, nhấp +, rồi Add plugins. Phiên làm việc trên đám mây không có trình duyệt plugin.

Nếu bạn đã thêm Agentville trong Claude Chat hoặc Cowork, nó cũng được đồng bộ sang Claude Code dưới tên agentville@synced.

Ba cách để chạy

1. Claude Code với pod-lead làm agent chính. pod-lead đưa mọi yêu cầu qua orchestrate và tuân theo root-agent. Để chạy nó cho một phiên, hãy khởi động claude --agent agentville:pod-lead. Để đặt nó làm agent chính của mọi phiên, hãy đặt khoá agent trong ~/.claude/settings.json của riêng bạn hoặc trong .claude/settings.json của dự án. Tài liệu về subagent minh hoạ khoá đó với tên agent không kèm tiền tố, như { "agent": "code-reviewer" }, còn tài liệu về plugin ghi tên đầy đủ của một agent trong plugin là <plugin>:<name>; với agent của plugin này, claude --agent agentville:pod-lead là cách viết có trong tài liệu. Bản thân plugin không kèm thiết lập mặc định nào, nên việc cài nó không thay đổi agent chính.

2. Claude Code với một agent khác. Khởi động một phiên bằng claude --agent <name>, hoặc ghi tên một agent khác vào khoá agent của riêng bạn trong ~/.claude/settings.json. Để agent đó tuân theo Agentville, hãy thêm các dòng sau vào CLAUDE.md của dự án:

   markdownSao chép

   - Load `Skill(agentville:root-agent)` and follow it in every reply.
   - Route every request, questions included, through `Skill(agentville:orchestrate)` and follow it.

   Để dùng playbook của riêng bạn, hãy fork orchestrate thành một skill mới và ghi tên nó ở dòng thứ hai.

3. Chat hoặc Cowork. Xem Bắt đầu.

Phần nào được nạp ở đâu

Ghi chép được lưu ở đâu

Agentville giữ ghi chép, kế hoạch, báo cáo và bằng chứng của mỗi yêu cầu trong .agentville/topics/ ở thư mục dự án, mỗi yêu cầu một thư mục. Tệp .gitignore riêng của nó giữ cho bằng chứng và các thư mục làm việc của trợ thủ không lọt vào commit.

Cập nhật

Tự động cập nhật mặc định bị tắt với các marketplace của bên thứ ba. Chạy claude plugin marketplace update minhphamdo để làm mới danh sách, rồi claude plugin update agentville@minhphamdo (hoặc kênh bạn đã cài). Một phiên đang chạy vẫn giữ phiên bản cũ cho đến khi bạn khởi động lại hoặc chạy /reload-plugins.