nodejs-core

Tổng quan về nodejs-core skill

nodejs-core dùng để làm gì

nodejs-core skill dành cho việc debug và xây dựng ở tầng nội bộ của Node.js: native addon, C++ binding, hành vi của V8, lập lịch của libuv, lỗi build, và các vấn đề hiệu năng mà những prompt JavaScript thông thường thường bỏ sót. Skill này hữu ích nhất khi bạn cần nodejs-core cho công việc Backend Development liên quan đến ranh giới JS/C++ hoặc phụ thuộc vào cơ chế runtime của Node.

Ai nên dùng và cho những việc gì

Hãy dùng nodejs-core skill nếu bạn đang:

• sửa lỗi build binding.gyp hoặc node-gyp
• điều tra crash, segfault, memory leak, hoặc native test lúc đúng lúc sai
• viết hoặc review code dựa trên N-API, node-addon-api, hoặc NAN
• tinh chỉnh hành vi của event loop, worker thread, hoặc thread pool
• chẩn đoán V8 deopt, áp lực GC, hoặc regression do hidden class

Điểm khác biệt của skill này

Skill này được tổ chức quanh các quy tắc có thể hành động ngay của Node core, chứ không phải một bản tổng quan chung chung. Giá trị nằm ở các file hỗ trợ trong rules/: chúng tách riêng workflow build, V8, libuv, native memory, tùy chọn CLI, và đường dẫn debug để agent chọn đúng subsystem thật nhanh.

Cách dùng nodejs-core skill

Cài đặt và giới hạn phạm vi cho đúng

Cài nodejs-core bằng lệnh skill của repository, rồi chỉ dùng nó khi tác vụ của bạn cần hiểu nội bộ runtime hoặc lý giải build native. Nếu vấn đề của bạn chỉ là Express, thiết kế API, hoặc logic TypeScript thuần, skill này có lẽ quá thấp tầng.

Bắt đầu từ đúng file

Khi cài nodejs-core và đọc lần đầu, hãy mở:

• SKILL.md để xem phạm vi và điểm vào
• rules/build-and-test-workflow.md cho vòng lặp sửa-build-test bắt buộc
• rules/build-system.md cho ngữ cảnh biên dịch và binding.gyp
• file rule của subsystem khớp với vấn đề của bạn, như rules/napi.md, rules/libuv-event-loop.md, rules/v8-jit-compilation.md, hoặc rules/debugging-native.md

Biến một yêu cầu mơ hồ thành prompt dùng được

Một yêu cầu yếu như “help with a Node addon crash” là quá rộng. Một prompt dùng nodejs-core tốt hơn sẽ có:

• nền tảng: Linux/macOS/Windows
• phiên bản Node và kiểu build
• dạng lỗi chính xác: compile error, abort, hang, deopt, leak, sai output
• gợi ý subsystem: N-API, libuv, V8, child process, streams, hoặc memory
• thay đổi gần đây là gì
• command hoặc test tái hiện được lỗi

Dạng ví dụ:
Use nodejs-core to diagnose a native addon crash on Node 22. The addon uses N-API, fails only in release builds, and crashes after a GC cycle. Focus on likely root causes, what to inspect in rules/napi.md and rules/memory-debugging.md, and the fastest repro steps.

Workflow giúp cho kết quả tốt hơn

Hãy bắt đầu bằng file rule phù hợp, rồi map triệu chứng về subsystem nhỏ nhất có thể. Với lỗi build, đọc workflow build trước; với lỗi runtime, đọc rule của subsystem rồi đối chiếu repro của bạn với hành vi Node kỳ vọng. Nếu tác vụ liên quan đến file đã sửa trong src/ hoặc lib/, hãy rebuild trước khi test để không đuổi theo output cũ.

Câu hỏi thường gặp về nodejs-core skill

nodejs-core chỉ dành cho người đóng góp cho Node core sao?

Không. Nó cũng hữu ích cho tác giả addon, kỹ sư nền tảng, và các team backend đang gỡ lỗi sự cố production xảy ra bên dưới lớp JavaScript. Bạn không cần phải đóng góp cho Node core mới dùng được nodejs-core skill.

Nó khác gì so với một prompt bình thường?

Một prompt bình thường có thể đoán theo cách sửa ở mức JavaScript. nodejs-core mạnh hơn khi câu trả lời phụ thuộc vào build flag, binary embedding, hành vi tối ưu của C++ binding, hoặc nội bộ libuv. Nó giảm phỏng đoán bằng cách dẫn workflow tới đúng subsystem rules.

Nó có thân thiện với người mới không?

Có, nếu câu hỏi đủ cụ thể. Nó kém thân thiện hơn với những yêu cầu mơ hồ kiểu “tại sao Node chậm?”. Người mới sẽ có kết quả tốt hơn khi đưa ra lệnh repro, stack trace, và subsystem liên quan. Như vậy cách dùng nodejs-core sẽ chính xác hơn nhiều.

Khi nào không nên dùng?

Hãy bỏ qua skill này cho lỗi framework, kiến trúc ứng dụng, hoặc cách dùng API thông thường. Cũng nên tránh nếu bạn không thể cung cấp repro hoặc ít nhất một nhóm lỗi rõ ràng; skill này mạnh nhất khi vấn đề đã trông giống lỗi runtime, build, hoặc tích hợp native.

Cách cải thiện nodejs-core skill

Cung cấp đúng bằng chứng cho skill

Đầu vào hữu ích nhất là dữ liệu chính xác: stack trace, build log, node -p process.versions, compile flags, và reproduction nhỏ nhất có thể. Với nodejs-core cho Backend Development, cũng nên nói rõ service đang bị CPU-bound, memory-bound hay nghẽn I/O, vì điều đó quyết định quy tắc nào trong V8, libuv, hay native memory quan trọng nhất.

Chỉ đích danh subsystem càng sớm càng tốt

Đừng bắt model tự “đọc” cả repo trong đầu. Hãy nói rõ vấn đề gần với:

• rules/napi.md hoặc rules/node-addon-api.md
• rules/v8-garbage-collection.md hoặc rules/profiling-v8.md
• rules/libuv-event-loop.md hoặc rules/libuv-thread-pool.md
• rules/debugging-native.md hoặc rules/native-memory.md

Chú ý các lỗi thất bại thường gặp

Sai sót phổ biến nhất là xem một vấn đề build như bug runtime, hoặc cho rằng một sửa ở JavaScript sẽ giải quyết được lỗi C++/binding. Một lỗi khác cũng rất thường gặp là quên rebuild sau khi sửa src/ hoặc lib/. Nếu câu trả lời đầu tiên còn quá rộng, hãy lặp lại với một repro sắc hơn, một đoạn code nhỏ hơn, và một chỉ dẫn rõ ràng kiểu “tập trung vào build hay runtime”.

Dùng câu trả lời đầu tiên như một bước khoanh vùng

Hãy coi đầu ra đầu tiên là bước triage: yêu cầu subsystem có khả năng cao nhất, lệnh chẩn đoán tiếp theo, hoặc file chính xác cần xem tiếp. Kết quả nodejs-core thường tốt hơn sau một vòng tinh chỉnh, nhất là khi bạn thêm command gây lỗi, nền tảng chạy, và một triệu chứng cụ thể thay vì mô tả chung chung.