Plugin
Plugin bổ sung skill và công cụ MCP cho agent. Mỗi plugin là một thư mục, có thể chứa:
- Skill: các file
SKILL.md. - Công cụ MCP: một file
.mcp.json.
Mở Plugins ở thanh bên để quản lý. Plugin coppice có sẵn và luôn ở đó. Bạn không tắt được các skill của plugin này.
1. Cài plugin
Trang Plugins có ba tab:
- Installed: mọi plugin bạn có, dù đến từ đâu.
- Marketplace: cách nhanh nhất để thêm plugin.
- Custom: cài từ git hoặc từ thư mục.
Từ marketplace
- Mở Plugins và chuyển sang tab Marketplace.
- Tìm kiếm, hoặc lọc theo nguồn hay danh mục.
- Bấm Install trên một mục.
Plugin sẽ xuất hiện ở tab Installed, ở trạng thái tắt. Tiếp theo, bật plugin. Plugin dùng được cho mọi agent bạn cấp quyền, dù agent chạy trên CLI nào.
Nguồn
Có sẵn năm nguồn:
- coppice: danh mục đi kèm Coppice.
- claude-plugins-official: danh mục chính thức của Anthropic.
- claude-community: danh mục cộng đồng của Anthropic.
- superpowers-marketplace
- ponytail
Cách các nguồn được tải:
- Mỗi nguồn tự tải khi bạn mở tab Marketplace lần đầu.
- Nguồn được tải lại ở chế độ nền nếu đã cũ hơn 24 giờ.
- Nguồn tải lỗi sẽ báo lỗi trên chip của nguồn đó. Bấm chip để thử lại.
Ai đã xem xét plugin
- Thẻ có nhãn Coppice đến từ danh mục của Coppice.
- Mọi thẻ khác có nhãn Community: not reviewed by Coppice. Xem xét plugin trước khi bật.
- Mục trong danh mục có ghim
shasẽ cài đúng commit đó, kể cả khi nhánh đã thay đổi.
Quản lý nguồn
Bấm Manage sources để xem từng nguồn và lần làm mới gần nhất.
- Thêm nguồn: thêm một git repo có
.claude-plugin/marketplace.json. Coppice tải danh mục của repo đó ngay. - Tải lại: bấm Refresh, hoặc Retry sau khi có lỗi.
- Xóa nguồn: bạn xóa được mọi nguồn trừ coppice. Plugin đã cài từ nguồn đó vẫn được giữ. Nguồn mặc định đã xóa sẽ không quay lại.
Ví dụ: GitHub
- Cài
githubtừ marketplace. - Mở plugin, dán GitHub personal access token vào
GITHUB_PERSONAL_ACCESS_TOKENtrong Settings, rồi bấm Save settings. - Bấm Test để xem danh sách công cụ.
- Bật plugin và chọn agent nào được dùng.
Token này tách biệt với GitHub token trong Settings mà Coppice dùng cho pull request.
Từ git
- Mở tab Custom.
- Dán Git URL.
- Nếu cần, điền Ref (optional), ví dụ
main. - Chọn Target directory.
- Bấm Install.
Coppice clone repo bằng thông tin đăng nhập git trên máy bạn. Sau này bấm Update trong chi tiết để kéo thay đổi mới về.
Từ thư mục
- Mở tab Custom.
- Trong Plugin directories, bấm Browse… và chọn thư mục, hoặc gõ đường dẫn vào Directory path.
- Bấm Add directory.
- Thư mục này có thể là một plugin, hoặc chứa nhiều plugin trong các thư mục con.
- Sửa file xong thì bấm Rescan.
- Nếu hai thư mục có plugin trùng tên, plugin trong thư mục đứng trên sẽ được dùng. Dùng mũi tên để đổi thứ tự.
- Thư mục mặc định có nhãn Default và không xóa được.
2. Bật plugin
Plugin mới thêm vào đều đang tắt.
Plugin có MCP server chạy cục bộ sẽ chạy trên máy bạn, với quyền của bạn, nên Coppice sẽ hỏi xác nhận trước khi chạy.
- Bật công tắc trên hàng plugin. Chỉ plugin ở trạng thái
okmới bật được. - Nếu chi tiết có mục Settings, điền từng giá trị rồi bấm Save settings. Các giá trị này được mã hóa khi lưu.
- Bấm Test để khởi động công cụ của plugin và xem danh sách công cụ. Chưa bật plugin vẫn bấm được.
- Mỗi skill có công tắc riêng. Skill nào bị tắt sẽ ẩn với mọi agent, kể cả các lần chạy đang diễn ra.
3. Chọn agent nào được dùng
Trong chi tiết, ở mục Which agents can use it?, chọn:
- All agents: mọi agent, kể cả agent tạo sau này.
- Choose agents: chỉ những agent bạn đánh dấu.
Plugin mới có thiết lập ban đầu như sau:
-
Chỉ có skill: All agents.
-
Có MCP server: Choose agents, chưa đánh dấu agent nào.
-
Bạn cũng có thể chọn plugin trong form agent, ở mục Skills. Hai nơi luôn đồng bộ.
-
Thay đổi có hiệu lực từ lần chạy tiếp theo của mỗi agent.
4. Dùng trên ticket
- Bật plugin.
- Cấp quyền cho agent được giao ticket.
- Bấm Run agent.
- Agent thấy tên và mô tả của từng skill, và tải skill khi cần.
- Công cụ có tên dạng
<plugin>__<tool>.
Để xem những gì đã được dùng:
- Mở tab Agent Runs của ticket.
- Mở rộng một lần chạy.
- Mở Tools & Skills. Các lệnh gọi plugin có nhãn Plugin.
5. Tạo plugin
Plugin đơn giản nhất là một thư mục có SKILL.md. Muốn có tên, phiên bản và công cụ MCP thì thêm manifest.
hello-coppice/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── greeting-style/
│ └── SKILL.md
└── .mcp.json
plugin.json
Đặt ở .claude-plugin/plugin.json.
{
"name": "hello-coppice",
"version": "0.1.0",
"description": "Example plugin: one skill and one MCP tool that greets people.",
"author": { "name": "Coppice" }
}
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
name | Có | Chữ, số, ., _ và -, tối đa 64 ký tự. Bắt đầu bằng chữ hoặc số. coppice đã được giữ chỗ. |
version | Không | Mặc định là 0.0.0. |
description | Không | Mặc định để trống. |
author | Không | Một chuỗi, hoặc { "name": "..." }. |
skills | Không | Đường dẫn đến một thư mục skill, hoặc danh sách đường dẫn thư mục, tính từ gốc plugin. |
Không có plugin.json, thư mục vẫn là plugin nếu có một trong hai:
SKILL.mdở cấp trên cùng.- Skill trong
skills/,.agents/skills/,.claude/skills/hoặc<name>/SKILL.md.
Plugin lấy tên thư mục và phiên bản 0.0.0.
Skill
Mỗi skill là một thư mục có SKILL.md. Tên thư mục là tên skill. File bắt đầu bằng frontmatter:
---
name: greeting-style
description: How to greet people in ticket comments. Load before writing a greeting.
---
namevàdescriptionlà bắt buộc.- Viết mô tả sao cho agent biết khi nào cần tải skill.
Công cụ MCP
Thêm .mcp.json với một map mcpServers. Mỗi server là cục bộ hoặc từ xa:
- Cục bộ:
command, kèmargsvàenvnếu cần. - Từ xa:
"type": "http",url, kèmheadersnếu cần.
{
"mcpServers": {
"hello": {
"command": "node",
"args": ["${CLAUDE_PLUGIN_ROOT}/server/index.mjs"],
"env": { "HELLO_GREETING": "${HELLO_GREETING:-Hello}" }
}
}
}
${NAME}trở thành một mục cài đặt trong chi tiết plugin.${NAME:-default}đặt giá trị mặc định cho mục đó.- Coppice thay
${CLAUDE_PLUGIN_ROOT}bằng thư mục cài plugin. Đây không phải mục cài đặt. - Không hỗ trợ SSE server.
Ví dụ này cung cấp công cụ hello-coppice__greet và skill hello-coppice:greeting-style. Xem ví dụ đầy đủ tại examples/plugins.
Các thư mục commands/, agents/ và hooks/ chưa được hỗ trợ. Ba thư mục này hiện “Not supported yet” và không chạy.