VividKit Crystal clear AI coding
EN
Chọn Thiết Lập Bắt Đầu với AgentKit Tiếp Tục với ClaudeKit Chuyển từ ClaudeKit sang AgentKit Gỡ hẳn ClaudeKit AgentKit Là Gì? AgentKit Hoạt Động Như Thế Nào? Kit, Skill, Agent & Hook AgentKit Hỗ Trợ Runtime AgentKit Ứng Dụng AgentKit Desktop Cấu Hình AgentKit Tra Cứu CLI ak Cheatsheet skill AgentKit Workflows AgentKit Statusline AgentKit Cập Nhật CLI ak & Kits AgentKit Helper Cài lại clean AgentKit Xử Lý Sự Cố AgentKit Giới Thiệu ClaudeKit Hướng Dẫn ClaudeKit CLI Tìm Lệnh Phù Hợp Bảng Lệnh Nhanh Quy Trình Mẫu Tham Chiếu CLI Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Tool coding khác Cách ClaudeKit Hoạt Động Inside ClaudeKit Tìm Unknowns Của Bạn Khôi Phục Session Sửa Lỗi Từ Log Thiết Kế UI/UX Chuyển Đổi Tài Khoản Cấu Hình IDE Remote Control Codex App Sơ đồ hệ thống UI Review Gate Khuyến Mãi Ủng Hộ VividKit

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:mcp-builder

Xây MCP server có ích

Thiết kế và xây MCP server có ích cho workflow thật của agent, không chỉ bọc API endpoint một cách máy móc.

01

Nghiên cứu thiết kế agent

02

Đọc tài liệu MCP

03

Nghiên cứu API

04

Lập kế hoạch tool và hợp đồng

Nguyên tắc 01

Xây tool theo workflow, không chỉ bọc endpoint

Nguyên tắc 02

Tối ưu từng phản hồi vì context của agent có hạn

Nguyên tắc 03

Lỗi phải chỉ rõ bước xử lý tiếp theo

Nguyên tắc 04

Phải đánh giá bằng tác vụ thực tế trước khi xem server là hữu dụng

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 Nghiên cứu thiết kế agent Bắt đầu từ tool theo workflow, context giới hạn, lỗi có hướng xử lý, nhóm tác vụ tự nhiên và cải thiện bằng evaluation.
  2. 2 Đọc tài liệu MCP Tải MCP protocol hiện tại, best-practices reference và tài liệu SDK Python hoặc TypeScript cho stack đã chọn.
02

Xử lý

Agent / skill thực thi

  1. 3 Nghiên cứu API Đọc tài liệu dịch vụ về auth, rate limit, phân trang, dạng lỗi, endpoint, tham số và mô hình dữ liệu.
  2. 4 Lập kế hoạch tool và hợp đồng Chọn thao tác workflow có giá trị, helper dùng chung, schema validate, format phản hồi, giới hạn cắt bớt và xử lý lỗi.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Dựng cấu trúc server Tạo cấu trúc Python/FastMCP hoặc Node/TypeScript với validation Pydantic hoặc Zod và mẫu đăng ký SDK.
  2. 6 Cài đặt nền tảng dùng chung Làm trước helper gọi API, xử lý auth/token, phân trang, format phản hồi và lỗi gọi dịch vụ bên ngoài dùng lại được.
04

Đóng

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

  1. 7 Đăng ký và review tool Thêm từng tool với input chặt, mô tả, I/O async, annotation, review checklist theo ngôn ngữ và kiểm tra build/cú pháp an toàn.
  2. 8 Tạo evaluation Đọc evaluation guide, kiểm tra tool, khám phá dữ liệu read-only, tạo 10 câu hỏi thực tế đã xác minh và xuất XML.

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:mcp-builder [service or API to integrate]

Đối số

[service or API to integrate] Bắt buộc

Integration đích

Dịch vụ hoặc API bên ngoài cần biến thành MCP server mới hoặc mở rộng bề mặt tool/resource. Nêu workflow dự kiến, ngôn ngữ, transport, auth, quyền, rate limit, khối lượng dữ liệu và tác động ngoài được phép nếu đã biết.

/ak:mcp-builder "Build một TypeScript MCP server cho Acme tickets API với search chỉ-đọc trước, cursor pagination, và stdio transport"

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

Server API mặc định Khuyến nghị 
/ak:mcp-builder API triage issue Linear
Dùng khi:
Dùng khi xây MCP server hoặc tool surface cho một dịch vụ bên ngoài.
Kết quả:
Nghiên cứu tài liệu MCP và API Linear, lập kế hoạch tool cấp workflow, cài helper/schema dùng chung, rồi tạo câu hỏi evaluation đã xác minh.
Server Python FastMCP 
/ak:mcp-builder máy chủ FastMCP cho tìm kiếm khách hàng
Dùng khi:
Dùng khi MCP surface nên được xây bằng Python với validation Pydantic.
Kết quả:
Đọc hướng dẫn MCP Python, dựng đăng ký FastMCP, định nghĩa input Pydantic, cài helper API async và xác minh độ hữu dụng bằng evaluation read-only.
Server MCP TypeScript 
/ak:mcp-builder máy chủ MCP TypeScript cho quy trình quản trị billing
Dùng khi:
Dùng khi project cần server MCP SDK bằng Node/TypeScript.
Kết quả:
Đọc hướng dẫn TypeScript SDK, cấu hình cấu trúc project và schema Zod chặt, đăng ký tool kèm annotation, chạy kiểm tra build và chuẩn bị evaluation XML.
Xây tập trung evaluation 
/ak:mcp-builder máy chủ MCP cho câu hỏi knowledge base chỉ đọc
Dùng khi:
Dùng khi cần chứng minh độ hữu dụng của tool bằng câu hỏi agent thực tế, ổn định.
Kết quả:
Thiết kế workflow read-only, kiểm tra tool đã cài, khám phá nội dung có sẵn, viết 10 câu hỏi độc lập kiểm chứng được và xuất đúng định dạng XML.

Phạm vi xử lý

  • Server FastMCP bằng Python
  • Server MCP SDK bằng TypeScript
  • Thiết kế tool xoay quanh agent
  • Schema validation và annotation
  • Cải thiện server bằng evaluation

Artifact tạo ra

Sản phẩm MCP

Mẫu đường dẫn

Code server + schema tool + evaluation

MCP server theo tác vụ, phản hồi gọn, input chặt, lỗi có hướng xử lý, cách test tiến trình dài an toàn và bộ câu hỏi đánh giá thực tế.

Tiếp theo