Tạo, cập nhật, audit và optimize Skill với ak:skill-creator

Dùng ak:skill-creator để tạo, cập nhật, audit hoặc optimize một Skill tái sử dụng. create scaffold Skill mới. update áp dụng thay đổi được yêu cầu tại chỗ. audit báo inventory, provenance và dated prompt pattern mà không ghi tệp Skill. optimize viết lại finding High và Medium và chỉ ghi khi có --apply. Skill mới mặc định nằm trong project hiện tại; authoring user-scope cần yêu cầu rõ. Thêm --long-horizon khi Skill cần repository cho observation, experiment, eval, benchmark, gate và decision.

Chọn ak:skill-creator cho workflow lặp lại

Dùng ak:skill-creator khi

• Bạn cần Skill mới (create) hoặc thay đổi tại chỗ có giới hạn (update).
• Skill hiện có cần inventory dated prompt pattern (audit).
• Bạn muốn rewrite đề xuất chỉ sau khi truyền --apply (optimize).
• Bạn cần repository Skill long-horizon (--long-horizon).
• Bạn muốn bằng chứng validation và evaluation consumer trước distribution.

Chọn workflow khác khi

• Nhu cầu chỉ là prompt một lần, một preference cá nhân hoặc kiến thức model chung.
• Bạn cần bundle có command, tool, MCP config, Hook hoặc app ngoài Skill. Dùng plugin workflow.
• Bạn chỉ muốn cài Skill đã tồn tại. Dùng workflow discovery và installation phù hợp thay vì authoring bản trùng lặp.

Chuẩn bị intent và scope

Cung cấp ví dụ dùng thật, trigger phrase, output mong đợi, non-goal, security boundary và evaluation khách quan có đáng làm hay không. Xác nhận output directory trước khi scaffold. Artifact chuẩn là SKILL.md cùng đúng các thư mục scripts/, references/, agents/, assets/ mà workflow thực sự cần.

Chạy Skill

Chọn subcommand trước: create, update, audit hoặc optimize. Truyền --long-horizon khi Skill cần repository dài hạn. Thêm --advice cho giám sát chỉ tư vấn của kongming. Advice không bỏ qua validation, packaging check hay security policy. optimize chỉ ghi tệp khi có --apply.

/ak:skill-creator create "Create a project-scoped release-notes Skill that validates headings and never publishes" --advice

/ak:skill-creator create "Create a project-scoped release-notes Skill that validates headings and never publishes"

$ak:skill-creator create "Create a project-scoped release-notes Skill that validates headings and never publishes"

Luồng khuyến nghị cho Skill đã có: audit, review report, rồi optimize --apply --from-audit <report>. create từ chối ghi đè directory đã có.

semantic-eval là diagnostic định tuyến catalog tùy chọn và phải gọi tường minh; quá trình authoring thông thường không bao giờ chạy nó. Nó bắt đầu từ bản export catalog mà runtime nhìn thấy. Replay offline và so sánh trước/sau không cần key hay mạng. Batch live ủy quyền cho ak eval decision, cần consent tường minh consumers.skill-routing-eval=true và có thể phát sinh lệnh gọi trả phí. Tinh chỉnh trên tập train, đóng băng candidate trước lượt chạy holdout và không tinh chỉnh lại trên holdout. Một lựa chọn model mang tính diagnostic không phải bằng chứng rằng runtime kích hoạt Skill.

Hiểu các giai đoạn quan sát được

1. Chọn subcommand. create và update ghi tệp. audit chỉ ghi report. optimize chỉ ghi khi có --apply.
2. Chọn target. Mặc định là project hiện tại. Kit scope dành cho repository AgentKit. User scope cần yêu cầu rõ.
3. create ghi nhận intent, research trùng lặp, scaffold, viết, rồi validate. Skill không kết thúc khi linter prompt-cruft còn High finding.
4. update scout Skill hiện có và agent dùng nó, chỉ áp dụng thay đổi được yêu cầu, lint mọi dòng đã đổi, và bump metadata.version.
5. audit inventory provenance và dated pattern, đồng thời đo usage thực tế từ local session. scripts/session_usage.py đọc transcript Claude Code và Codex cục bộ (không bao giờ đọc nội dung prompt hay output) để lấy turn, token, tool call, error và delegation trước khi report đánh giá text của Skill. Có thể nhắm một Skill, một kit, hoặc --all. Nó không fail Skill hiện có vì finding.
6. optimize viết lại finding High và Medium từ report hoặc path. Xác nhận diff, rồi truyền --apply --from-audit <report> để ghi.
7. Validate. Chạy quick validator và linter prompt-cruft trước khi coi Skill đã xong.
8. Evaluate routing và outcome. create so với không có Skill; update so với bản gốc và phải giữ behavior đã chấp nhận. Dùng case có cấu trúc với assertion artifact thật. Ghi model, runtime, snapshot hash, chất lượng và chi phí quan sát được. Blocked hoặc ungraded không phải pass. scripts/eval_skill.py kiểm tra case, chấm artifact và tóm tắt lần chạy.

Giữ file write và distribution có chủ đích

Initializer tạo directory cùng placeholder file. Packaging ghi <skill-directory-name>.zip và có thể thay archive cùng tên, vì vậy kiểm tra destination trước. Packaging loại node_modules/, venv/, .venv/ và .env; hãy ship .env.example thay thế. Test, benchmark model, docs lookup, ephemeral dependency runner và package installation có thể dùng network, compute, token cùng chi phí provider. Không đặt credential, personal data, private path hoặc internal prompt trong Skill text, ví dụ, log hay asset.

Xác minh artifact

Kết quả hoàn tất phụ thuộc subcommand:

• create / update: Skill directory với SKILL.md hợp lệ, chỉ reference và script cần thiết, lint prompt-cruft sạch High finding, và so sánh consumer không blocked hay ungraded.
• audit: report kèm finding, bằng chứng session-usage từ transcript cục bộ (hoặc ghi rõ khoảng trống nếu không có transcript nào) và proposed diff. Tệp Skill không đổi.
• optimize --apply: finding High và Medium đã viết lại, bằng chứng linter và kit validation, và không ghi nếu thiếu --apply.
• --long-horizon: layout observation, experiment, eval, benchmark và gate khi flag đó được yêu cầu.

Quick validator kiểm tra YAML typed, duplicate key, placeholder và resource link. Linter prompt-cruft kiểm tra dated instruction pattern. Cả hai không chứng minh runtime portability; review trước distribution.

Xử lý sự cố và giới hạn