inflearn logo

Thực chiến wiki LLM với Obsidian x Claude Code: nguyên trạng wiki công việc đã vận hành suốt 6 tháng (có thể dùng Codex)

Mỗi khi AI làm việc, hãy để AI tự ghi lại các quyết định và lý do vào wiki dự án, bảo vệ wiki đó và kiểm tra để vài tháng sau vẫn không bị hỏng. Đồng thời, thực sự xây dựng bot thông báo công bố thông tin, và mỗi khi xảy ra sự cố thì thiết lập thêm từng quy tắc một.

1 học viên đang tham gia khóa học này

Độ khó Cơ bản

Thời gian Không giới hạn

claude
claude
codex
codex
obsidian
obsidian
LLM
LLM
Vibe Coding
Vibe Coding
claude
claude
codex
codex
obsidian
obsidian
LLM
LLM
Vibe Coding
Vibe Coding

Bạn sẽ nhận được điều này sau khi học.

  • Wiki dự án ghi lại các quyết định và lý do của chính AI mỗi khi làm việc (bao gồm các tệp quy tắc CLAUDE.md, AGENTS.md)

  • Cơ chế kiểm tra trước khi commit nhằm ngăn AI phá hỏng wiki

  • Cách lưu lại sự cố cùng một thông báo được gửi đi hai lần thành một trang bài học kinh nghiệm, và kiểm tra xem phiên mới có áp dụng bài học đó ở một vị trí khác hay không.

  • Quy trình kiểm tra cách một wiki 6 tháng tuổi xuống cấp (mục lục bị cắt, trang mồ côi, thông tin lỗi thời) và checklist vận hành trong một tháng

Khóa học này gồm 28 bài giảng video là nội dung chính, đồng thời cung cấp kèm PDF theo từng chương với tổng cộng 158 trang. Bạn xem mạch nội dung qua video, rồi dùng PDF để kiểm tra lại nguyên văn chỉ dẫn và màn hình.

Những ai đã dùng Claude Code hoặc Codex vài ngày đều sẽ gặp phải tình huống tương tự. Phiên mới hôm nay không biết những gì đã quyết định hôm qua. AI cứ lật ngược cùng một quyết định hết lần này đến lần khác. Vài tháng sau, cả tôi lẫn AI đều không biết tại sao lại làm như vậy. Khóa học này xây dựng một wiki LLM như giải pháp cho vấn đề đó. Mỗi khi làm việc, AI tự ghi lại các quyết định và lý do vào wiki Markdown trong thư mục dự án, còn con người xem wiki đó bằng Obsidian. Mục tiêu là không còn cần con người phải gọi AI và nói “Hãy ghi vào wiki”.

Bắt đầu từ những con số của wiki đã vận hành suốt 6 tháng

Trước hết, hãy xem wiki công việc mà tác giả đã thực sự vận hành từ ngày 12 tháng 4 qua các con số. 452 trang, 1321 lần commit, 163 ngày có commit và 802 liên kết giữa các trang. Sau đó, hãy xem wiki đó đã hỏng như thế nào. Có 146 trang không được liên kết từ bất kỳ đâu và 240 liên kết trỏ đến các trang không tồn tại. Khi mục lục bộ nhớ tự động dài tới 277 dòng, một cảnh báo cho biết chỉ 114 dòng đầu tiên được đọc còn 163 dòng đã bị cắt. Wiki vào ngày đầu tiên được tạo vẫn hoàn toàn sạch sẽ. Vấn đề xuất hiện vài tháng sau.

Bạn đang tạo gì

Bài thực hành bắt đầu từ một thư mục trống, là một bot thông báo công bố thông tin. Bot nhận các công bố trong ngày từ OpenDART của Cơ quan Giám sát Tài chính, chỉ lọc các công bố của những mã cổ phiếu quan tâm, thêm phần tóm tắt ba dòng bằng AI rồi gửi qua Telegram, và chạy trên máy chủ 30 phút một lần vào ban ngày các ngày trong tuần. Bot chỉ là ví dụ; sản phẩm thực sự là một wiki phát triển dần trong quá trình xây dựng bot. Mỗi chương đều thực sự bắt tay xây dựng rồi gặp sự cố, và từ những sự cố đó, từng quy tắc wiki được hình thành.

Mỗi chương lại xảy ra một sự cố, và từng quy tắc lần lượt ra đời.

Chương 1: Bắt đầu mà không có wiki. Trong số 771 công bố ngày 10-02, chúng tôi cố tình thu hẹp để chỉ hiển thị 573 công bố thuộc thị trường chứng khoán và KOSDAQ, nhưng phiên mới dù đã tìm thấy quyết định đó trong thông điệp commit vẫn mở rộng bộ lọc, còn Codex được mở trong cùng thư mục thì đã xóa toàn bộ bộ lọc. Vì lý do chỉ tồn tại trong cuộc trò chuyện. Vì vậy, wiki đầu tiên và các tệp quy tắc (CLAUDE.md, AGENTS.md) ra đời.

