executing-plans

Tổng quan

Kỹ năng executing-plans làm được gì

Kỹ năng executing-plans được thiết kế cho những tình huống bạn đã có một kế hoạch triển khai được viết sẵn và muốn một agent thực hiện nó một cách có phương pháp. Kỹ năng này tập trung vào:

• Nạp một kế hoạch cụ thể, theo từng bước, từ dự án của bạn
• Rà soát kế hoạch một cách phê phán trước khi bắt đầu bất kỳ công việc nào
• Thực thi các tác vụ lần lượt với các trạng thái rõ ràng
• Chạy các bước kiểm tra và test theo đúng mô tả trong kế hoạch
• Bàn giao sang một workflow hoàn tất khi phát triển đã hoàn thành

Khi bắt đầu một phiên làm việc, agent được kỳ vọng sẽ thông báo:

"I'm using the executing-plans skill to implement this plan."

Điều này giúp làm rõ rằng agent đang ở chế độ thực thi có cấu trúc, không phải đang brainstorming hoặc lập kế hoạch tự do.

Kỹ năng này phù hợp với ai

Kỹ năng này phù hợp với:

• Developer thích thiết kế trước, sau đó để agent thực hiện một kế hoạch chi tiết
• Nhóm sử dụng GitHub và có kế hoạch triển khai được viết cho từng tính năng hoặc từng branch
• Người vận hành agent trong các môi trường như Claude Code hoặc Codex muốn workflow thực thi dự đoán được và lặp lại được
• Maintainer dự án muốn bám sát kế hoạch một cách nhất quán với các mốc kiểm tra và bước xác minh rõ ràng

Kỹ năng này đặc biệt hữu ích khi kế hoạch của bạn đã được chia thành các bước nhỏ, dễ thực hiện và có kèm yêu cầu kiểm tra hoặc test rõ ràng.

executing-plans giải quyết những vấn đề gì

Kỹ năng executing-plans giúp bạn:

• Tránh triển khai tuỳ hứng, lệch hướng bằng cách neo công việc vào một kế hoạch đã được phê duyệt trước
• Phát hiện vấn đề sớm nhờ yêu cầu rà soát phê phán kế hoạch trước khi thay đổi code
• Theo dõi tiến độ theo từng tác vụ, đánh dấu công việc là in_progress rồi completed
• Đảm bảo các bước kiểm tra và test được nêu trong kế hoạch thực sự được chạy
• Bàn giao trơn tru cho một kỹ năng finishing để xác minh test cuối cùng và ra quyết định

Bằng cách chuẩn hoá quá trình thực thi kế hoạch, kỹ năng này giảm hiểu lầm và giúp con người và agent cộng tác dự đoán được hơn trong công việc phát triển.

Khi nào nên và không nên dùng kỹ năng này

Hãy dùng executing-plans khi:

• Bạn đã có một kế hoạch triển khai được viết sẵn
• Kế hoạch đã được chia thành các tác vụ hoặc bước tuần tự
• Bạn muốn agent chủ yếu tập trung vào thực thi, không phải thiết kế giải pháp
• Bạn muốn có các mốc checkpoint nơi agent sẽ hỏi bạn khi có điều gì chưa rõ hoặc bị chặn

Hãy cân nhắc kỹ năng hoặc workflow khác khi:

• Bạn cần hỗ trợ tạo một kế hoạch từ đầu (kỹ năng này giả định kế hoạch đã tồn tại)
• Kế hoạch quá mơ hồ hoặc thiếu các chi tiết quan trọng
• Nền tảng của bạn có hỗ trợ subagent phong phú (ví dụ Claude Code, Codex) và bạn muốn orchestration nâng cao hơn — khi đó repository khuyến nghị dùng superpowers:subagent-driven-development thay cho executing-plans
• Bạn chưa sẵn sàng commit vào một chiến lược triển khai cụ thể và vẫn muốn tiếp tục khám phá phương án

Repository cũng chỉ rõ rằng khi tất cả tác vụ đã được thực hiện, bạn nên chuyển sang sub-skill bắt buộc superpowers:finishing-a-development-branch để hoàn tất phần việc còn lại.

Cách sử dụng

Cài đặt và thiết lập

1. Cài đặt kỹ năng executing-plans

Cài đặt kỹ năng từ repository obra/superpowers:

npx skills add https://github.com/obra/superpowers --skill executing-plans

Thao tác này sẽ làm cho workflow executing-plans khả dụng trong môi trường agent của bạn.

2. Chuẩn bị kế hoạch triển khai

Trước khi gọi skill, hãy đảm bảo bạn có một kế hoạch triển khai được viết sẵn trong dự án. Lý tưởng nhất, kế hoạch nên:

• Được lưu trong một file mà agent của bạn có thể đọc (ví dụ nằm trong repo)
• Được chia thành các tác vụ riêng lẻ hoặc bước nhỏ
• Bao gồm mọi hướng dẫn verification hoặc testing bắt buộc cho từng tác vụ

Chất lượng và độ rõ ràng của kế hoạch càng cao, workflow executing-plans sẽ càng đáng tin cậy.

