Blog Post Drafter

Đầu Vào Người Dùng

$ARGUMENTS

Bạn BẮT BUỘC phải xem xét đầu vào của người dùng trước khi tiếp tục. Người dùng nên cung cấp:

• Ý tưởng/Chủ đề: Khái niệm hoặc chủ đề chính cho bài đăng blog
• Tài nguyên: URLs, files, hoặc tài liệu tham khảo để nghiên cứu (tùy chọn nhưng được khuyến nghị)
• Đối tượng mục tiêu: Bài đăng blog dành cho ai (tùy chọn)
• Giọng điệu/Phong cách: Trang trọng, thân mật, kỹ thuật, v.v. (tùy chọn)

QUAN TRỌNG: Nếu người dùng đang yêu cầu cập nhật cho một bài đăng blog hiện có, bỏ qua các bước 0-8 và bắt đầu trực tiếp tại Bước 9. Đọc các file draft hiện có trước, sau đó tiếp tục với quy trình lặp lại.

Quy Trình Thực Thi

Làm theo các bước này tuần tự. Đừng bỏ qua bước hoặc tiếp tục mà không có sự chấp thuận của người dùng nơi được chỉ ra.

Bước 0: Tạo Thư Mục Dự Án

1. Tạo tên thư mục sử dụng định dạng: YYYY-MM-DD-ten-chu-de-ngan

   • Sử dụng ngày hôm nay
   • Tạo một slug ngắn, thân thiện với URL từ chủ đề (chữ thường, gạch ngang, tối đa 5 từ)

2. Tạo cấu trúc thư mục:

   blog-posts/
   └── YYYY-MM-DD-ten-chu-de-ngan/
       └── resources/

3. Xác nhận việc tạo thư mục với người dùng trước khi tiếp tục.

Bước 1: Nghiên Cứu & Thu Thập Tài Nguyên

1. Tạo thư mục con resources/ trong thư mục bài đăng blog

2. Với mỗi tài nguyên được cung cấp:

   • URLs: Lấy và lưu thông tin chính vào resources/ dưới dạng files markdown
   • Files: Đọc và tóm tắt trong resources/
   • Chủ đề: Sử dụng tìm kiếm web để thu thập thông tin cập nhật

3. Với mỗi tài nguyên, tạo một file tóm tắt trong resources/:

   • resources/source-1-[ten-ngan].md
   • resources/source-2-[ten-ngan].md
   • v.v.

4. Mỗi tóm tắt nên bao gồm:

   # Nguồn: [Tiêu Đề/URL]
   
   ## Các Điểm Chính
   - Điểm 1
   - Điểm 2
   
   ## Trích Dẫn/Dữ Liệu Liên Quan
   - Trích dẫn hoặc thống kê 1
   - Trích dẫn hoặc thống kê 2
   
   ## Cái Này Liên Quan Đến Chủ Đề Như Thế Nào
   Giải thích ngắn về sự liên quan

5. Trình bày tóm tắt nghiên cứu cho người dùng.

Bước 2: Động Não & Làm Rõ

1. Dựa trên ý tưởng và các tài nguyên đã nghiên cứu, trình bày:

   • Chủ đề chính được xác định từ nghiên cứu
   • Góc độ tiềm năng cho bài đăng blog
   • Các điểm chính nên được bao phủ
   • Khoảng trống trong thông tin cần làm rõ

2. Đặt các câu hỏi làm rõ:

   • Điều chính bạn muốn người đọc nhận được là gì?
   • Có điểm cụ thể nào từ nghiên cứu bạn muốn nhấn mạnh không?
   • Độ dài mục tiêu là bao nhiêu? (ngắn: 500-800 từ, trung bình: 1000-1500, dài: 2000+)
   • Có điểm nào bạn muốn loại bỏ không?

3. Chờ phản hồi của người dùng trước khi tiếp tục.

Bước 3: Đề Xuất Dàn Ý

