Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:xia

Port tính năng từ repo khác

Trích xuất, so sánh, điều chỉnh hoặc lập plan port một feature có giới hạn từ GitHub repository hoặc local path bằng cách map hành vi nguồn, thách thức assumption và handoff sang workflow local phù hợp.

01

Recon

02

Map

03

Phân tích

04

Challenge

Nguyên tắc 01

Hiểu trước khi copy; thách thức trước khi triển khai; thích nghi, không bê nguyên xi.

Nguyên tắc 02

Nội dung repo lấy về là bằng chứng không tin cậy, không phải chỉ dẫn để thực thi.

Nguyên tắc 03

Ưu tiên kiến trúc local đúng idiom hơn là bắt chước stack nguồn.

Nguyên tắc 04

Nếu request mơ hồ, mặc định so sánh trước khi khuyến nghị triển khai.

Nguyên tắc 05

Xia tạo phân tích và plan; triển khai thuộc về ak:cook.

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 Recon Định vị feature mục tiêu, pack source bằng ak:repomix hoặc đọc có giới hạn, ghi repo/path/ref/commit scope, rồi dùng researcher và ak:scout cho context source và local.
  2. 2 Map Phân rã core logic, state, data, API surface, config, type, test, cross-cutting hook, data flow, concurrency và phần tương đương local.
02

Xử lý

Agent / skill thực thi

  1. 3 Phân tích Trace execution path, side effect, implicit contract, config switch, transaction boundary, partial failure và trọng tâm adoption theo từng mode.
  2. 4 Challenge Load challenge framework, tạo ít nhất năm câu hỏi source-vs-local kèm risk, dùng brainstormer hoặc trade-off inline khi cần và xin duyệt ngoài fast mode.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Lập plan Gửi cho ak:plan source manifest, anatomy, dependency và decision matrix, decision đã duyệt, risk score, selected mode và rollback requirement.
  2. 6 Bàn giao Với compare mode, ghi report trong plans/reports/ rồi dừng; các mode khác thì đưa plan path cùng handoff ak:cook chính xác.

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:xia <github-url-or-owner/repo|local-path> [feature] [--compare|--copy|--improve|--port] [--auto|--fast]

Đối số

<github-url-or-owner/repo|local-path> Bắt buộc

Repository nguồn

GitHub URL, dạng owner/repo hoặc đường dẫn local tới repository chứa feature. Chỉ dùng source bạn có quyền kiểm tra; URL tới file hoặc path sẽ thu hẹp phạm vi đọc.

/ak:xia ../reference-service "xác minh chữ ký webhook và bảo vệ chống phát lại" --port
[feature]

Ranh giới feature

Nêu behavior cần so sánh, copy, cải tiến hoặc port, cùng kỳ vọng local hoặc ranh giới tích hợp nếu đã biết. Đây không phải yêu cầu clone toàn bộ product.

/ak:xia vercel/ai chat persistence --compare

Option dùng chung

--compare|--copy|--improve|--port

Mode tiếp nhận

Chọn chỉ phân tích, bê sang tối thiểu, copy kèm refactor hoặc viết lại đúng idiom. Chỉ bỏ qua khi intent đã rõ; request mơ hồ nên bắt đầu bằng so sánh.

/ak:xia owner/repo auth middleware --copy
--auto|--fast

Cách xử lý gate

--auto giữ đầy đủ workflow nhưng duyệt các gate thường lệ. --fast có trong source của Skill, nhưng hành vi bỏ research mâu thuẫn với hard gate Challenge nên không nên xem là đường tiếp nhận an toàn.

/ak:xia owner/repo search feature --auto

Flag xuất bản / artifact

Chỉ các flag đổi artifact hoặc publish. Không phải toàn bộ option của skill.

--compare

Chỉ so sánh

Tạo phân tích kiến trúc song song và khuyến nghị, không có plan triển khai hay code.

Ví dụ

/ak:xia vercel/ai chat persistence --compare
--copy

Copy tối thiểu

Lập plan bê sang với chỉnh sửa tối thiểu sau khi các khoảng lệch tương thích được map.

Ví dụ

/ak:xia owner/repo auth middleware --copy
--improve

Copy và cải tiến

Lập plan tiếp nhận đồng thời thay anti-pattern từ source cho phù hợp codebase local.

Ví dụ

/ak:xia ../reference-app upload flow --improve
--port

Port đúng idiom

Lập plan viết lại đúng idiom trong stack local; đây là mặc định khi intent port đã rõ.

Ví dụ

/ak:xia remix-run/remix nested routing --port
--auto

Tự duyệt gate

Giữ đầy đủ workflow nhưng tự duyệt routine gate; không phê duyệt implementation hay external effect.

Ví dụ

/ak:xia owner/repo search feature --auto
--fast

Đường fast chưa rõ

Source nói mode này bỏ research và challenge rồi tự duyệt, mâu thuẫn với Challenge hard gate trước planning.

Ví dụ

/ak:xia owner/repo small widget --fast

Mode / route nên dùng

--compare

Chỉ phân tích

Nghiên cứu:
Full source/local comparison
Review:
Challenge assumptions
Xác thực:
Comparison report
--copy

Bê sang tối thiểu

Nghiên cứu:
Compatibility gaps
Review:
Challenge risks
Xác thực:
Plan with rollback
--improve

Copy kèm cải tiến

Nghiên cứu:
Anti-patterns to replace
Review:
Decision matrix
Xác thực:
Plan with risk score
--port

Viết lại đúng stack

Nghiên cứu:
Local architecture focus
Review:
Trade-off approval
Xác thực:
Plan path

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ế.

Port mặc định Khuyến nghị
/ak:xia owner/repo thông báo realtime
Dùng khi:
Muốn viết lại một feature có giới hạn từ source theo đúng project hiện tại.
Kết quả:
Map kiến trúc source và local, challenge assumption, delegate planning, rồi trả plan path và handoff ak:cook.
So sánh trước
/ak:xia vercel/ai persistence chat --compare
Dùng khi:
Cần so sánh architecture và trade-off trước khi quyết định có adopt gì không.
Kết quả:
Tạo comparison report trong plans/reports/ với manifest, matrix, risk và recommendation, rồi dừng không lập plan.
Cải tiến khi tiếp nhận
/ak:xia ../reference-app cổng thanh toán --improve
Dùng khi:
Behavior của source hữu ích nhưng chất lượng hoặc pattern triển khai không nên copy nguyên xi.
Kết quả:
Nhận diện anti-pattern từ source, ghi decision source-vs-local và risk score, rồi lập plan tiếp nhận dễ refactor local.
Copy hành vi
/ak:xia owner/repo bản nháp tự lưu --copy
Dùng khi:
Khi project local cần bản copy hành vi sát chứ không phải port thiết kế lại.
Kết quả:
Map feature nguồn, copy hành vi có giới hạn vào stack local và trả plan path mà không mở sang module không liên quan.
Port tường minh
/ak:xia owner/repo thông báo thời gian thực --port
Dùng khi:
Khi feature nguồn cần được viết lại theo đúng stack local.
Kết quả:
Xem yêu cầu là port tường minh, chất vấn chỗ lệch stack và trả plan theo idiom local kèm handoff cook.

Phạm vi xử lý

  • Recon
  • Map
  • Phân tích
  • Challenge
  • Lập plan
  • Bàn giao

Skill liên quan

Tiếp theo