Công cụ AI mã nguồn mở giúp chuẩn hóa tài liệu kỹ thuật theo tiêu chuẩn ASD-STE100

✈️ AI của bạn đang viết như một bài đăng trên LinkedIn. Hãy làm cho nó viết như một cuốn hướng dẫn sử dụng của Boeing.

Một kỹ năng agent buộc các mô hình LLM phải viết tài liệu theo tiêu chuẩn ASD-STE100 Simplified Technical English: ngôn ngữ kiểm soát được ngành hàng không sử dụng từ năm 1983 để đảm bảo một kỹ thuật viên mệt mỏi cũng không thể đọc sai hướng dẫn. Hệ quả là những nội dung AI rác rưởi sẽ bị loại bỏ. 💀

Xem chi tiết · Cài đặt · Các quy tắc · Không chỉ là tài liệu · Bằng chứng · Câu hỏi thường gặp (FAQ)

Hoạt động trên mọi môi trường hỗ trợ tiêu chuẩn Agent Skills: Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode và khoảng 25 công cụ khác. Chỉ một thư mục, không phụ thuộc, giấy phép MIT.

🔥 Trước / sau

Cột bên trái là kết quả thực tế chưa qua chỉnh sửa từ Claude. Cột bên phải là cùng một mô hình đó nhưng đã được nạp kỹ năng này.

Tận dụng kiến trúc mạnh mẽ của sqlpipe, người dùng có thể đồng bộ hóa các bảng Postgres của mình lên S3 một cách liền mạch với chi phí cấu hình tối thiểu. Trước khi bắt đầu, bạn nên đảm bảo rằng thông tin xác thực AWS của mình đã được cấu hình đúng — điều này rất quan trọng để tránh các vấn đề về quyền hạn gây khó chịu về sau.

sqlpipe sao chép các bảng Postgres của bạn lên S3. Nó chỉ cần một tệp cấu hình duy nhất.

Trước khi bắt đầu, hãy đảm bảo rằng thông tin xác thực AWS của bạn là chính xác. Nếu không, S3 sẽ từ chối việc tải lên kèm theo lỗi quyền hạn.

Rất tiếc! Đã có lỗi xảy ra trong quá trình thiết lập kết nối. Vui lòng đảm bảo thông tin xác thực của bạn đã được cấu hình đúng và thử lại, hoặc liên hệ với quản trị viên nếu sự cố vẫn tiếp diễn.

Kết nối với cơ sở dữ liệu thất bại: mật khẩu cho người dùng app không chính xác. Hãy đặt DB_PASSWORD thành giá trị đúng, sau đó kết nối lại.

Chúng tôi đã xác định được một sự cố có thể ảnh hưởng đến khả năng truy cập dịch vụ của một số người dùng. Chúng tôi chân thành xin lỗi vì bất kỳ sự bất tiện nào gây ra.

Từ 14:02 đến 14:31 UTC, 12% số yêu cầu đã thất bại. Một bản triển khai lúc 14:00 đã loại bỏ bước khởi động bộ nhớ đệm (cache warmup). Chúng tôi đã hoàn tác nó vào lúc 14:27.

Xem thêm các bản viết lại trong examples/before-after.md: các tệp README, thông báo lỗi, báo cáo sự cố, ghi chú phát hành.

📦 Cài đặt

Chỉ vậy thôi. CLI của kỹ năng này sẽ tự động phát hiện các agent của bạn (Claude Code, Cursor, Codex, Copilot, Gemini CLI và nhiều hơn nữa) và cài đặt cho những cái bạn chọn. Hãy thử trước khi cài đặt:

Không hỗ trợ SKILL.md? Hãy dán nội dung từ prompts/system-prompt.md vào system prompt, AGENTS.md hoặc.cursorrules của bạn. Thậm chí còn có phiên bản ~60 token cho những trường hợp cần tiết kiệm ngân sách.

Sau đó, hãy yêu cầu bất kỳ nội dung viết kỹ thuật nào, hoặc nói: "rewrite this with simple-english" (viết lại nội dung này bằng tiếng Anh đơn giản).

🖱️ Không dùng terminal? (claude.ai, ChatGPT, Gemini)

Claude.ai (các gói trả phí) hỗ trợ kỹ năng này một cách tự nhiên:

ChatGPT: không hỗ trợ kỹ năng, vì vậy hãy sử dụng phiên bản prompt. Sao chép khối nội dung từ prompts/system-prompt.md vào Settings → Personalization → Custom Instructions, hoặc vào phần hướng dẫn của một Project hoặc Custom GPT.

Gemini: tạo một Gem và dán cùng khối nội dung đó vào phần hướng dẫn của nó.

Bất kỳ chatbot nào khác: đính kèm hoặc dán nội dung từ prompts/system-prompt.md vào cuộc trò chuyện và nói "apply this to everything you write for me" (áp dụng nội dung này cho mọi thứ bạn viết cho tôi).

📏 Các quy tắc

53 quy tắc được đánh số, 9 phần, được viết vào năm 1983 bởi những người mà độc giả của họ có thể mất mạng nếu một câu văn gây hiểu lầm. Những quy tắc cốt lõi:

Bộ quy tắc diễn giải đầy đủ kèm ví dụ phần mềm: SKILL.md. Đúng vậy, tệp README này vi phạm một nửa số quy tắc đó. Marketing nằm ngoài phạm vi của STE. Kỹ năng này hiểu điều đó và chỉ áp dụng cho tài liệu kỹ thuật. 😌

🧰 Không chỉ là tài liệu

Kỹ năng này cung cấp các bản điều chỉnh (use-cases.md) cho:

Những nơi nó từ chối áp dụng: nội dung marketing, giọng văn blog, văn phong thương hiệu. Cố tình giữ sự đơn giản, phẳng lặng. ✋

📊 Điểm chuẩn (Benchmarks)

Giảm 72,9% các vi phạm STE trên mỗi 100 từ khi bật kỹ năng, tính trung bình trên 6 mô hình × 8 tác vụ viết (96 thế hệ văn bản, đã đo lường).

Số lượng token đầu ra cũng GIẢM trên cả sáu mô hình (kỹ năng này viết ngắn gọn hơn). Sử dụng trình kiểm tra regex xác định, cùng quy tắc cho cả hai điều kiện, danh sách các lưu ý trung thực và phương pháp đầy đủ trong evals/results/RESULTS.md. Tái lập kết quả với python3 evals/run_bench.py — chỉ cần Claude Code CLI đã đăng nhập.

🧾 Bằng chứng

Được xây dựng theo phong cách TDD dựa trên văn bản Issue 9 gốc (2025), không phải các bản tóm tắt trên blog:

❓ Câu hỏi thường gặp (FAQ)