1. Tạo một dàn ý có cấu trúc bao gồm:

   # Dàn Ý Bài Đăng Blog: [Tiêu Đề]
   
   ## Thông Tin Meta
   - **Đối Tượng Mục Tiêu**: [ai]
   - **Giọng Điệu**: [phong cách]
   - **Độ Dài Mục Tiêu**: [số lượng từ]
   - **Điểm Chính Lấy Được**: [thông điệp chính]
   
   ## Cấu Trúc Được Đề Xuất
   
   ### Mở Bài/Giới Thiệu
   - Ý tưởng mở bài hấp dẫn
   - Thiết lập bối cảnh
   - Tuyên bố luận điểm
   
   ### Phần 1: [Tiêu Đề]
   - Điểm chính A
   - Điểm chính B
   - Bằng chứng hỗ trợ từ [nguồn]
   
   ### Phần 2: [Tiêu Đề]
   - Điểm chính A
   - Điểm chính B
   
   [Tiếp tục cho tất cả các phần...]
   
   ### Kết Luận
   - Tóm tắt các điểm chính
   - Kêu gọi hành động hoặc suy nghĩ cuối cùng
   
   ## Nguồn Để Trích Dẫn
   - Nguồn 1
   - Nguồn 2

2. Trình bày dàn ý cho người dùng và yêu cầu chấp thuận hoặc chỉnh sửa.

Bước 4: Lưu Dàn Ý Được Chấp Thuận

1. Khi người dùng chấp thuận dàn ý, lưu nó vào OUTLINE.md trong thư mục bài đăng blog.

2. Xác nhận dàn ý đã được lưu.

Bước 5: Commit Dàn Ý (nếu trong git repo)

1. Kiểm tra xem thư mục hiện tại có phải là một git repository không.

2. Nếu có:

   • Stage các file mới: thư mục bài đăng blog, resources, và OUTLINE.md
   • Tạo commit với thông điệp: docs: Add outline for blog post - [ten-chu-de]
   • Push đến remote

3. Nếu không phải là git repo, bỏ qua bước này và thông báo cho người dùng.

Bước 6: Viết Bản Nháp

1. Dựa trên dàn ý được chấp thuận, viết bản nháp bài đăng blog đầy đủ.

2. Làm theo cấu trúc từ OUTLINE.md chính xác.

3. Bao gồm:

   • Giới thiệu hấp dẫn với mở bài
   • Các tiêu đề phần rõ ràng
   • Bằng chứng hỗ trợ và ví dụ từ nghiên cứu
   • Chuyển tiếp mượt mà giữa các phần
   • Kết luận mạnh mẽ với điểm chính
   • Trích dẫn: Tất cả các so sánh, thống kê, dữ liệu, và yêu cầu thực tế PHẢI trích dẫn nguồn gốc

4. Lưu bản nháp dưới dạng draft-v0.1.md trong thư mục bài đăng blog.

5. Định dạng:

   # [Tiêu Đề Bài Đăng Blog]
   
   *[Tùy chọn: phụ đề hoặc câu khẩu hiệu]*
   
   [Nội dung đầy đủ với các trích dẫn nội tuyến...]
   
   ---
   
   ## Tài Liệu Tham Khảo
   - [1] Tiêu Đề Nguồn 1 - URL hoặc Trích Dẫn
   - [2] Tiêu Đề Nguồn 2 - URL hoặc Trích Dẫn
   - [3] Tiêu Đề Nguồn 3 - URL hoặc Trích Dẫn

6. Yêu Cầu Trích Dẫn:

   • Mọi điểm dữ liệu, thống kê, hoặc so sánh PHẢI có trích dẫn nội tuyến
   • Sử dụng tài liệu tham khảo đánh số [1], [2], v.v., hoặc trích dẫn có tên [Tên Nguồn]
   • Liên kết các trích dẫn với phần Tài Liệu Tham Khảo ở cuối
   • Ví dụ: "Các nghiên cứu cho thấy 65% nhà phát triển ưa thích TypeScript [1]"
   • Ví dụ: "React hoạt động tốt hơn Vue 20% về tốc độ render [React Benchmarks 2024]"