Workflow cốt lõi: từ kế hoạch đến thực thi

Bước 1: Nạp và rà soát kế hoạch

Khi bạn bắt đầu một phiên dùng executing-plans, agent nên:

1. Đọc file kế hoạch từ dự án của bạn
2. Rà soát kế hoạch một cách phê phán, tìm kiếm:
   • Thông tin còn thiếu hoặc hướng dẫn mơ hồ
   • Xung đột hoặc mâu thuẫn giữa các bước
   • Giả định phi thực tế hoặc điều kiện tiên quyết có thể không thoả mãn
3. Nếu agent phát hiện vấn đề, nó nên nêu ra với bạn trước khi bắt đầu thực thi
4. Nếu không có vấn đề, agent nên tạo cấu trúc to-do nội bộ (ví dụ TodoWrite) và sẵn sàng thực thi

Bước rà soát này rất quan trọng. Nó ngăn agent mù quáng làm theo một kế hoạch sai và khuyến khích làm rõ sớm.

Bước 2: Thực thi tác vụ với theo dõi trạng thái

Với mỗi tác vụ trong kế hoạch, kỹ năng executing-plans kỳ vọng quy trình sau:

1. Đánh dấu tác vụ là in_progress để bạn có thể theo dõi công việc đang diễn ra
2. Làm theo từng bước đúng như mô tả trong kế hoạch
   • Kế hoạch được giả định là đã có các bước nhỏ, cụ thể
   • Agent nên hạn chế ứng biến trừ khi kế hoạch rõ ràng là chưa đủ
3. Chạy các bước verification theo mô tả
   • Có thể bao gồm chạy test, linter hoặc các bước kiểm tra thủ công được mô tả trong kế hoạch
4. Đánh dấu tác vụ là completed khi toàn bộ công việc và verification cho tác vụ đó đã hoàn tất

Cấu trúc này giúp con người dễ theo dõi tiến độ và giúp agent tránh bỏ qua bước kiểm chứng.

Bước 3: Hoàn tất phát triển thông qua kỹ năng finishing

Khi tất cả tác vụ trong kế hoạch đã được thực thi và xác minh:

• Agent nên thông báo:

  "I'm using the finishing-a-development-branch skill to complete this work."

• Sau đó sử dụng sub-skill bắt buộc: superpowers:finishing-a-development-branch

• Làm theo kỹ năng finishing đó để:

  • Chạy lại hoặc xác minh test khi cần
  • Trình bày các lựa chọn hoặc kết quả cuối cùng (ví dụ trạng thái branch hoặc bước tiếp theo)
  • Thực thi các hành động hoàn tất mà bạn chọn

Vì vậy, executing-plans nên được xem là phần ở giữa trong pipeline phát triển của bạn: nó đưa bạn từ một kế hoạch đã viết đến các thay đổi đã được triển khai, rồi bàn giao cho một workflow finishing chuyên trách.

Xử lý blocker và tình huống không chắc chắn

Khi nào nên dừng lại và xin trợ giúp

Theo định nghĩa skill, agent phải dừng thực thi ngay lập tức và xin trợ giúp nếu:

• Gặp blocker, chẳng hạn:
  • Thiếu dependency hoặc công cụ
  • Test fail theo cách bất ngờ
  • Hướng dẫn không thể thực hiện được với ngữ cảnh sẵn có
• Kế hoạch có lỗ hổng nghiêm trọng khiến không thể bắt đầu hoặc tiếp tục công việc
• Agent không hiểu đủ một phần của kế hoạch để tiếp tục một cách tự tin

Trong những trường hợp này, phiên làm việc nên chuyển từ chế độ thực thi sang làm rõ, với việc agent giải thích điều gì đang chặn tiến độ và nó cần gì từ bạn.

Thực hành tốt khi dùng executing-plans

Để khai thác tối đa kỹ năng executing-plans:

• Viết kế hoạch cụ thể và có trình tự, mỗi tác vụ có một kết quả rõ ràng
• Bao gồm hướng dẫn verification cho mỗi thay đổi quan trọng
• Khuyến khích agent tóm tắt các mối lo ngại nó phát hiện trong bước rà soát ban đầu thay vì đoán mò trong im lặng
• Sử dụng kỹ năng finishing-a-development-branch một cách nhất quán sau khi thực thi để toàn bộ workflow của bạn luôn dễ dự đoán

Câu hỏi thường gặp (FAQ)

Nói đơn giản thì kỹ năng executing-plans là gì?

Executing-plans là một workflow có cấu trúc để agent nạp, rà soát và thực thi một kế hoạch triển khai đã được viết sẵn. Nó đi qua các tác vụ từng bước, chạy các bước verification được chỉ định, rồi chuyển quyền sang kỹ năng finishing khi phần phát triển đã hoàn thành.

Tôi cài đặt kỹ năng executing-plans như thế nào?

Bạn có thể cài đặt từ repository obra/superpowers với lệnh:

npx skills add https://github.com/obra/superpowers --skill executing-plans

