Tóm tắt nhanh / Lệnh

Bộ Marketing

/ak:skill-creator

Tạo Skill

Tạo hoặc cập nhật Claude skill qua ghi nhận intent, research, lập progressive disclosure, scaffold, SKILL.md/tài nguyên, eval, tối ưu description, đóng gói và cố vấn Kongming tùy chọn.

01

Nắm ý định

02

Nghiên cứu mẫu

03

Lập tài nguyên

04

Khởi tạo cấu trúc

Nguyên tắc 01

Skill là hướng dẫn thực hành, không phải tài liệu mô tả

Nguyên tắc 02

Metadata kích hoạt trước; chi tiết được nạp dần

Nguyên tắc 03

Validation và eval quyết định vòng lặp cải tiến

Nguyên tắc 04

Giữ SKILL.md dưới 300 dòng và reference thật tập trung

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Nắm ý định Trao đổi với người dùng để xác định skill làm gì, khi nào nên kích hoạt và cần xuất ra gì.
  2. 2 Nghiên cứu mẫu Dùng docs-seeker và hướng dẫn nghiên cứu để bám vào best practice trước khi viết nháp.
  3. 3 Lập tài nguyên Chọn phần nào đặt trong SKILL.md và phần nào đưa vào script, reference, agent hoặc asset.
02

Xử lý

Agent / skill thực thi

  1. 4 Khởi tạo cấu trúc Tạo thư mục skill với SKILL.md bắt buộc và các phần tùy chọn như script, reference, agent, asset.
  2. 5 Viết hướng dẫn Viết hướng dẫn ở dạng mệnh lệnh, ngắn gọn, metadata kích hoạt mạnh và không lặp nội dung giữa các reference.
  3. 6 Test và evaluate Chạy validation và eval, rồi so sánh baseline khi có và không có skill.
03

Kiểm chứng

Gate, review, xác thực

  1. 7 Tối ưu description Tinh chỉnh metadata kích hoạt mạnh, thuật ngữ chuẩn, ví dụ và ngôn ngữ scope để tăng độ chính xác trigger và điểm benchmark.
  2. 8 Đóng gói Kiểm tra metadata, token, dependency script, cấu trúc, tính portable và mức sẵn sàng marketplace trước khi tạo zip.
  3. 9 Lặp theo phản hồi Tổng quát hóa từ lỗi hoặc phản hồi người dùng thay vì thêm hướng dẫn chữa cháy một trường hợp.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:skill-creator <create|update|audit|optimize> [skill-name|path|kit|--all] [--kit <kit>|--project|--user] [--long-horizon] [--apply] [--from-audit <report>] [--advice]

Đối số

<create|update|audit|optimize> Bắt buộc

Workflow

Đối số skill bắt buộc: tạo skill mới, cập nhật skill có sẵn, audit routing/hành vi, hoặc tối ưu description và eval. Không phải subcommand CLI ak.

/ak:skill-creator create release-notes
[skill-name|path|kit|--all]

Đích

Tên skill, path, kit, hoặc --all khi audit/optimize cả kit. Kết hợp --kit, --project hoặc --user để chọn scope cài.

/ak:skill-creator audit --all --kit engineer

Option dùng chung

--kit

Scope kit

Nhắm một kit theo tên thay vì suy từ project hiện tại.

/ak:skill-creator audit --all --kit engineer
--project

Scope project

Tạo hoặc cập nhật skill trong project hiện tại, không phải user-global.

/ak:skill-creator create release-notes --project
--user

Scope user

Ghi vào kho skill user-global chỉ khi người dùng yêu cầu rõ scope đó.

/ak:skill-creator create release-notes --user
--long-horizon

Tạo dài hạn

Dùng workflow tạo dài hạn cho skill cần bền qua nhiều phiên.

/ak:skill-creator create release-notes --project --long-horizon
--apply

Ghi sửa đã chấp nhận

Ghi các sửa update hoặc optimize đã chấp nhận. Không có --apply thì chỉ báo patch đề xuất.

/ak:skill-creator update release-notes --apply
--from-audit

Từ báo cáo audit

Đưa path báo cáo audit vào update để patch bám đúng vấn đề đã chẩn đoán.

