Xây dựng và xuất bản Cowork plugin

Bây giờ, hãy cùng xây dựng một sản phẩm thực tế - một plugin hoàn chỉnh mà bạn có thể chia sẻ với nhóm của mình, đăng tải lên GitHub hoặc gửi đến cộng đồng.

🔄 Tóm tắt nhanh: Từ bài học về workflow, bạn đã học cách kết hợp các skill với sự chuyển giao liền mạch, thêm xử lý lỗi và kiểm thử với dữ liệu thực. Dự án cuối khóa này áp dụng mọi skill từ toàn bộ khóa học vào một dự án tích hợp.

Chọn phạm vi plugin của bạn

Chọn một lĩnh vực mà bạn am hiểu. Các plugin tốt nhất đến từ chuyên môn thực tế, chứ không phải từ các kịch bản giả định.

Phương án A: Tạo báo cáo khách hàng

• Skill: data-collector, insight-extractor, report-writer, exec-summarizer
• MCP: Google Sheets, Jira (hoặc sử dụng file cục bộ làm phương án dự phòng)
• Workflow: Dữ liệu thô → thông tin chi tiết → báo cáo được định dạng → tóm tắt điều hành

Phương án B: Vận hành nội dung

• Skill: brief-creator, research-compiler, draft-writer, seo-optimizer
• MCP: Google Docs (tùy chọn)
• Workflow: Bản tóm tắt → nghiên cứu → bản nháp → bản cuối cùng được tối ưu hóa SEO

Phương án C: Vận hành cuộc họp

• Skill: agenda-creator, notes-formatter, action-tracker, follow-up-drafter
• MCP: Google Calendar, Slack (tùy chọn)
• Workflow: Chuẩn bị trước cuộc họp → ghi chú sau cuộc họp → các mục hành động → theo dõi

Chọn một hoặc tự định nghĩa phương án của riêng bạn. Cấu trúc là như nhau.

Bước 1: Tạo khung plugin

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # Manifest
├── skills/
│   ├── skill-one/
│   │   └── SKILL.md
│   ├── skill-two/
│   │   └── SKILL.md
│   └── skill-three/
│       ├── SKILL.md
│       └── template.md      # File ngữ cảnh
├── commands/
│   └── run-workflow.md      # Lệnh slash cho toàn bộ workflow
└── .mcp.json                # Các kết nối MCP (tùy chọn)

Bước 2: Viết Manifest

{
  "name": "client-report-generator",
  "version": "1.0.0",
  "description": "Tạo báo cáo cho khách hàng từ dữ liệu dự án — thu thập số liệu, trích xuất thông tin chi tiết và tạo ra các tài liệu sẵn sàng cho cấp quản lý.",
  "author": {
    "name": "Tên Bạn"
  },
  "keywords": ["reports", "client", "analytics", "executive"]
}

Hãy giữ cho nó đơn giản. Manifest là siêu dữ liệu - tên, phiên bản, mô tả, tác giả.

Bước 3: Xây dựng từng skill

Hãy làm việc với từng skill một. Đối với mỗi skill:

1. Viết file SKILL.md (phần mở đầu + hướng dẫn)
2. Thêm các file ngữ cảnh nếu cần (template, ví dụ, hướng dẫn)
3. Kiểm tra skill riêng lẻ với dữ liệu thực
4. Khắc phục mọi sự cố trước khi chuyển sang skill tiếp theo

Đừng vội vàng. Mỗi skill cần hoạt động đáng tin cậy riêng lẻ trước khi bạn kết hợp chúng lại với nhau.

✅ Kiểm tra nhanh: Tại sao bạn nên kiểm tra từng skill riêng lẻ trước khi kết hợp chúng thành một workflow?

Bước 4: Kết nối workflow

Tạo một lệnh slash để điều phối tất cả các skill:

--- 
name: generate-client-report
description: "Chạy toàn bộ quy trình báo cáo khách hàng — từ thu thập dữ liệu đến tóm tắt điều hành."
---

# Quy trình báo cáo khách hàng

Thực hiện các bước sau theo trình tự:

## Giai đoạn 1: Thu thập dữ liệu
Sử dụng skill thu thập dữ liệu để thu thập số liệu từ thư mục dự án.
Lưu kết quả vào file `data-summary.md`.
Cho tôi xem bản tóm tắt trước khi tiếp tục.

## Giai đoạn 2: Trích xuất thông tin chi tiết
Sử dụng skill trích xuất thông tin chi tiết trên file `data-summary.md`.
Xác định xu hướng, bất thường và các chỉ số chính.
Lưu vào file `insights.md`.
Cho tôi xem trước khi tiếp tục.

## Giai đoạn 3: Viết báo cáo
Sử dụng skill viết báo cáo để tạo báo cáo đầy đủ cho khách hàng.
Input: `data-summary.md` + `insights.md`
Áp dụng template từ `skills/report-writer/report-template.md`.
Lưu vào file `client-report-draft.md`.

