Tư vấn

Tôi viết một công cụ kiểm tra rồi chạy thử, và chính công cụ kiểm tra đã sai trước

STAR-T
2026-08-19
9 phút đọc
#Kiểm chứng#Giới hạn của tự động hóa#Nhật ký xây dựng#Cổng chất lượng

Tôi viết một công cụ kiểm tra xem quy tắc chú thích có được tuân thủ không, chạy thử và ghi kết quả vào nhật ký. Sau đó mở bản thảo ra mới thấy thứ sai lại là công cụ kiểm tra. Đây là ghi chép về những chỗ mà kiểm tra tự động không nhìn thấy.

Ảnh đại diện bài viết «Tôi viết một công cụ kiểm tra rồi chạy thử, và chính công cụ kiểm tra đã sai trước»
Ảnh đại diện do STAR-T tự tạo

Tôi viết một công cụ kiểm tra rồi chạy thử, và chính công cụ kiểm tra đã sai trước

Pillar: P1 Nhật ký khám phá của người xây dựng (B-track · ngôi thứ 1) · Phễu: TOFU slug đề xuất: blog-p1-checker-failed-first Ngày viết: 2026-07-27 · Độ dài: khoảng 4,300 ký tự (bản gốc)

🔵 Xác nhận người kể · route (2026-08-11 · §0-0-1-C route kép)

  • operating_track: INDEPENDENT_EDITORIAL — đếm thực tế ngôi thứ 1 trong bài: 11 lần. Nếu đổi sang giọng công ty, bài viết không còn đứng vững (lời thú nhận lỗi của bản thân chính là luận điểm).
  • cta_route: FOUNDER_AI_READINESS — vì có gắn CTA nên chọn tường minh theo §0-0-1-A.
  • entry: content_buildlog_checkercontent_evergreen cũ là nhóm chung của 22 bài nên không thể quy kết.
  • Tách đo lường: lưu bài · truy cập hồ sơ · trò chuyện = chỉ số học tập của nhật ký người xây dựng (không cộng vào MKT OS ❌) / đi qua CTA funnel_lead_submit_success = lead của MKT OS (cộng vào ⭕).

1. Tôi chạy công cụ kiểm tra trên mười hai bản thảo

Chúng tôi đã quy định mỗi bài viết đưa ra bên ngoài đều phải có ba loại chú thích: tài liệu đã tham khảo kèm ngày xác nhận, những con số không dùng trong bài này, và cách bài viết được tạo ra.

Mục thứ hai hơi đặc biệt. Nó không công khai những gì đã viết mà công khai những gì đã không viết. Chúng tôi ghi lại con số nào đã bị bỏ vì chưa xác nhận được và vì sao bỏ. Câu "cái gì chưa xác nhận thì không đăng" thì ai cũng nói được, nên chúng tôi cho rằng đưa ra danh sách những thứ thực sự đã bỏ thì tốt hơn.

Vấn đề là sau khi đặt ra quy tắc này, chúng tôi chưa từng đếm xem từng bản thảo có tuân thủ hay không. Vì vậy tôi viết một công cụ kiểm tra. Nó rất đơn giản: quét thư mục bản thảo và đánh dấu xem có đủ ba loại chú thích hay không.

Kết quả như sau. Trong mười hai bản thảo, chỉ hai bản có đủ cả ba, và sáu bản không có loại nào.

Tôi ghi nguyên con số này vào nhật ký. Tôi còn thêm rằng ngay cả những bản thảo được đánh dấu là đã qua cổng kiểm duyệt cũng không có chú thích. Và tôi đi đến kết luận rằng cổng kiểm duyệt không bắt được chú thích.


2. Mở bản thảo ra thì chú thích vẫn ở đó

Sau khi ghi kết luận đó, tôi mở từng bản thảo để bổ sung chú thích.

Ba bản đã có đầy đủ chú thích từ trước.

Lý do công cụ của tôi không tìm thấy là thế này. Một bản ghi "những không dùng trong bài này" thay vì "những con số không dùng trong bài này". Một bản ghi "Tài liệu đã tham khảo" thay vì "Tài liệu tham khảo". Chỉ khác nhau một chút về cách viết. Bản còn lại dùng hẳn một tiêu đề khác là "Lưu ý về con số".

Cả ba bản đều có nội dung đúng quy tắc. Chỉ có hình thức là mỗi bản một kiểu.

Cổng kiểm duyệt vẫn đang làm đúng việc của nó. Cái sai là công cụ kiểm tra do tôi viết.

