Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:agentize

Đóng gói mã hiện có thành CLI và/hoặc MCP

Chuyển codebase, tính năng hoặc module hiện có thành CLI, MCP server và skill đi kèm cho agent, với lõi dùng chung, xử lý credential, test, tài liệu, CI và đóng gói sẵn sàng phát hành.

Theo dõi kế hoạch

Rà soát mục tiêu

Lập bản đồ agent hóa

Chọn bề mặt

Nguyên tắc 01

Chuyển đổi năng lực đã có; không dùng skill này để xây server từ đầu hoặc scaffold npm thô.

Nguyên tắc 02

Thiết kế workflow cho agent, không sao chép endpoint; dùng kiểu opt-in chi tiết thay vì mặc định cồng kềnh.

Nguyên tắc 03

Một nguồn sự thật: tách core dùng chung trước, rồi mới adapter CLI và MCP mỏng.

Nguyên tắc 04

Chuỗi credential, che dữ liệu, test auth, tài liệu và CI là điều kiện hoàn thành, không phải phần trang trí.

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.

Khởi động

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

1 Theo dõi kế hoạch Tạo thư mục kế hoạch theo ngày, đăng ký task từng pha, lưu mode và mục tiêu gọi lệnh, rồi gỡ blocker trước khi đụng mã.
2 Rà soát mục tiêu Dùng ak:scout để lập bản đồ entry point, năng lực, input, output, side effect, cấu hình, bí mật, runtime, phụ thuộc và test có thể tái dùng.

Xử lý

Agent / skill thực thi

3 Lập bản đồ agent hóa Tạo Agentization Map chấm giá trị cho agent và CLI của từng năng lực ứng viên, tránh bọc mọi hàm chỉ vì nó tồn tại.
4 Chọn bề mặt Chốt --both, --mcp hoặc --cli, tên tool, transport, nơi deploy và metadata package; chỉ hỏi người dùng ở --ask hoặc khi credential chưa rõ.

Kiểm chứng

Gate, review, xác thực

5 Tách lõi dùng chung Giữ phần core không import gì thuộc CLI/MCP; xuất hàm thuần để các adapter mỏng cùng dùng một nguồn sự thật.
6 Bọc CLI và MCP Thêm lệnh CLI scriptable và tool MCP dựa trên SDK chính thức với schema có cấu trúc, lỗi chỉ cách khắc phục, ranh giới auth và quyết định transport stdio/HTTP.

Đóng

Báo cáo, bàn giao, artifact

7 Gia cố gói Chạy các bước test, CI, tài liệu, skill đi kèm, audit phụ thuộc, quét bí mật, kiểm tra che dữ liệu, test auth MCP và Docker non-root trước khi bàn giao.
8 Bàn giao phát hành Trả đường dẫn repo, tên package, tài liệu deploy, skill đi kèm đã staging, bản ghi quyết định và checklist phát hành.

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:agentize [feature-or-module] [--both|--mcp|--cli] [--auto|--ask] [--ultra] [--advice] [--yagni]

Đối số

[feature-or-module] Bắt buộc

Tính năng hoặc module

Codebase, tính năng, module hoặc thư mục con hiện có cần đưa ra ngoài. Nêu hành vi cần bọc; skill này không dùng để xây MCP server hoàn toàn mới hoặc scaffold package thô.

/ak:agentize packages/payments --both --auto

Option dùng chung

--both

CLI và MCP

Mode output mặc định. Tạo lõi dùng chung cùng adapter CLI và MCP từ năng lực hiện có.

/ak:agentize src/invoices --both

--mcp

Chỉ MCP

Chỉ xây bề mặt MCP nhưng vẫn giữ ranh giới core để sau này có thể thêm CLI.

/ak:agentize "Expose generation báo cáo cho agents" --mcp --ask

--cli

Chỉ CLI

Chỉ xây bề mặt dòng lệnh nhưng vẫn giữ ranh giới core để sau này có thể thêm MCP.

/ak:agentize src/exporter --cli

--auto

Tự quyết định

Mode tương tác mặc định. Phân tích, quyết định và triển khai không hỏi thường lệ; chỉ hỏi khi không thể suy ra an toàn về credential.

/ak:agentize packages/payments --auto

--ask

Hỏi trước khi xây

Sau khi phân tích, dừng để chất vấn scope v1, ranh giới thao tác ghi, credential, nơi deploy, metadata package, owner và CLI cần thay thế nếu có.

