Claude Plugins: Tùy chỉnh Plugin cho team

Tại sao cần customize plugin?

Một plugin được tạo cho "product management teams" thường dùng ngôn ngữ chung: "project tracker", "chat tool", "documentation system." Nhưng team của bạn dùng Jira không phải Asana, dùng Slack không phải Teams, và có workflow riêng khác với template mặc định.

Customization biến một plugin generic thành công cụ chuyên biệt cho team — Claude sẽ biết chính xác bạn dùng Jira board "Product Backlog", notify qua Slack channel #product-team, và follow quy trình sprint review của công ty bạn.

Ba chế độ customization

Chế độ 1: Generic Plugin Setup

Plugin có chứa ~~ placeholders — dấu hiệu đây là template cần configure.

Ví dụ: ~~chat → Slack, ~~project tracker → Jira, ~~your-team-channel → #product-team

Chế độ 2: Scoped Customization

Plugin đã configure, bạn muốn thay đổi một phần cụ thể (vd: "update sprint skill", "thay đổi cách handle retrospective").

Chế độ 3: General Customization

Không có placeholders, bạn muốn tune toàn bộ plugin để fit better với workflow.

Bước 1: Tìm và đọc plugin

Locate plugin files:

Trong Cowork desktop app, plugin files thường ở:
- Local plugins: mnt/.local-plugins/[plugin-name]/
- Installed plugins: mnt/.plugins/[plugin-name]/

Hoặc dùng command:
find mnt/.local-plugins mnt/.plugins -type d -name "*pm-toolkit*"

Check xem có placeholders không:

grep -rn '~~w' /path/to/plugin --include='*.md' --include='*.json'

Nếu có kết quả → Chế độ 1 (Generic Setup). Nếu không → Chế độ 2 hoặc 3.

Bước 2: Tạo Todo list customization

Cho Generic Setup (replace placeholders):

Ví dụ plugin có các placeholders phổ biến:

Checklist customization cho một team Vietnam:

TODO LIST - Customize pm-toolkit plugin:

[ ] Xác định chat tool: Slack → replace ~~chat
[ ] Xác định project tracker: Jira → replace ~~project tracker
    - Board name: "Product Backlog"
    - Sprint pattern: "Sprint [number] - [dates]"
[ ] Xác định tên team channels:
    - Thông báo sprint: #product-sprint-updates
    - Decisions: #product-decisions
[ ] Update sprint cadence: 2 tuần (thay vì 1 tuần default)
[ ] Update story point scale: Fibonacci (1,2,3,5,8,13) vs T-shirt sizes
[ ] Update ticket statuses: To Do → In Progress → In Review → Done
[ ] Update definition of done theo quy trình QA của team

Bước 3: Thực hiện customization

Replace placeholder đơn giản:

Trong file skills/sprint-planning/SKILL.md, thay:

CŨ:
"Assign items trong ~~project tracker"

MỚI:
"Assign items trong Jira — sử dụng board 'Product Backlog', move sang column 'In Progress'"

Update workflow chi tiết:

CŨ (generic):
"Thông báo sprint plan cho team qua ~~chat"

MỚI (specific):
"Post sprint plan summary vào Slack channel #product-sprint-updates
Format message:
*Sprint [number] Plan — [date range]*
Goal: [sprint goal]
Capacity: [X] story points
Top 3 items: [list]"

Thêm context đặc thù của tổ chức:

CŨ (generic):
"Tính team capacity cho sprint"

MỚI (specific cho Vietnam team):
"Tính team capacity cho sprint:
- Vietnam: Trừ ngày nghỉ lễ quốc gia (30/4, 1/5, các ngày Tết)
- Overhead mặc định: 25% cho meetings và code review
- Phong cách estimate: Story points, scale Fibonacci
- Average velocity: 30-40 points per 2-week sprint"

Bước 4: Customize skill content theo domain

Ví dụ customize competitive-brief skill cho fintech:

THÊM VÀO competitive-brief SKILL.md:

## Vietnam Fintech Context

Khi phân tích đối thủ trong thị trường fintech Việt Nam, cần xem xét thêm:

1. REGULATORY COMPLIANCE: Đối thủ có license NHNN không? Đang xin cấp phép gì?
2. BANKING PARTNERSHIPS: Liên kết với ngân hàng nào? Điều này ảnh hưởng đến
   distribution và credibility
