Skip to content
Deep Work Plan có mặt trên Product Hunt hôm nay Ủng hộ ngay
← Tất cả các chương

Chương 03

Mẫu kế hoạch và tác vụ

Một Deep Work Plan là một thư mục các tệp markdown. Hình dạng của thư mục đó — và của mỗi tệp bên trong nó — là điều khiến một kế hoạch rà soát được bởi cả con người lẫn agent.

Cấu trúc kế hoạch

Một kế hoạch là một thư mục dưới .dwp/plans/ được đặt tên PLAN_<slug>/. Nó chứa:

  • README.md — tổng quan kế hoạch: mục tiêu, tài liệu nguồn, bảng tác vụ và trạng thái.
  • Một tệp cho mỗi tác vụ, đặt tên <n>.task_<slug>.md.
  • PROGRESS.md — một nhật ký chạy của quá trình thực thi.

Cấu trúc tệp tác vụ

Mỗi tệp tác vụ được đặt tên <n>.task_<slug>.md và tuân theo cấu trúc mười phần: Goal, Context, Touched Surface, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks, và Completion & Log. Các phần luôn xuất hiện theo thứ tự đó để bất kỳ người đọc nào cũng biết tìm ở đâu. Mỗi tác vụ neo lại vào mục tiêu của kế hoạch trước khi nó hành động, điều này giữ cho agent không trôi dạt qua một chân trời dài, nhiều giờ.

Final Review

Mọi kế hoạch phải kết thúc bằng đúng một tác vụ bắt buộc: Final Review. Nó khép lại kế hoạch bằng ba lượt đi có thứ tự — không gì trong bước rà soát bảo mật bị nới lỏng:

  1. Bước rà soát bảo mật — kiểm toán mọi thứ kế hoạch đã thay đổi để tìm bí mật, rủi ro tiêm nhiễm và bề mặt tấn công mới, và giữ docs/SECURITY.md luôn cập nhật. Bảo mật không phải là một luồng công việc riêng được gắn vào cuối: mỗi kế hoạch để lại các thay đổi của chính nó đã được kiểm toán, và một phát hiện nghiêm trọng chặn việc hoàn tất.
  2. Kiểm chứng trạng thái cuối cùng — kiểm chứng đầy đủ của repository chạy và đạt trên trạng thái liên quan cuối cùng, sau lần sửa cuối cùng.
  3. Đối chiếu skill — mỗi tác vụ đã ghi lại kết luận về skill của riêng nó trong khi bằng chứng còn mới; bước rà soát đối chiếu sổ cái. Executive Report vẫn khả dụng theo yêu cầu.

Các quy ước README và PROGRESS

Tệp README.md của kế hoạch phải chứa một tiêu đề (# Deep Work Plan: <name>), một câu phát biểu mục tiêu dạng văn xuôi, một phần tài liệu nguồn tùy chọn, một bảng tác vụ (số thứ tự, tên tác vụ, ô đánh dấu trạng thái), và một dòng trạng thái kế hoạch theo dạng <n>/<total> tasks complete.

PROGRESS.md là một nhật ký thực thi chỉ ghi thêm. Mỗi mục ghi lại một dấu thời gian ISO 8601, số thứ tự và tên tác vụ, điều đã làm, và mọi sai lệch hay lý do bỏ qua. Vì nó chỉ luôn lớn lên, nó là một lịch sử đáng tin cậy về cách kế hoạch thực sự diễn ra.

Tiêu đề và tham chiếu chéo

Mọi tiêu đề dùng kiểu viết hoa đầu câu, và các tài liệu tránh ngôn ngữ tiếp thị cùng dấu chấm than. Các quy ước này giữ cho kế hoạch nhất quán qua các agent và theo thời gian.