do-in-steps

Tổng quan về skill do-in-steps

Skill do-in-steps giúp agent xử lý công việc phức tạp bằng cách chia thành các subtasks theo thứ tự, chạy lần lượt và kiểm tra từng bước trước khi chuyển sang bước tiếp theo. Skill này hữu ích nhất khi công việc có phụ thuộc lẫn nhau, liên quan đến nhiều file hoặc nhiều hệ thống, hoặc có nguy cơ lỗi âm thầm cao nếu không xác nhận từng giai đoạn.

do-in-steps là lựa chọn rất phù hợp cho thay đổi trong repository, refactor nhiều bước, công việc migration, orchestration giữa các agent, và mọi tác vụ mà bạn muốn giảm giả định và tăng kiểm soát khi bàn giao giữa các bước. Điểm khác biệt chính của nó là luồng built-in meta-judge → LLM-as-a-judge, tạo một lớp kiểm tra chất lượng giữa lúc thực thi và lúc chuyển sang bước kế tiếp.

Skill này dùng để làm gì

Dùng do-in-steps khi không thể làm an toàn trong một lượt duy nhất và mỗi kết quả cần trở thành đầu vào cho bước sau. Skill này được thiết kế để giữ ngữ cảnh gọn, bảo toàn thứ tự, và giảm lỗi dây chuyền trong các quy trình thực thi phức tạp.

Điều khiến nó nổi bật

Khác với một prompt chung chung chỉ nói “think step by step”, do-in-steps là một workflow skill dành cho Agent Orchestration. Nó nhấn mạnh việc tách nhiệm vụ, chọn model theo từng subtask, chuyển ngữ cảnh có chủ đích, và xác minh độc lập, nhờ đó đáng tin cậy hơn với các tác vụ dài hơn.

Ai sẽ phù hợp nhất

Hướng dẫn do-in-steps này phù hợp nhất cho agent làm việc trên codebase, người viết automation, hoặc người dùng cần thực thi có cấu trúc thay vì ý tưởng sáng tạo. Nếu bạn muốn một kế hoạch được điều phối kỹ với các bước kiểm tra sau mỗi chặng, skill này hợp hơn một prompt làm một lần là xong.

Cách dùng skill do-in-steps

Cài đặt và nạp skill

Với do-in-steps install, hãy thêm skill từ đường dẫn repository mà môi trường của bạn sử dụng, rồi nạp SKILL.md làm nguồn chỉ dẫn chính. Trong repo này, skill nằm ở plugins/sadd/skills/do-in-steps, nên phần quan trọng là đưa file skill vào bộ skills đang hoạt động của agent trước khi bắt đầu làm việc.

Biến mục tiêu mơ hồ thành đầu vào hữu ích

Mẫu do-in-steps usage hiệu quả nhất khi prompt của bạn có đủ mục tiêu, repo hoặc hệ thống đích, các ràng buộc, và đích đến cuối cùng. Đầu vào tốt cần nêu rõ deliverable và những phần có rủi ro, chứ không chỉ nêu chủ đề chung.

Ví dụ prompt tốt hơn:
Refactor UserService to remove duplicated validation, update all callers, keep public APIs stable, and verify behavior with tests.
Prompt này tốt hơn:
Improve the service layer.

Đọc các file này trước

Hãy bắt đầu với SKILL.md để hiểu logic orchestration, rồi kiểm tra thêm các project docs hoặc skill files liên quan nếu cách cài đặt của bạn có cung cấp chúng. Trong repository này không có các thư mục hỗ trợ rules/, resources/, hoặc scripts/, nên chính file skill là nơi chứa phần lớn hướng dẫn vận hành.

Chạy theo các giai đoạn có thứ tự

Hãy dùng skill như một workflow tuần tự: phân tích tác vụ, tách phụ thuộc, thực thi subtask đầu tiên, xác minh nó, rồi chỉ chuyển phần ngữ cảnh liên quan sang bước tiếp theo. Giá trị chất lượng đến từ việc giữ ranh giới giữa các bước, thay vì để công việc sau trôi lệch khỏi các quyết định ban đầu.

Câu hỏi thường gặp về skill do-in-steps

do-in-steps có tốt hơn prompt bình thường không?

Có, khi tác vụ có phụ thuộc hoặc cần xác minh giữa các bước. Prompt bình thường vẫn có thể đủ cho việc nhỏ, nhưng do-in-steps tốt hơn khi bạn cần orchestration có kiểm soát, chọn model theo từng subtask, và giảm lỗi ẩn.

Khi nào tôi không nên dùng nó?

Đừng dùng do-in-steps cho chỉnh sửa vụn vặt, câu hỏi một lần, hoặc các tác vụ mà phản hồi trực tiếp là đủ. Overhead của orchestration chỉ đáng khi trình tự và xác thực thực sự cải thiện kết quả.

Nó có thân thiện với người mới không?

Có, nếu bạn có thể mô tả tác vụ rõ ràng. Đường cong học tập chính là cung cấp đủ ngữ cảnh cho việc tách nhiệm vụ và chấp nhận rằng workflow có thể yêu cầu bằng chứng trung gian trước khi tiếp tục.

Nó phù hợp với Agent Orchestration như thế nào?

Nó được xây dựng rõ ràng cho do-in-steps for Agent Orchestration: một supervisor điều phối các sub-agent chuyên biệt, chuyển tóm tắt về phía trước, và dùng một judge độc lập để giảm lỗi ở từng bước. Điều này khiến nó đặc biệt hữu ích trong workflow coding hoặc operations nhiều agent.

Cách cải thiện skill do-in-steps

Đặt ranh giới tốt hơn

Cách nhanh nhất để cải thiện kết quả do-in-steps là xác định rõ điều gì không được thay đổi, điều gì phải được xác minh, và đầu ra cuối cùng nên trông như thế nào. Ràng buộc rõ ràng giúp orchestrator chọn đúng subtasks và tránh làm lại.

Cung cấp ngữ cảnh mang tính quyết định

Nếu muốn đầu ra mạnh hơn, hãy nêu sẵn các file bị ảnh hưởng, môi trường đích, kỳ vọng test, và mọi yêu cầu tương thích. Skill này hoạt động tốt nhất khi nó có thể phân rã công việc dựa trên ràng buộc thật, thay vì phải suy ra quá muộn.

Theo dõi các kiểu lỗi thường gặp

Rủi ro chính là mô tả task quá mơ hồ, dẫn đến phân rã yếu hoặc xác minh hời hợt. Một kiểu lỗi khác là nhồi quá nhiều ngữ cảnh vào bước đầu tiên; tốt hơn là cung cấp đủ để quyết định kế hoạch, rồi để mỗi subtask chỉ nhận phần thông tin nó thật sự cần.

Lặp lại sau lượt đầu tiên

Nếu kết quả đầu tiên gần đúng nhưng chưa trọn vẹn, hãy tinh chỉnh task bằng các thiếu sót cụ thể: thiếu test, thứ tự phụ thuộc chưa rõ, hoặc phạm vi thay đổi cần rộng hơn. Với do-in-steps, cải thiện thường đến từ cách framing task tốt hơn, chứ không phải từ việc yêu cầu nhiều chữ hơn.