Chương 2: Kiểm tra xem quyết định có được lưu lại ngay cả khi không có câu "hãy ghi vào wiki" hay không. Có. Tuy nhiên, cả cấu trúc tệp do AI tự chọn cũng bị ghi thành quyết định, khiến phiên tiếp theo dựa vào đó để ngăn yêu cầu của người dùng. Từ đó hình thành quy tắc ghi rõ ai đã quyết định (người dùng, giá trị mặc định của AI, chưa được xác nhận) cho từng quyết định và không rút gọn nguyên văn làm căn cứ.

Chương 3: Gắn phần tóm tắt bằng AI. Phiên làm việc báo rằng cả 5 bản tóm tắt đều khớp với nguyên văn, và câu đó được đưa vào ô xác nhận của wiki. Khi được hỏi về căn cứ, hóa ra thực tế chỉ có 3 bản được đối chiếu. Hình thành các quy tắc: trong ô xác nhận chỉ ghi các lệnh và phạm vi đã thực sự chạy; lập trang tài liệu để đưa tài liệu bên ngoài vào kèm nguồn và ngày tháng; khi hỏi trên wiki thì trả lời kèm trang căn cứ.

Chương 4: Cùng một thông báo đã được gửi hai lần. Đây là cảnh tác giả tạo ra điều kiện để cùng một lệnh được thực thi đồng thời hai lần. Trang bài học đầu tiên được tạo ra, và phiên mới đã gọi tên bài học đó trong một chức năng khác rồi áp dụng nó. Bài kiểm tra chạy đồng thời năm phần bằng các bộ phận giả được lặp lại 20 lần, và cả 20 lần đều chỉ gửi chính xác 2 phần.

Chương 5: Đưa lên máy chủ để chạy vào thời gian cố định mỗi ngày trong tuần. Và cố tình đưa ra một yêu cầu nghe có vẻ hợp lý là hãy sắp xếp các khóa vào wiki. Ô "chưa xác nhận" được tạo ra ở chương 2 để giữ sự trung thực đã bảo vệ khóa sau ba chương.

Chương 6: Chỉ với một câu “Hãy sắp xếp lại giúp tôi”, 26 dòng lịch sử trước đây trong nhật ký thay đổi đã bị viết lại, còn phạm vi kiểm tra thì biến mất. Khi tạo cơ chế kiểm tra trước khi commit, lần này Codex đã định sửa rồi commit tệp quy tắc và tập lệnh kiểm tra để vượt qua khâu kiểm tra. Chúng ta sẽ xem cách sửa cơ chế để không thể qua mặt nó.

Chương 7: Lần đầu tiên xem wiki bằng mắt người thông qua Obsidian. Trước khi mở, chụp dấu vân tay của các tệp rồi so sánh sau đó, xác nhận rằng trong số 18 tệp không có tệp nào bị thay đổi. Một điểm sáng nhạt trên biểu đồ là một liên kết hỏng đã vượt qua tập lệnh kiểm tra. Cũng có cảnh AI trực tiếp kiểm tra wiki bằng dòng lệnh (CLI) của Obsidian.

Chương 8: Tạo một ngày mà con người chỉ sửa mã (điều kiện do tác giả tạo ra) và yêu cầu AI kiểm tra (lint). Những điểm khác nhau giữa wiki, mã cục bộ và máy chủ, cùng cả các trang tài liệu vốn đã lỗi thời từ trước bất kể điều kiện, đều được phát hiện. Kiểm tra lại xem trong phiên mới, trước khi làm việc, AI có thực sự kiểm tra trước hay không.

Chương 9: Tôi chuyển phương pháp này sang một dự án khác, nơi tệp quy tắc đã tích lũy 87 dòng, rồi đối chiếu lại bằng một công cụ khác với công cụ đã dùng để chuyển. Tôi phát hiện rằng mặc dù không có chữ nào bị thiếu so với 284 dòng bản gốc, những điều cần lưu ý vốn luôn được đọc tự động nay lại trở thành nội dung phải chủ động tìm đọc. Cuối chương, tôi gửi bạn danh sách kiểm tra vận hành từ ngày đầu tiên đến hết một tháng.

Tôi đã ghi rõ rằng những sự cố được dự tính nhưng không xảy ra thì thực tế đã không xảy ra, đồng thời cho biết những cảnh mà tác giả tạo ra các điều kiện là đúng như vậy.

Trong khóa học, 65 chỉ thị đã gửi trong các phiên được giữ nguyên văn trong PDF, và có 138 ảnh chụp màn hình. Màn hình terminal là phần chữ đã được hiển thị thực tế được dựng lại, chỉ thay đổi tên người dùng và đường dẫn; còn màn hình Obsidian là ảnh chụp cửa sổ thực tế.