## Giai đoạn 4: Tóm tắt điều hành
Sử dụng skill tóm tắt điều hành để tạo bản tóm tắt một trang.
Input: `client-report-draft.md`
Lưu báo cáo cuối cùng vào file `client-report-final.md`.
Lưu bản tóm tắt điều hành vào file `exec-summary.md`.

Lưu file này dưới dạng commands/generate-client-report.md. Bây giờ, lệnh /generate-client-report sẽ chạy toàn bộ quy trình.

Bước 5: Kiểm tra toàn diện

Chạy toàn bộ quy trình 3-5 lần với các dữ liệu khác nhau:

Kiểm tra 1: Trường hợp thuận lợi — cung cấp dữ liệu sạch, đầy đủ. Kết quả cuối cùng có đúng không?

Kiểm tra 2: Dữ liệu không ổn định — thiếu cột, định dạng không nhất quán. Liệu nó có xử lý lỗi một cách khéo léo không?

Kiểm tra 3: Các loại dự án khác nhau — liệu plugin có hoạt động với các khách hàng/ngữ cảnh khác nhau không?

Sau mỗi lần kiểm tra, hãy ghi lại những gì bị lỗi và sửa skill liên quan. Mục tiêu: Đầu ra nhất quán, đáng tin cậy trên các đầu vào khác nhau.

Bước 6: Đóng gói và chia sẻ

Cho nhóm của bạn (Zip)

cd my-plugin
zip -r client-report-generator-v1.zip . -x "*.DS_Store"

Gửi file zip. Đồng đội giải nén vào thư mục dự án của họ. Xong!

Dành cho cộng đồng (GitHub)

cd my-plugin
git init
git add .
git commit -m "Initial release: client report generator plugin"
git remote add origin https://github.com/yourname/cowork-client-reports
git push -u origin main

Thêm README.md với nội dung:

• Chức năng của plugin
• Điều kiện tiên quyết (các connector cần thiết, định dạng file được yêu cầu)
• Cách cài đặt (sao chép vào thư mục dự án)
• Cách tùy chỉnh (các skill cần sửa đổi cho ngữ cảnh của bạn)

Dành cho tổ chức của bạn (Cung cấp quyền quản trị)

Trên các gói Team/Enterprise, hãy chia sẻ plugin của bạn thông qua các công cụ quản trị:

1. Upload plugin lên marketplace riêng tư của tổ chức bạn
2. Phân công cho các nhóm liên quan
3. Cấu hình tự động cài đặt cho các thành viên nhóm mới

Tham khảo nhanh cho plugin của bạn

Cấu trúc plugin:
  .claude-plugin/plugin.json  ← Manifest (tên, phiên bản, tác giả)
  skills/*/SKILL.md           ← Các chức năng riêng lẻ
  commands/*.md               ← Cách lệnh slash / workflow
  .mcp.json                   ← Kết nối công cụ bên ngoài

Định dạng skill:
  --- (YAML frontmatter: tên, mô tả) ---
  # Hướng dẫn (markdown body)

Danh sách kiểm tra:
  □ Mỗi skill hoạt động riêng lẻ
  □ Workflow tạo ra đầu ra chính xác từ đầu đến cuối
  □ Xử lý lỗi hoạt động đối với dữ liệu bị thiếu
  □ Đã được kiểm thử 3-5 lần với dữ liệu thực
  □ Đã được người khác kiểm thử

Chia sẻ:
  zip → đồng đội
  GitHub → cộng đồng
  Cấp quyền admin → tổ chức

Việc cần làm trong tuần này

1. Hoàn thành plugin cuối khóa nếu bạn chưa thực hiện
2. Sử dụng nó hàng ngày trong một tuần - việc sử dụng thực tế có tiết lộ các vấn đề khi kiểm thử không
3. Tinh chỉnh dựa trên việc sử dụng hàng ngày - mỗi bản sửa lỗi giúp plugin mạnh mẽ hơn
4. Chia sẻ với các đồng đội - phản hồi của họ giúp cải thiện plugin của bạn tốt hơn nhiều so với việc thử nghiệm một mình

Những điểm chính cần ghi nhớ

• Một plugin có thể chia sẻ cần có: manifest, skills, và tùy chọn cấu hình MCP và các lệnh workflow
• Kiểm tra từng skill riêng lẻ trước khi kết hợp thành workflow
• Kiểm tra toàn diện 3-5 lần với dữ liệu thực trước khi chia sẻ
• Chia sẻ qua zip (đơn giản), GitHub (có phiên bản), hoặc cấp phép quản trị (doanh nghiệp)
• Một plugin đã được kiểm chứng sẽ tốt hơn 10 plugin chưa được kiểm chứng
• Sử dụng thực tế hàng ngày là hình thức kiểm thử và tinh chỉnh tốt nhất