3. PAYMENT RAILS: Dùng VNPay, MOMO, ZaloPay hay direct bank integration?
4. SME vs. ENTERPRISE FOCUS: Rất khác nhau về sales motion và product depth

Nguồn research đặc thù:
- Cổng thông tin NHNN (nhnn.gov.vn) cho regulatory info
- Báo Đầu tư, VnEconomy cho market intelligence
- AppStore/CHPlay reviews tiếng Việt cho user feedback

Bước 5: Kết nối MCP sources

Sau khi customize content, bước quan trọng là kết nối các tools thực tế để Claude có thể access data trực tiếp.

Update .mcp.json sau customization:

{
  "mcpServers": {
    "slack": {
      "type": "sse",
      "url": "https://mcp.slack.com/api/v1/sse",
      "headers": {
        "Authorization": "Bearer ${SLACK_TOKEN}"
      }
    },
    "jira": {
      "type": "stdio",
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-servers/jira/index.js"],
      "env": {
        "JIRA_URL": "https://yourcompany.atlassian.net",
        "JIRA_PROJECT": "PROD",
        "JIRA_TOKEN": "${JIRA_API_TOKEN}"
      }
    },
    "google-drive": {
      "type": "stdio",
      "command": "python3",
      "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-servers/gdrive/server.py"],
      "env": {
        "GOOGLE_CREDENTIALS": "${GOOGLE_SERVICE_ACCOUNT_JSON}"
      }
    }
  }
}

Quan trọng về bảo mật:

• Không bao giờ hardcode API keys trong .mcp.json
• Dùng environment variables: ${VARIABLE_NAME}
• Document required env vars trong README.md
• Mỗi user cần set env vars riêng với credentials của họ

Bước 6: Package plugin sau customization

Tạo .plugin file:

cd /path/to/plugin-directory

# Exclude setup files không cần nữa
zip -r /tmp/pm-toolkit-customized.plugin . -x "setup/*" -x "*.DS_Store"

# Copy to output
cp /tmp/pm-toolkit-customized.plugin /path/to/output/pm-toolkit-customized.plugin

Distribute cho team:

• Share file .plugin qua Slack hoặc email
• User kéo thả hoặc click để install trong Cowork
• Cowork sẽ show preview với list skills và files
• User nhấn "Accept" để install

Bước 7: Viết Summary customization

Sau khi customize, document lại những gì đã thay đổi để team biết:

Template Summary:

## Customization Summary — pm-toolkit v1.0 cho [Tên team]

### Từ research về team:
- Dùng Jira cho project management (board: Product Backlog)
- Dùng Slack cho communication (channel chính: #product-team)
- Sprint 2 tuần, story points Fibonacci
- Ticket statuses: To Do → In Progress → In Review → Done

### Thay đổi đã thực hiện:
- ~~chat → Slack, channel #product-team
- ~~project tracker → Jira, board "Product Backlog"
- Sprint template cập nhật theo 2-week cadence
- Added Vietnam fintech context cho competitive-brief skill

### MCP đã kết nối:
- Slack: ✓ Connected (cần SLACK_TOKEN)
- Jira: ✓ Connected (cần JIRA_URL + JIRA_API_TOKEN)
- Google Drive: Chưa connect — user tự thêm nếu cần

### Cần làm tiếp:
- Mỗi user cần set env variables riêng
- Optional: Kết nối Confluence nếu dùng

Tips customization hiệu quả

• Không đổi tên plugin hoặc skills: Chỉ replace nội dung, giữ nguyên file names và skill names
• Specific beats generic: "Sprint #24 trên Jira board Product Backlog" tốt hơn "sprint trong project tracker của bạn"
• Test trước khi distribute: Install plugin và test mỗi skill với realistic prompt
• Document env vars: README.md phải list tất cả required environment variables
• Keep a version: Lưu customized plugin riêng để không override original khi có update mới

Bước tiếp theo

Sau khi thành thạo customization, bạn có thể muốn tạo plugin hoàn toàn mới cho workflow chưa có plugin nào. Quay lại Claude Plugins: Tạo Cowork Plugin tùy chỉnh để học cách build plugin từ đầu theo nhu cầu cụ thể của tổ chức.

Bài viết liên quan

• Claude Plugins: Tạo Cowork Plugin tùy chỉnh
• Building Effective Agents với Claude — Hướng dẫn kiến trúc
• Context Engineering — Nghệ thuật quản lý context cho Claude
• Calculator Tool — Bài học đầu tiên về Tool Use với Claude
• Claude cho Engineering: System Design interviews và planning