Trình tự này khiến tôi khá day dứt. Tôi chạy công cụ, lấy được con số, dùng con số đó để kết luận, và chỉ sau khi đã ghi chặt kết luận vào nhật ký mới mở bản thảo ra. Nếu mở bản thảo trước, lỗi của công cụ kiểm tra đã lộ ra trong 5 phút.


3. Nhưng mở bản thảo ra lại thấy một thứ khác

Trong lúc tiếp tục đọc bản thảo để bổ sung chú thích, tôi phát hiện một thứ mà ngay từ đầu công cụ kiểm tra đã không thể nhìn thấy.

Trong phần thân một bản thảo có câu như sau.

"Kết quả nghiên cứu ○○ cảnh báo: tần suất sử dụng AI càng cao thì tư duy phản biện càng thấp. Nghiên cứu trên ○○○ người cho thấy tương quan nghịch có ý nghĩa thống kê."

Có tên tổ chức, có cỡ mẫu, thậm chí còn nhắc đến ý nghĩa thống kê. Với người đọc, nó trông như một nghiên cứu đã được xác nhận.

Chúng tôi có một danh sách riêng ghi các nghiên cứu bên ngoài được phép trích dẫn. Danh sách này chỉ gồm những nghiên cứu mà chúng tôi đã thực sự mở bản gốc và đối chiếu cả con số lẫn bối cảnh. Trong danh sách đó, nghiên cứu này được xếp vào loại **"chỉ biết tên tổ chức"**. Tức là thuộc nhóm không được trích dẫn. Cỡ mẫu cũng là con số không có trong danh sách.

Thành thật mà nói, lúc đó tôi đã muốn chỉ ghi "Nguồn: nghiên cứu ○○" rồi cho qua. Chỉ cần điền vào ô chú thích là hình thức đã đủ.

Trước cám dỗ đó, tôi mở lại danh sách và thấy nó được ghi là cấp "chưa xác nhận". Ghi nguồn vào chú thích và có đủ tư cách để trích dẫn là hai việc khác nhau — lần này tôi lại trải qua điều đó thêm một lần nữa. Che bằng chú thích thì ngược lại còn khiến nó trông như đã được xác nhận.

Tôi bỏ cả câu. Vào chỗ đó, tôi đưa vào điều chúng tôi trực tiếp quan sát được: bản tóm tắt phỏng vấn không giữ lại những chỗ người được phỏng vấn nói lấp lửng. Tôi không đưa con số nào, và ghi việc đã bỏ cùng lý do vào chú thích của bài đó.

Cùng ngày, ở hai bản thảo khác, tôi còn thấy tên kho lưu trữ nội bộ và tên công cụ bị ghi nguyên trong phần thân. Đây cũng không phải loại thứ mà công cụ kiểm tra có thể nhìn thấy.


4. Tự động nhìn "có hay không", con người nhìn "có đủ tư cách không"

Tóm lại như sau.

Điều kiểm tra tự động đã nhìn Điều chỉ lộ ra khi con người mở ra xem
Chú thích Có chuỗi tiêu đề hay không Nội dung có đúng quy tắc không
Trích dẫn Nguồn này có được phép trích dẫn không
Định danh Có phải là tên không được đưa ra ngoài không

Kiểm tra tự động nhìn có hay không. Nó nhanh, xem toàn bộ và không biết mệt.

Điều con người phải nhìn là có đủ tư cách không. Nguồn này có thuộc cấp được trích dẫn không, cái tên này có được đưa ra ngoài không, con số này là ví dụ minh họa hay số đo thực tế. Đây không phải là phán đoán có thể tạo ra bằng kiểm tra chuỗi ký tự.

Hành động

Buổi gặp / tư vấn miễn phí

Làm rõ hành động và phạm vi tiếp theo dựa trên bối cảnh bạn vừa đọc.

Và hôm nay tôi đã làm sai thứ tự giữa hai việc đó. Tôi đã xác lập kết quả kiểm tra tự động thành sự thật rồi mới để con người kiểm tra. Lẽ ra phải ngược lại.


5. Vậy tôi đã thay đổi gì

Tôi đã làm ba việc.

Thứ nhất, tôi không xóa kết luận ghi sai mà để lại dưới dạng lịch sử đính chính. Ngay tại chỗ đã ghi "cổng kiểm duyệt không bắt được chú thích", tôi gắn nguyên việc điều đó là sai và vì sao sai. Nếu xóa đi, lần sau sẽ lại sai theo đúng cách đó.

Thứ hai, tôi chỉnh lại chú thích. Tổng cộng chín bản. Sáu bản hoàn toàn không có chú thích nên tôi viết mới; ba bản có nội dung đúng quy tắc nhưng tiêu đề mỗi bản một kiểu nên tôi chỉ chuẩn hóa hình thức. Trong mười hai bản đã quét, mười một bản ứng viên phát hành giờ đã đạt chuẩn; bản còn lại là bản đã quyết định không phát hành nên được loại khỏi phạm vi.