/ak:skill-creator update release-notes --from-audit plans/reports/skill-audit.md --apply
--advice

Giám sát tư vấn

Yêu cầu Kongming review tư vấn sau planning, sau bản nháp SKILL.md cùng kết quả evaluation, trước packaging hoặc distribution, hoặc khi lỗi lặp lại chặn tiến độ. Tùy chọn này không chuyển quyền quyết định và không bỏ qua validation hay kiểm tra bảo mật.

/ak:skill-creator create release-notes --project --advice

Subcommand

create Tạo
/ak:skill-creator create [skill-name or description] [--kit <kit>|--project|--user] [--long-horizon] [--advice]

Ghi nhận intent, soạn SKILL.md và tài nguyên, evaluate, rồi chỉ đóng gói khi được yêu cầu.

Kết quả:

/ak:skill-creator create release-notes --project
update Cập nhật
/ak:skill-creator update [skill-name|path] [--apply] [--from-audit <report>] [--advice]

Sửa skill có sẵn từ yêu cầu hoặc báo cáo audit. --apply ghi các sửa đã chấp nhận.

Kết quả:

/ak:skill-creator update release-notes --apply
audit Audit
/ak:skill-creator audit [skill-name|path|kit|--all] [--kit <kit>] [--advice]

Chẩn đoán routing, description và hành vi, dựa trên số liệu sử dụng đo từ các session local mà không in nội dung của chúng. Không viết lại skill trừ khi chạy tiếp update --apply.

Kết quả:

/ak:skill-creator audit release-notes
optimize Tối ưu
/ak:skill-creator optimize [skill-name|path|--all] [--apply] [--advice]

Siết metadata kích hoạt, eval và progressive disclosure. --apply ghi thay đổi metadata đã chấp nhận.

Kết quả:

/ak:skill-creator optimize release-notes --apply

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Tạo skill trong dự án Khuyến nghị
/ak:skill-creator create release-notes --project
Dùng khi:
Một workflow lặp lại cần trở thành skill được version hóa trong project hiện tại.
Kết quả:
Ghi nhận task, trigger, output, scope, refusal behavior và test case; scaffold thư mục skill trong project, viết SKILL.md/tài nguyên ngắn gọn, validate cấu trúc và chỉ đóng gói khi được yêu cầu.
Cập nhật từ audit
/ak:skill-creator update release-notes --from-audit plans/reports/skill-audit.md --apply
Dùng khi:
Báo cáo audit đã chẩn đoán lỗi routing hoặc hướng dẫn cần ghi lại vào skill.
Kết quả:
Đọc báo cáo audit, chỉ vá vấn đề đã chẩn đoán, ghi sửa đã chấp nhận vì có --apply, và không đụng file skill không liên quan.
Audit một skill
/ak:skill-creator audit release-notes
Dùng khi:
Routing, description hoặc hành vi trông sai và cần chẩn đoán trước khi viết lại.
Kết quả:
Báo finding về routing, description và hành vi mà không viết lại SKILL.md trừ khi sau đó chạy update --apply.
Tối ưu metadata
/ak:skill-creator optimize release-notes --apply
Dùng khi:
Skill hiện có kích hoạt thiếu, kích hoạt quá rộng hoặc metadata khám phá còn mơ hồ.
Kết quả:
Siết ngôn ngữ when-to-use và coverage eval, ghi metadata đã chấp nhận vì có --apply, và giữ progressive disclosure.
Tạo skill có cố vấn
/ak:skill-creator create release-notes --project --advice
Dùng khi:
Thiết kế skill, kết quả eval, bước đóng gói hoặc mục tiêu phân phối cần cố vấn giám sát.
Kết quả:
Thêm checkpoint Kongming chỉ tư vấn sau intent capture và planning, sau bản nháp SKILL.md cùng kết quả eval, trước packaging hoặc distribution và khi lỗi lặp lại chặn tiến độ.

Phạm vi xử lý

  • cấu trúc skill
  • progressive disclosure
  • thiết kế eval
  • tối ưu metadata
  • đóng gói
  • portable cho marketplace

Tiếp theo