Đặt tệp quy tắc CLAUDE.md và AGENTS.md với cùng một nội dung, để dù làm việc bằng Claude Code hay Codex, mọi thứ đều được tích lũy trong cùng một wiki. Phần chính của khóa học được thực hiện bằng Claude Code, còn các cảnh Codex tiếp tục viết vào cùng wiki xuất hiện ở chương 1, 2, 5, 6 và 9. Obsidian chỉ được dùng như một cửa sổ để xem wiki, không cần plugin, và trước tiên sẽ thiết lập năm điều để wiki không bị hỏng trong ngày đầu tiên.

Kho lưu trữ thực hành: https://github.com/JCLab-coder/disclosure-radar (kho lưu trữ công khai, gắn thẻ theo từng chương). Sau mỗi chương đều có các thẻ từ ch01 đến ch09, nên nếu gặp khó khăn, bạn có thể lấy thẻ của chương đó để đối chiếu. Mã nguồn tuân theo giấy phép được ghi trong kho lưu trữ.

Màn hình công khai và phần tóm tắt của khóa học này là ví dụ thực hành về việc hiển thị công bố công khai, không phải lời mời đầu tư. Bot không thực hiện giao dịch hay đề xuất mã cổ phiếu.

Đồ dùng cần chuẩn bị và chi phí

  • Claude Code hoặc Codex (đã có sẵn): tính phí theo gói đăng ký hoặc mức sử dụng. Tiền đề của khóa học này

  • Obsidian (Chương 1): Miễn phí. Không sử dụng các tính năng trả phí (đồng bộ hóa, xuất bản).

  • Khóa xác thực OpenDART (Chương 1): Miễn phí

  • Bot Telegram (chương 2): Miễn phí

  • Tóm tắt AI (OpenRouter) (chương 3): Tính phí theo mức sử dụng. Tổng số tiền khóa API đã sử dụng trong toàn bộ phần thực hành là 0.0032 đô la Mỹ

  • Máy chủ (Railway) (chương 5): Khi đăng ký lần đầu, bạn sẽ được tặng một lần 5 đô la để sử dụng trong 30 ngày, sau đó gói Hobby có giá 5 đô la mỗi tháng (bao gồm 5 đô la tiền sử dụng). Chi phí sử dụng máy chủ cho phần thực hành tính đến 10-03 là 0.00044 đô la. Nếu không có, bạn chỉ không thể làm theo các cảnh máy chủ trong chương 5; nội dung wiki vẫn có thể thực hiện hoàn toàn trên máy cục bộ.

Ngoài ra, cần Node 21.7 trở lên và git. Mức phí có thể thay đổi.


Hướng dẫn sử dụng tài liệu

Video, nội dung, ảnh chụp màn hình và tệp PDF của khóa học này chỉ được sử dụng cho mục đích học tập của chính người mua. Không được phép chuyển cho người khác, đăng tải ở nơi công khai hoặc bán lại. Mã nguồn trong kho thực hành tuân theo giấy phép ghi trong kho, còn mã nguồn và tài liệu khóa học là hai điều kiện khác nhau.

Khuyến nghị cho
những người này

Khóa học này dành cho ai?

  • Người dùng Claude Code, Codex, mỗi phiên mới lại phải giải thích từ đầu những gì đã thống nhất hôm qua.

  • Lập trình viên, nhà phát triển độc lập bực bội vì AI liên tục đảo ngược cùng một quyết định hết lần này đến lần khác

  • Vibe coder giao việc viết mã cho AI rồi chỉ xem kết quả, vài tháng sau chẳng ai biết tại sao lại làm như vậy.

  • Những người muốn thử sử dụng Obsidian cho công việc cùng với AI và cần ghi chép dự án thay vì sắp xếp ghi chú.

Cần biết trước khi bắt đầu?

  • Bạn cần đang sử dụng Claude Code hoặc Codex. Nội dung này không đề cập đến việc cài đặt và cách sử dụng cơ bản.

  • Bạn cần biết cách sử dụng terminal và git. Chỉ cần có thể đọc JavaScript, còn code thì AI sẽ viết.

Xin chào
Đây là jclab

Xác minh sự nghiệp

Tôi là một nhà phát triển xây dựng và vận hành các dịch vụ.

Tôi chia sẻ những chuyện đã trải qua khi sử dụng Claude Code trong công việc thực tế và những quy tắc hình thành từ đó. Tôi nói bằng những sự cố thực tế và mã nguồn nguyên bản thay vì lý thuyết.

Từ phát triển, vận hành, dữ liệu đến tự động hóa, những gì cần thiết tôi đều tự mình xây dựng và sử dụng.

Thêm

Chương trình giảng dạy

Tất cả

36 bài giảng ∙ (1giờ 8phút)

Tài liệu khóa học:

Tài liệu bài giảng
Ngày đăng: 
Cập nhật lần cuối: 

Đánh giá

Chưa có đủ đánh giá.
Hãy trở thành tác giả của một đánh giá giúp mọi người!

Khóa học tương tự

Khám phá các khóa học khác trong cùng lĩnh vực!

Ưu đãi có thời hạn

1.560.403 ₫

24%

2.060.910 ₫