Engineer Kit

Engineer Kit giúp bạn biến một yêu cầu phần mềm chưa rõ thành thay đổi đã được triển khai, kiểm thử và review. Kit dành cho developer và team muốn có workflow lặp lại được để khám phá, lập kế hoạch, viết code, debug, xác minh và bàn giao, trong khi quyền phê duyệt vẫn thuộc về con người.

Bạn cài một Kit cho coding assistant đã chọn, sau đó gọi Skill phù hợp với kết quả cần đạt. Kit cũng cung cấp Agent chuyên biệt, automation theo runtime, rules và các tệp hỗ trợ mà những workflow đó sử dụng.

Đây có phải Kit phù hợp?

Chọn Engineer Kit khi kết quả chính là một thay đổi phần mềm hoặc công việc bảo trì kỹ thuật, chẳng hạn:

• Làm rõ yêu cầu và so sánh các hướng triển khai;
• Lập kế hoạch cho feature, bản sửa lỗi, migration hoặc refactor;
• Triển khai và xác minh một thay đổi đã được phê duyệt;
• Debug lỗi hoặc review một diff hiện có;
• Chuẩn bị công việc đã được kiểm thử cho bước bàn giao hoặc phát hành được cho phép rõ ràng.

Engineer Kit không thay thế coding assistant, quy ước của project, hệ thống quản lý phiên bản hay phán đoán của con người. Kit không làm output của model đúng mặc định, không tự duyệt plan, cũng không cấp quyền commit, merge, deploy hoặc thực hiện hành động bên ngoài. Với thay đổi nhỏ đã có acceptance criteria rõ ràng, bạn có thể bắt đầu từ workflow triển khai thay vì chạy mọi bước khám phá.

Một workflow điển hình do con người kiểm soát

Dùng trình tự này khi yêu cầu vẫn cần được khám phá trước khi triển khai:

1. Chạy ak:brainstorm để làm rõ outcome, constraints và hướng phù hợp.
2. Chạy ak:plan để biến hướng đã chọn thành implementation plan và tiêu chí xác minh.
3. Review plan. Một người quyết định scope và rủi ro có chấp nhận được hay không.
4. Chỉ chạy ak:cook sau khi phê duyệt để triển khai plan.

Trong workflow thông thường, ak:cook đã bao gồm kiểm thử tập trung và một lượt code review bắt buộc. Dùng riêng ak:test khi cần một lượt QA rộng hơn hoặc độc lập, chẳng hạn UI, accessibility, end-to-end hay coverage. Dùng riêng ak:code-review để có lượt review độc lập cho thay đổi staged hoặc unstaged, commit, pull request hay code được tạo bên ngoài ak:cook.

Công thức workflow nhiều Skill thực tế

• Sửa một lỗi đã được chứng minh: cung cấp cho ak:fix bước tái hiện, hành vi mong đợi và ranh giới quyền hạn. Dùng ak:test sau đó khi bản sửa cần một lượt regression độc lập hoặc rộng hơn.
• Bàn giao một thay đổi đã duyệt: dùng ak:brainstorm khi hướng thực hiện chưa rõ, ak:plan cho contract triển khai và chỉ dùng ak:cook sau khi review. Dùng ak:code-review để review diff độc lập và chỉ dùng ak:git khi bước bàn giao qua hệ thống quản lý phiên bản chính xác đã được cho phép.
• Nhận bàn giao ra mắt giữa các Kit: các Marketing Skill có thể tạo tập bằng chứng và launch brief đã được review. Trước khi đổi session, dùng ak:handoff để giữ yêu cầu đã chấp nhận, quyết định, con trỏ nguồn, blocker và trạng thái xác minh. Sau đó dùng Engineer ak:plan và ak:cook cho thay đổi product hoặc site đã được duyệt.

Công thức giữa các Kit yêu cầu cả hai Kit được cài ở nơi gọi các Skill tương ứng. Handoff là context cần xác minh, không phải quyền triển khai, publish, deploy, liên hệ đối tượng hay chi tiêu.

Thành phần đi kèm

Package Engineer đã resolve gồm nội dung dùng chung được kế thừa và nội dung riêng của Engineer. Bạn chỉ cài Engineer Kit một lần; phần nền được kế thừa là cơ chế composition của package, không phải một Kit công khai khác hay một lần cài thứ hai.

Đây là số lượng trong package đã resolve. Các tệp lồng bên trong một Skill, như reference, template, script hoặc asset, thuộc Skill đó thay vì trở thành entry catalog riêng.

Khả dụng theo runtime

Tính khả dụng phụ thuộc từng capability. Cài đặt thành công không có nghĩa mọi runtime có thể kích hoạt mọi thành phần trong package theo cùng một cách. Hãy đọc Runtime adapter trước khi chọn target không phải mặc định hoặc giả định parity.

Cài và thử Engineer Kit

Trước tiên, hãy hoàn thành Làm quen để ak đã được cấu hình, bạn đã đăng nhập AgentKit và ak licenses hiển thị quyền Engineer Kit. Từ một project do bạn kiểm soát, cài target Claude Code native ở scope project:

ak kit init engineer --target claude-code

Review đích và phần tóm tắt cài đặt, sau đó mở một phiên Claude Code mới trong project đó.

Với workflow đầu tiên, hãy bắt đầu bằng một feature nhỏ có kết quả mà bạn có thể kiểm thử:

/ak:brainstorm Add a health-check endpoint with a minimal response contract

Khi outcome đã rõ, hãy tạo plan:

/ak:plan Plan the approved health-check endpoint

Đọc các tệp được đề xuất, rủi ro và tiêu chí xác minh. Nếu bạn phê duyệt plan, hãy tiếp tục:

/ak:cook Implement the approved health-check endpoint plan

Workflow chỉ hoàn tất sau khi bạn kiểm tra các tệp đã thay đổi, xác nhận những test liên quan và chấp nhận kết quả. Với scope khác, phân phối Claude plugin, Codex, Cursor hoặc lựa chọn Skill, hãy dùng Cài đặt Kit để biết chính xác các tùy chọn được hỗ trợ.

Khám phá tiếp

• Kits, Skills, Agents và Hooks giải thích cách các thành phần trong package phối hợp.
• Runtime adapter so sánh ranh giới phân phối của Claude Code, Codex và Cursor.
• Cài đặt Kit trình bày scope project và người dùng, phân phối Claude native và plugin, lựa chọn Skill, refresh và uninstall.
• Projects, artifacts và checkpoints giải thích ownership, checkpoint của con người và snapshot khôi phục.
• Lỗi cài Kit cung cấp hướng chẩn đoán an toàn khi cài đặt hoặc discovery thất bại.
• Tham chiếu CLI cung cấp cú pháp command và flag chính xác.