/ak:agentize src/invoices --both --ask

--ultra

Năm ứng viên quyết định

Chạy lập kế hoạch và rà soát một lần, rồi chỉ tách nhánh phân tích và quyết định cho năm ứng viên chỉ đọc trước khi một verifier chọn bản để triển khai.

/ak:agentize src/exporter --cli --ultra

--advice

Giám sát cố vấn

Thêm checkpoint tư vấn-only với kongming sau rà soát và phân tích, trước bản ghi quyết định, trước bàn giao package và khi bị kẹt. Advice không sửa code hoặc bỏ qua gate.

/ak:agentize packages/payments --both --advice

--yagni

Cắt scope thừa

Chất vấn những năng lực không phục vụ outcome đã nêu và truyền nguyên cờ này xuống skill cùng việc được giao bên dưới.

/ak:agentize "Wrap module đối soát billing" --both --yagni

Flag kết hợp

Cách các option đi cùng nhau trên cùng một lần gọi. Không thay thế bảng option ở trên.

--auto là mode tương tác mặc định;

--ask dừng để hỏi quyết định.

--ultra chỉ áp dụng cho phân tích/quyết định sau scout.

--advice thêm giám sát kongming nhưng không bỏ qua gate.

--yagni cho phép cắt scope không cần.

Mode / route nên dùng

--both

Monorepo CLI + MCP

Nghiên cứu:: Default output mode
Review:: Shared core prevents drift
Xác thực:: CLI, MCP, docs, CI, skill all ship

--mcp

Chỉ MCP

Nghiên cứu:: Use when agent/tool surface is the value
Review:: Skip needless CLI packaging
Xác thực:: Tool schemas and transports verified

--cli

Chỉ CLI

Nghiên cứu:: Use when scriptable human shell UX is the value
Review:: Skip MCP if no agent value exists
Xác thực:: Argv, exit codes, JSON output verified

--ask

Quyết định có hỏi người dùng

Nghiên cứu:: After analysis, clarify v1 scope, mutability, credentials, target, package metadata
Review:: Challenges weak answers
Xác thực:: Decision record reflects explicit answers

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

Mặc định cả hai bề mặt Khuyến nghị

/ak:agentize packages/payments --both --auto

Dùng khi:: Dùng khi module hiện có cần trở thành cả npm CLI và MCP server.
Kết quả:: Tạo kế hoạch có theo dõi, rà soát hành vi thật, ghi lại lệnh/tool đã chọn, tách core dùng chung, bọc adapter CLI và MCP, rồi gia cố test, tài liệu, CI, kiểm tra bảo mật và skill đi kèm trước khi bàn giao gói.

MCP có hỏi người dùng

/ak:agentize "Mở khả năng tạo báo cáo cho các agent" --mcp --ask

Dùng khi:: Dùng khi phạm vi đọc/ghi, nơi deploy hoặc nguồn credential cần người dùng quyết định.
Kết quả:: Chạy các pha bắt buộc là lập kế hoạch và rà soát trước, rồi dừng ở pha 3 để hỏi về scope, thao tác ghi, credential, deploy, package, owner và CLI cần thay thế trước khi triển khai bề mặt MCP.

Chế độ quyết định ultra

/ak:agentize src/exporter --cli --ultra

Dùng khi:: Dùng khi việc chọn năng lực và thiết kế lớp bọc đáng có năm bản quyết định độc lập.
Kết quả:: Chạy lập kế hoạch và rà soát một lần, chỉ tách nhánh Agentization Map và decision record cho năm ứng viên chỉ đọc, để một verifier chọn bản thắng không chỉnh sửa, rồi triển khai gói CLI từ bản đó.

Cắt scope bằng YAGNI

/ak:agentize "Bọc module đối soát thanh toán" --both --yagni

Dùng khi:: Dùng khi lớp bọc cần phản biện năng lực không cần thiết thay vì mở toàn bộ bề mặt được yêu cầu.
Kết quả:: Rà soát module, lập Agentization Map, phản biện những năng lực được yêu cầu nhưng không phục vụ mục tiêu đã nêu, truyền nguyên cờ --yagni xuống dưới và chỉ đóng gói bề mặt CLI/MCP có lý do.

Phạm vi xử lý

Theo dõi kế hoạch
Rà soát mục tiêu
Lập bản đồ agent hóa
Chọn bề mặt
Tách lõi dùng chung
Bọc CLI và MCP