Khi bổ sung, tôi ghi vào mục "những con số không dùng" của mỗi bản những gì thực sự đã bỏ. Ví dụ như sau.

  • Tỷ lệ tám trên mười người được phỏng vấn từ chối không phải là số đo thực tế mà là ví dụ để giải thích
  • Số người đã được coaching là cách diễn đạt quy mô, không phải là một phân tích được thực hiện trên mẫu đã xác định
  • Hiệu quả của việc cải thiện thiết kế chưa được đo lường

Mục thứ ba đặc biệt như vậy. Một bài viết nói đã cải thiện mà không có con số cải thiện thì thấy trống trải. Vì thế người viết muốn thêm vào. Nhưng chưa đo thì không thể đưa vào, và ghi rõ việc chưa đo mới là đúng.

Thứ ba, tôi sửa công cụ kiểm tra. Chỉ có điều lần này tôi ghi kèm cả những vùng mà công cụ kiểm tra không nhìn thấy: tư cách trích dẫn và việc lộ định danh thì con người phải xem.


6. Tôi đã nghe một câu chuyện tương tự

Gần đây tôi đã nghe một buổi chia sẻ công khai của một nhóm khác chúng tôi cả về quy mô lẫn lĩnh vực.

Điều đọng lại lâu là rốt cuộc họ cũng đến một chỗ tương tự. Đó là câu chuyện dù đẩy tự động hóa đi xa đến đâu, vẫn còn lại những chỗ con người phải tự mình kiểm tra.

Tôi từng nghĩ đây là điều chúng tôi tự học được qua những lần vấp ngã. Khi biết nơi khác cũng đến được chỗ tương tự, tôi nghĩ hóa ra đây không phải là quy tắc sinh ra từ hoàn cảnh đặc biệt của riêng chúng tôi.

(Đoạn này là trí nhớ của tôi về nội dung đã nghe. Tôi không chép nguyên văn phát biểu, và không ghi tên công ty · người phát biểu · thời điểm · con số. Lý do được ghi ở chú thích ② bên dưới.)


7. Nếu hôm nay chỉ làm một việc

Nếu bạn đang chạy một công cụ kiểm tra, hãy thử xác nhận xem công cụ đó đã từng sai lần nào chưa.

Cách làm đơn giản. Hãy chọn chỉ một trường hợp mà công cụ báo "đạt" và tự mở ra xem. Ngược lại, cũng chọn một trường hợp nó báo "không đạt". Không cần xem mười cái. Một trường hợp là đủ để thấy công cụ nhìn thấy gì và bỏ sót gì.

Hôm nay tôi đã đi theo thứ tự ngược lại, và đã để lại một kết luận sai trong nhật ký một lần.


Chú thích

① Tài liệu đã tham khảo (ngày xác nhận 2026-07-27)

  • Không trích dẫn nghiên cứu · thống kê bên ngoài. Nội dung bài dựa trên nhật ký công việc rà soát bản thảo nội bộ ngày 2026-07-27 (R0 · trải nghiệm trực tiếp lần 1). Kết quả kiểm tra, lịch sử đính chính và các biện pháp đã thực hiện được lưu trong tài liệu hàng đợi phát hành và sổ cái thực thi của chúng tôi.
  • "Danh sách nghiên cứu bên ngoài được phép trích dẫn" nhắc đến ở mục 3 là quy tắc vận hành nội bộ của chúng tôi. Đây không phải là một tiêu chuẩn công bố ra bên ngoài.

