CHƯƠNG 16 / 33

Dự án 01. Chỉ Prompt vs. Ưu tiên Quy tắc: Sự Khác biệt Lớn thế Nào

Xây dựng một ứng dụng Electron knowledge-base shell tối giản — một cửa sổ với danh sách tài liệu bên trái, panel Q&A bên phải, và thư mục dữ liệu cục bộ. Bản thân tác vụ không phức tạp. Đ…

Cập nhật 10 tháng 7, 20262 phút đọc

English Version → | 中文版本 →

Bài giảng liên quan: Bài 01. Mô hình mạnh không có nghĩa là thực thi đáng tin cậy · Bài 02. Harness thực sự có nghĩa là gì Tệp mẫu: templates/

Bạn Làm Gì

Xây dựng một ứng dụng Electron knowledge-base shell tối giản — một cửa sổ với danh sách tài liệu bên trái, panel Q&A bên phải, và thư mục dữ liệu cục bộ. Bản thân tác vụ không phức tạp. Điều phức tạp là cách bạn để agent hoàn thành nó.

Bạn chạy hai lần. Lần đầu: chỉ một prompt, không chuẩn bị gì. Lần hai: AGENTS.md, init.sh, feature_list.json được đặt sẵn trong repo. Sau đó so sánh.

Kịch bản của bài học này dùng một khoảng tái khám phá/chuẩn bị ngắn làm ví dụ, không phải kết quả đo cố định.

Công cụ

Claude Code hoặc Codex (chọn một, sử dụng cho cả hai lần chạy)
Git (quản lý branch và so sánh)
Node.js + Electron (tech stack dự án)
Đồng hồ đo thời gian (ghi lại thời gian mỗi lần chạy)

Cơ chế Harness

Harness tối giản: AGENTS.md + init.sh + feature_list.json

Dùng project đã có sẵn trong repo

Đường dẫn trong repo: projects/project-01/

Thư mục	Có gì bên trong	Cách dùng / so sánh
`starter/`	Lượt chạy harness yếu. Chỉ có `task-prompt.md` làm mô tả nhiệm vụ, không có `AGENTS.md` hay `feature_list.json`.	Đưa prompt cho agent và đo xem nó hoàn thành được gì khi không có cấu trúc bổ sung.
`solution/`	Cùng slice sản phẩm nhưng có artefact harness rõ ràng: `AGENTS.md`, `CLAUDE.md`, `init.sh`, `feature_list.json`, `claude-progress.md`.	So sánh cách quy tắc và kiểm chứng biến cùng nhiệm vụ thành thứ có thể chạy và kiểm tra được.

Bốn tính năng cụ thể là: mở cửa sổ, danh sách tài liệu, panel câu hỏi, và tạo thư mục dữ liệu cục bộ. Xem solution/feature_list.json để biết bằng chứng mong đợi cho từng tính năng.

Giấy phép nội dung

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.