Bỏ qua điều hướng
olyms
ai-kit
GitHub
Ưu tiên Cursor · thiết kế không phụ thuộc công cụ

Bộ kỹ năng agent cho
kỹ thuật thực tế

ai-kit là bộ não dùng chung của Polyms dành cho lập trình viên agentic fullstack — mỗi kỹ năng có tên ngắn, gọi bằng lệnh `/`, từ yêu cầu sản phẩm đến bản phát hành với mã nguồn đã được rà soát.

git clone ai-kitĐọc tài liệu →
polyms/ai-kit · main
/align checkout refactor
→ 3 câu hỏi làm rõ trước khi viết spec
→ đã ghi docs/adr/0007.md
01 · nguyên tắc

Kỹ thuật thật tế

01
Thống nhất trước khi bắt đầu dựng
/align thu hẹp khoảng cách giao tiếp — hỏi xoáy quyết định trước khi vào /reqs hoặc /to-prd.
02
Nhỏ và dễ kết hợp
Kết hợp theo từng việc với các kỹ năng có tên ngắn (/reqs, /design, /dev) — không cần quy trình nặng nề.
03
Vòng phản hồi
/dev đưa TDD, kiểm soát kiểu, và debug có kỷ luật vào quy trình — tín hiệu nhanh, không sinh code mù quáng.
04
Thiết kế mỗi ngày
Spec đặt tên rõ cho module và seam; kỹ năng giữ code khỏi rối thành khối bùn mà agent dễ tạo ra khi code nhanh.
05
Tự sửa và sở hữu
Fork, chỉnh sửa, rồi commit lại — kỹ năng là của bạn, không phải prompt hộp đen.
02 · luồng xử lý

Một luồng xử lý, từ ý tưởng cho đến khi phát hành.

Mỗi giai đoạn tạo đầu ra để agent kế tiếp dùng. Vấn đề thô đi riêng qua /triage — được xác minh và viết tóm tắt trước khi tới /dev.

Ý tưởng
/alignThống nhất
/reqs | /to-prdYêu cầu / Tạo PRD
/to-issuesGửi vấn đề
/designThiết kế
/devLập trình
/code-reviewĐánh giá code
Phát hành
Agent chuyên trách
pm
Principal Product Manager
PRD, story, tiêu chí chấp nhận, phạm vi
designer
Principal Product Designer
Spec UI tại docs/design/, ánh xạ @polyms/ui-kit
developer
Principal Software Engineer
Lập trình, TDD, /devops (vai trò chính)
tester
Principal Tester
Bộ E2E, flake, chia nhỏ CI, kiểm thử theo hành trình
techlead
Principal Tech Lead
/docs, arch, code-review, arch-refactor; SEV của /devops
03 · danh mục

Mười lăm skill. Không thủ tục thừa.

Mỗi năng lực là một tên kỹ năng hoặc tên agent ngắn, gọi bằng lệnh `/`.

SETUP
/setup
Setup
Chuẩn bị repo để ai-kit biết issue tracker, tài liệu domain, và chỗ trỏ tới agent.
ALIGN
/align
Align
Thống nhất kế hoạch trước khi code — hỏi xoáy từng câu một, chốt từ domain, cập nhật CONTEXT.md ngay trong lúc làm.
REQS
/reqs
Reqs
Làm yêu cầu sản phẩm — khám phá, PRD đầy đủ, user story, tiêu chí chấp nhận, phạm vi, và ưu tiên. Không xuất bản lên tracker.
PRD
/to-prd
To PRD
Gói cuộc chat hiện tại thành PRD gọn và xuất bản thành issue trên tracker — không phỏng vấn thêm.
PLAN
/to-issues
To issues
Bẻ kế hoạch, đặc tả, hoặc PRD thành issue GitHub nhận việc độc lập được — mỗi issue một lát cắt dọc.
TRIAGE
/triage
Triage
Đưa issue GitHub qua sàng lọc — phân loại, xác minh, hỏi xoáy nếu cần, rồi gắn tóm tắt cho agent.
DESIGN
/design
Design
Biến PRD hoặc tóm tắt tính năng thành đặc tả UI sẵn sàng cho kỹ thuật, map theo @polyms/ui-kit.
IMPL
/dev
Develop
Ship code production từ đặc tả — TDD tại seam đã chốt, thang giải pháp, tự kiểm phạm vi, và gỡ lỗi.
AUDIT
/code-review
Code review
Rà soát code kể từ một mốc git cố định — theo Chuẩn mực, Đặc tả, và Đơn giản hóa.
DOCS
/docs
Docs
Viết tài liệu cho developer — tham chiếu API, hướng dẫn, tích hợp, và ghi chú migration.
E2E
/e2e
E2E
Tự động hóa kiểm thử đầu cuối — flaky Playwright, chạy CI song song, bộ hành trình, và trace.
CRAFT
/craft
Craft
Hướng dẫn viết và sửa skill ai-kit — giữ dự đoán được, cắt lan man, gọi lệnh đúng kiểu.
MAINT
/arch-refactor
Arch refactor
Quét codebase tìm chỗ làm sâu module, hiện báo cáo HTML, rồi hỏi xoáy ứng viên bạn chọn.
ARCH
/arch
Arch
Từ vựng kiến trúc cho module sâu — seam, depth, leverage, locality, design-it-twice.
OPS
/devops
DevOps
Deploy, CI, và hạ tầng — đi từ triệu chứng tới cách xử lý qua Knowledge (`intent: incident`), kèm mẫu SEV và post-mortem.
04 · khởi đầu nhanh

Chín mươi giây tới /align.

Clone repo, chạy `pnpm bootstrap` — symlink skill và agent vào Cursor lẫn Claude Code. Khởi động lại editor rồi gõ `/` để chọn.

polyms/ai-kit ↗
zsh — ai-kit bootstrap
$ git clone git@github.com:polyms/ai-kit.git ~/src/ai-kit
$ cd ~/src/ai-kit
$ pnpm bootstrap
# symlink agent và skill vào Cursor và Claude Code
$