② Những con số không dùng trong bài này

  • 🔴 Tên tổ chức · cỡ mẫu · năm nghiên cứu của nghiên cứu đã bỏ ở mục 3 — nghiên cứu đó thuộc cấp "chưa xác nhận" trong danh sách trích dẫn của chúng tôi nên đã bị bỏ khỏi bản thảo; nếu ghi lại ở bài này thì chẳng khác nào lặp lại chính việc đó, vì vậy tôi che bằng ○○. Khi có được bản gốc và đối chiếu, tôi sẽ công khai khi đó.
  • 🔴 Tên công ty · người phát biểu · nguyên văn phát biểu và thời điểm (thời gian cụ thể) của buổi chia sẻ công khai ở mục 6 — tôi chỉ có bản ghi chuyển giọng nói thành văn bản tự động và chưa đối chiếu với bản gốc. Vì chưa đối chiếu với bản gốc nên tôi không đăng tên thật và trích dẫn. Thay vào đó, tôi chỉ ghi ở mức trí nhớ của tôi về những gì đã nghe, không đưa con số và thời gian.
  • Số lượng bản thảo — mọi con số về số bản trong bài đều là số tệp thực tế trong thư mục bản thảo của chúng tôi. Phạm vi quét mười hai bản (mười một bản ứng viên phát hành + một bản đã quyết định không phát hành), hai bản được công cụ kiểm tra đánh giá là đầy đủ, ba bản phát hiện thêm khi tự mở ra xem, chín bản đã chỉnh sửa (sáu bản viết mới + ba bản chỉ chuẩn hóa hình thức). Tuy nhiên, đây là tình hình thư mục của chúng tôi chứ không phải chỉ số ngành, nên tôi không quy đổi thành tỷ lệ (%).
  • 🔴 Chính các con số này cũng đã sai một lần. Trong bản nháp, tiêu đề ghi "11 bản", phần thân ghi "mười hai bản", còn mục 5 ghi "mười một bản". Một bài viết khuyên hãy đếm lại trước khi chốt con số mà lại không khớp số của chính mình, nên đã bị chỉ ra trong bước kiểm chứng trước khi phát hành và được sửa lại.

③ Cách bài viết được tạo ra

Bản nháp được soạn bằng AI, sau đó con người kiểm chứng và biên tập. Các việc kiểm tra · đính chính · loại bỏ được mô tả trong bài đều đã thực sự được thực hiện, và ghi chép về chúng vẫn còn trong sổ cái của chúng tôi. Không sử dụng hình ảnh · giọng nói · video do AI tạo sinh.


CTA

Nếu bạn đã đặt dù chỉ một quy tắc kiểm tra cho các bài viết đưa ra bên ngoài, bạn có thể dùng bài chẩn đoán 2 phút để xem quy tắc đó thực sự bắt được gì và bỏ sót gì. Bạn chỉ cần trả lời trong phạm vi thấy thoải mái là được. https://www.star-t.io/vi/ai-readiness?entry=content_buildlog_checker&utm_source=blog&utm_medium=organic&utm_campaign=buildlog_2026&utm_content=blog-p1-checker-failed-first

Tương tác

Lượt xem và phản ứng được lưu làm tín hiệu nội dung nội bộ.

0 lượt xem

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

Viết công cụ kiểm tra tự động thì quy tắc chú thích sẽ được tuân thủ chứ?

Công cụ kiểm tra chỉ nhìn xem chú thích «có hay không». Trong bài này, công cụ đã chạy qua mười hai bản thảo nhưng lại không nhìn được tư cách của chú thích, và chỉ khi tự mở bản thảo ra xem tôi mới biết bên sai là công cụ kiểm tra. Kiểm tra tự động nhìn sự tồn tại, còn con người nhìn xem thứ đó có đủ tư cách làm căn cứ hay không.

Chú thích ghi những gì?

Có ba mục: tài liệu đã tham khảo kèm ngày xác nhận, những con số không dùng trong bài này, và cách bài viết được tạo ra. Mục thứ hai đặc biệt ở chỗ nó không công khai những gì đã viết mà công khai «những gì đã không viết». Chúng tôi ghi lại con số nào đã bị bỏ vì chưa xác nhận được và vì sao bỏ.

Nên xử lý kết quả kiểm tra như thế nào?

Tôi khuyên nên mở bản thảo ra xem một lần trước khi ghi việc công cụ kiểm tra cho đạt thành kết quả. Nguyên nhân dẫn đến bài viết này chính là thứ tự ngược lại — ghi kết quả trước rồi mới mở bản thảo, và ghi chép đã sai.

Đừng chỉ đọc — hãy kết nối tới dịch vụ hoặc buổi tư vấn phù hợp và bắt tay vào việc.

Khi đã hiểu vấn đề qua các bài viết, bước tiếp theo là quyết định cấu trúc thực thi. Hãy chuyển thẳng sang dịch vụ liên quan hoặc buổi tư vấn miễn phí.

Buổi gặp / tư vấn miễn phí
S

STAR-T

Chuyên gia tư vấn trưởng của STAR-T

Là chuyên gia lập kế hoạch và thiết kế dịch vụ IT, tôi nghiên cứu và chia sẻ những câu chuyện thành công từ nhiều startup và doanh nghiệp.

Hành động

Đừng chỉ đọc — hãy kết nối tới dịch vụ hoặc buổi tư vấn phù hợp và bắt tay vào việc.

Khi đã hiểu vấn đề qua các bài viết, bước tiếp theo là quyết định cấu trúc thực thi. Hãy chuyển thẳng sang dịch vụ liên quan hoặc buổi tư vấn miễn phí.