Sau khi cài đặt, hãy cấu hình agent hoặc môi trường của bạn để nó có thể đọc file kế hoạch triển khai và gọi executing-plans cho các phiên liên quan.

Tôi có cần subagent để dùng executing-plans không?

Không. Kỹ năng executing-plans được thiết kế để hoạt động ngay cả khi không có hỗ trợ subagent. Tuy nhiên, repository có lưu ý rằng Superpowers hoạt động tốt hơn với subagent, và nếu nền tảng của bạn hỗ trợ (ví dụ Claude Code hoặc Codex), bạn nên cân nhắc dùng superpowers:subagent-driven-development để có orchestration phong phú hơn thay vì executing-plans.

Khi nào tôi nên ưu tiên executing-plans thay vì subagent-driven development?

Hãy dùng executing-plans khi:

• Môi trường của bạn hạn chế hoặc không có hỗ trợ subagent
• Bạn muốn thực thi tuyến tính, đơn giản một kế hoạch đã có sẵn
• Bạn coi trọng luồng review → execute → finish đơn giản, không cần orchestration nhiều agent phức tạp

Nếu bạn cần cộng tác đa agent, phân rã tác vụ động hoặc mức độ tự chủ ra quyết định cao hơn, lựa chọn được khuyến nghị là superpowers:subagent-driven-development.

Loại kế hoạch nào phù hợp nhất với executing-plans?

Executing-plans hoạt động tốt nhất với các kế hoạch:

• Được viết trong một file mà agent của bạn có thể truy cập
• Được chia thành các tác vụ nhỏ, có thứ tự rõ ràng
• Rõ ràng về kỳ vọng, input và output
• Nêu rõ các bước verification hoặc testing sau mỗi thay đổi

Những kế hoạch quá tổng quát hoặc mơ hồ thường sẽ dẫn đến nhiều vòng hỏi lại và gây chặn việc thực thi.

executing-plans xử lý test và verification như thế nào?

Kỹ năng này kỳ vọng kế hoạch sẽ mô tả những test hoặc bước verification cần chạy. Với mỗi tác vụ, agent nên:

• Thực hiện các thay đổi về code hoặc cấu hình theo mô tả
• Chạy các test, check hoặc command cụ thể được nêu trong kế hoạch
• Chỉ đánh dấu tác vụ là completed khi các verification đó đã thành công hoặc đã được thống nhất lại với bạn

Cách này biến việc chạy test thành một phần của workflow, không phải việc làm thêm sau cùng.

Điều gì xảy ra sau khi tất cả tác vụ hoàn thành?

Khi tất cả tác vụ đã được thực thi và verification đều thành công, executing-plans sẽ bàn giao sang workflow finishing-a-development-branch:

• Agent thông báo rằng nó đang chuyển sang kỹ năng finishing
• Nó sử dụng superpowers:finishing-a-development-branch như một sub-skill bắt buộc
• Kỹ năng đó chịu trách nhiệm cho các bước kiểm tra cuối, trình bày lựa chọn và thực thi các hành động hoàn tất mà bạn chọn

Sự tách biệt này giúp các mối quan tâm về thực thi và hoàn tất được rõ ràng và dễ suy luận hơn.

Nếu kế hoạch hoá ra lại sai thì sao?

Nếu agent phát hiện ra rằng làm theo kế hoạch sẽ dẫn đến hành vi sai hoặc không thể thành công như mô tả, nó nên:

1. Dừng thực thi các tác vụ tiếp theo
2. Giải thích rõ ràng kế hoạch sai ở điểm nào
3. Hỏi bạn có muốn cập nhật kế hoạch, tạo kế hoạch mới hay chuyển sang một workflow khác

Executing-plans giả định rằng kế hoạch là "nguồn sự thật"; khi giả định đó không còn đúng, cần có bước review của con người.

executing-plans chỉ dùng cho thay đổi code thôi sao?

Kỹ năng này chủ yếu hướng tới công việc phát triển (code và tác vụ liên quan), nhưng cùng một mẫu hình — nạp kế hoạch, rà soát, thực thi tác vụ, chạy verification — cũng có thể áp dụng cho các workflow dự án khác được mô tả rõ ràng. Để đạt hiệu quả tốt nhất, hãy dùng nó trong những trường hợp bạn có thể định nghĩa tác vụ rõ ràng và tiêu chí kiểm tra thành công khách quan.

Làm sao tôi biết executing-plans đang hoạt động tốt với dự án của mình?

Hãy tìm các dấu hiệu sau:

• Các tác vụ trong kế hoạch của bạn được đánh dấu in_progress và completed một cách nhất quán, có khả năng truy vết rõ
• Agent thường xuyên chạy các bước verification bạn chỉ định và báo cáo kết quả
• Bạn nhận được thông báo sớm khi kế hoạch chưa rõ ràng hoặc bị chặn
• Việc bàn giao sang finishing-a-development-branch diễn ra mượt mà và dễ dự đoán

Nếu các điều kiện này được thoả mãn, executing-plans nhiều khả năng là lựa chọn phù hợp với nhu cầu quản lý dự án và tự động hoá workflow của đội bạn.