Hướng dẫn đầy đủ về tạo SKILL trong Amazon Quick

Bài viết này lấy một ví dụ thực tế — toàn bộ quá trình hình thành kỹ năng "Kiểm tra SEO" — để tổng kết những công việc cần làm khi tạo SKILL, các lệnh được sử dụng, và những cạm bẫy đã gặp phải. Phù hợp với những ai muốn cố định hóa quy trình làm việc lặp đi lặp lại của mình thành kỹ năng có thể tái sử dụng.

Một, SKILL là gì, tại sao cần tạo

SKILL là việc cố định hóa một bộquy trình làm việc đa bướcthành gói năng lực có thể tái sử dụng. Làm tốt một lần, sau đó chỉ cần một câu là có thể kích hoạt toàn bộ quy trình, không cần phải giải thích lại mỗi lần.

Một SKILL về bản chất là một thư mục:

skill-name/
├── SKILL.md          ← 核心：流程说明 + 触发词 + 输入 + 经验
├── scripts/          ← 可选：可复用的代码脚本
│   └── *.py
└── evals/            ← 可选：测试用例
    └── evals.json

Dấu hiệu phù hợp để tạo thành SKILL: Đây là việc bạn sẽ làm lặp đi lặp lại, số bước ≥2, có sản phẩm đầu ra rõ ràng, và có thể dùng cho đối tượng khác (URL/khách hàng/dự án).

Hai, toàn bộ quy trình tạo SKILL (5 bước)

Bản thân việc tạo kỹ năng cũng có một "siêu kỹ năng" để hướng dẫn. Cốt lõi là 5 bước này:

Ba, phân rã từng bước: mỗi bước cụ thể làm gì

Bước 1: Chạy thông quy trình trước (quan trọng nhất)

Đừng vội tạo kỹ năng. Trước tiên hãy làm trọn vẹn một nhu cầu thực tế, ví dụ: "giúp tôi kiểm tra SEO của trang web này". Trong quá trình đó:

• Xác định rõđầu vàolà gì (một URL? một loạt URL?)
• Xác định rõđầu ralà gì (một báo cáo? định dạng nào?)
• Ghi lại mỗi bước đã dùng năng lực gì (mở trang web, chạy code, tạo Excel……)

Bài học thực chiến: kỹ năng SEO của chúng tôi là sau khi thực sự rà soát nhiều trang của một website doanh nghiệp, điều chỉnh định dạng báo cáo nhiều lần, mới đúc kết thành kỹ năng. Trong quá trình đó người dùng liên tục đưa yêu cầu (thêm tiêu chuẩn Bing, xác minh nguồn chính thức, đổi thành ma trận thực thi, tách thành hai giai đoạn……), tất cả đều trở thành phần giá trị nhất trong kỹ năng.

Bước 2: Xác nhận khung kỹ năng

Nói rõ với AI (hoặc để nó đề xuất):

Bước 3: Trích xuất dữ liệu phiên

Bước này do công cụ tự động hoàn thành: quét phiên vừa chạy thành công, trích ra danh sách công cụ đã dùng, tạo khung SKILL.md có YAML frontmatter. Bạn chỉ cần cung cấp những gì đã định ở bước 2: tên kỹ năng, từ kích hoạt, trường nhập liệu, tên hiển thị, biểu tượng.

Chỉ dẫn:extract_session_data

Bước 4: Viết SKILL.md (sáng tạo cốt lõi)

Trên cơ sở khung, bổ sung các phần sau:

① frontmatter (phần đầu tệp)

---
name: seo-audit-skill
display_name: 「SEO 体检」
description: "一句话说清楚它做什么、什么时候该触发"
icon: "🔍"
trigger: SEO体检 audit 网站优化 网站SEO
inputs:
  - name: page_url
    description: "要体检的页面网址"
    required: true
scripts: [seo_audit.py, seo_matrix.py]
---

② Overview

2–3 câu nói rõ làm gì, dùng khi nào.

③ Workflow (chia bước)

Mỗi bước ghi rõ chế độ (deterministic hành động cố định / agentic cần phán đoán), đầu vào, đầu ra, cách xác minh, thất bại thì làm sao.Giải thích "tại sao" nhiều hơn, viết ít "bắt buộc/cấm" cứng nhắc—— AI thực thi kỹ năng tiếp nhận "giảng lý" tốt hơn.

④ Output

Đầu ra cuối cùng trông thế nào, định nghĩa rõ định dạng.

⑤ Lessons Learned (kinh nghiệm)

Đây là bước phân định chất lượng kỹ năng, chia bốn phần:

• Do: những cách làm hiệu quả
• Don't: những cạm bẫy cần tránh
• Common Failures: lỗi thường gặp + cách xử lý
• When to Ask the User: khi nào nên dừng lại hỏi người

Bài học thực chiến: phần Lessons của kỹ năng này ghi đầy những cạm bẫy thực tế đã gặp——tiếng Trung đừng dùng \uXXXX escape, viết CSV dùng utf-8-sig để chống lỗi mã hóa Excel, tỷ lệ thiếu alt ảnh cao bất thường phần lớn là báo nhầm do lazy loading (phải đánh dấu "chờ xác minh" chứ không phán thiếu ngay), một số tên miền chặn thu thập hàng loạt, cần dùng trình duyệt xác minh…… những "nước mắt" này giúp kỹ năng lần sau chạy ổn định hơn.

⑥ Script (tùy chọn nhưng rất khuyến khích)

Nếu trong quy trình có code viết lặp lại, tách thành script đặt vào scripts/， tham chiếu trong SKILL.md. Chúng tôi đã tạo "JS thu thập tín hiệu trang" và "tạo ma trận nhiều trang" thành hai script, đảm bảo định dạng đầu ra luôn nhất quán mỗi lần.

Bước 5: Lưu + Kiểm thử

• Lệnh lưu:save_skill(tên skill + SKILL.md đầy đủ + script)
• Tạo kiểm thử:generate_skill_evals(tự động tạo vài test case)
• Sau đóchạy thử thực tếxác minh — chúng tôi đã kiểm thử riêng với hai kịch bản đơn trang và nhiều trang, xác nhận có thể phát hiện vấn đề thực (ví dụ phát hiện một số liên kết hỏng 404, phát hiện tiêu đề chia sẻ mạng xã hội không khớp với tiêu đề trang).

IV. Cách lặp và phân phối sau khi tạo

Cải tiến lặp đi lặp lại

Chỉ dẫn:load_skill_for_improvement. Skill không hình thành một lần là xong. Sau vài lần sử dụng, cải tiến theo nhu cầu:

• sửa quy trình, thêm định dạng đầu ra, điều chỉnh từ kích hoạt
• Khi lưudùng cùng tên skilllà có thể ghi đè tại chỗ (tự động sao lưu phiên bản cũ)

Thực chiến: skill này của chúng tôi đã lặp nhiều vòng — thêm tiêu chuẩn Bing, sửa định dạng ma trận thực thi, tách thành hai giai đoạn, thêm đầu ra kép Excel+Markdown, sửa căn chỉnh tên cột với mẫu, cuối cùng đổi tên. Mỗi vòng đều là load_skill_for_improvement → sửa → save_skill ghi đè.

Đổi tên

sửa name và display_nametrong frontmatter, dùng tên mới save_skill, rồi xóa thư mục skill cũ.

Đóng gói phân phối

Nén toàn bộ thư mục skill thành zip, có thể sao lưu, chuyển sang máy khác, hoặc chia sẻ cho đồng nghiệp (đặt vào thư mục skills của họ).

Chuyển đổi công cụ

Nếu muốn dùng trên công cụ AI khác (ChatGPT/Claude/Gemini), cần "phi nền tảng hóa": viết lại tên công cụ độc quyền thành mô tả năng lực chung ("mở trang web" "chạy mã"), và nhúng script thành Markdown tự chứa, có thể dán toàn bộ làm system prompt/lệnh tùy chỉnh.

V. Tra cứu nhanh lệnh thường dùng

Sáu, danh sách tránh bẫy (từ trải nghiệm thực tế)

1. Chạy thông trước rồi mới cố định——Đừng viết SKILL một cách vô căn cứ.
2. Đầu vào chỉ đặt những gì sẽ thay đổi——Giá trị cố định viết cứng trong quy trình.
3. Lessons Learned phải ghi đầy đủ kinh nghiệm thực tế——Đây là chìa khóa để SKILL ngày càng ổn định qua sử dụng.
4. Trích code lặp thành script——Đảm bảo định dạng đầu ra nhất quán, tiết kiệm token.
5. Sau khi lưu phải kiểm thử——Chạy thử một trang đơn + nhiều trang, xác minh nó nhận diện được vấn đề thực tế.
6. Bẫy mã hóa(nếu liên quan đến tiếng Trung/sinh code): ghi file dùng encoding="utf-8", CSV dùng utf-8-sig, đừng dùng \uXXXX escape, PDF tiếng Trung dùng font CID tích hợp.
7. Lặp lại bằng cách ghi đè cùng tên——name không đổi, tự động sao lưu phiên bản cũ.

Kết luận

Bản chất của việc tạo SKILL là:Đóng gói một quy trình làm việc thành công, cùng với những phán đoán và bài học trong đó, thành năng lực "lần sau chỉ một câu là làm lại được". Một SKILL tốt không chỉ ghi lại các bước, mà còn ghi lại kinh nghiệm "làm thế nào để làm đúng việc này".

Trước tiên làm việc thật tốt, rồi làm cho nó có thể tái sử dụng——đó chính là toàn bộ tâm pháp của việc tạo SKILL.