Skill CLI Cục Bộ Cho Hermes

Đánh Giá & Tối Ưu Markdown Qua Nhiều Vòng Lặp AI

Công cụ CLI tự động điều phối nhiều AI Reviewer đánh giá tài liệu Markdown của bạn dưới 4 góc nhìn chuyên sâu. Tích hợp ngữ cảnh mã nguồn dự án, tự động sửa đổi hoặc chuyển sang chế độ làm việc an toàn với ChatGPT.

Bắt Đầu Nhanh Xem Luồng Hoạt Động

Kết Quả Hermes Review Loop

⚡ Thống Kê Review Loop Mã nguồn: /mcp-app (46 tệp) Tệp đầu ra: README.md (9,675 bytes) 📊 Điểm Số Qua Các Vòng Lặp (Round): ┌───────┬──────────┬──────────────┬──────────────┬───────────┐ │ Round │ Rõ Ràng │ Thực Tiễn │ Đầy Đủ │ Kỹ Thuật │ ├───────┼──────────┼──────────────┼──────────────┼───────────┤ │ 01 │ 8/10 │ 8/10 │ 7/10 │ 9/10 │ │ 02 │ 7/10 │ 7/10 │ 8/10 │ 9/10 │ │ 03 │ 6/10 │ 9/10 │ 10/10 │ 8/10 │ └───────┴──────────┴──────────────┴──────────────┴───────────┘ ✔ Round 01 đã áp dụng ➜ Round 02 đã áp dụng ➜ Round 03 ⏳ Đang chờ ChatGPT fix 👉 Đã sao chép prompt Round-03 vào Bộ nhớ tạm (Clipboard)!

Tại Sao Nên Chọn Hermes Review Loop?

Giải pháp toàn diện giúp nâng cao chất lượng tài liệu kỹ thuật, bài viết tài liệu dự án và báo cáo quan trọng.

Đánh Giá Đa Chiều (Multi-AI)

Sử dụng kết hợp 4 góc nhìn đánh giá: Clarity (độ rõ ràng), Practicality (tính thực tiễn), Completeness (sự đầy đủ) và Technical (độ chính xác kỹ thuật).

Ngữ Cảnh Mã Nguồn & Chế Độ Rút Gọn

Tự động trích xuất cấu trúc dự án (`file-tree.md`) và sử dụng Universal Ctags để tóm tắt mã nguồn giúp tiết kiệm token tối đa khi gửi cho AI.

Tự Động Hoặc Sửa Thủ Công Qua ChatGPT

Cho phép AI Model tự động viết lại tài liệu ngay lập tức, hoặc xuất ra tệp prompt tổng hợp nhận xét để bạn tự đưa vào ChatGPT bên ngoài chỉnh sửa.

Kiểm Tra Đúng Định Dạng & Phục Hồi Backup

Mọi bản sửa đổi đều phải thông qua kịch bản kiểm tra (`validate_markdown.sh`). Đảm bảo tệp không bị rỗng, đúng cấu trúc Markdown và luôn có bản lưu dự phòng.

Lưu Trạng Thái & Tiếp Tục Chạy Tự Động

Nếu tiến trình bị gián đoạn do mất mạng hoặc quá thời gian (timeout), hệ thống tự động lưu điểm mốc checkpoint để tiếp tục chạy tiếp mà không phải làm lại từ đầu.

Tùy Biến Cấu Hình Dễ Dàng

Đặc tả mô hình AI, nhà cung cấp miễn phí (OpenRouter, DeepSeek v4, Custom router), thiết lập điểm số mục tiêu và giới hạn thời gian chạy trong tệp `config.sh`.

Luồng Xử Lý Thông Minh

Quy trình khép kín giúp nâng cấp chất lượng tài liệu tự động theo từng vòng lặp.

Đầu Vào & Kiểm Tra Nhanh

Đọc tệp Markdown đầu vào, xác minh tệp hợp lệ và khởi tạo ngữ cảnh dự án nếu có tham số --source.

AI Đánh Giá Độc Lập

Các AI Reviewer thực hiện chấm điểm theo thang điểm 10 và gửi lại phản hồi chi tiết.

Kiểm Tra Điểm Mục Tiêu

Nếu tất cả reviewer đạt TARGET_SCORE ➔ Dừng sớm và hoàn thành công việc!

Sửa Đổi Bằng AI Writer Hoặc ChatGPT

Tự động viết lại tài liệu bằng AI Writer tích hợp sẵn, hoặc tự động tổng hợp prompt nhận xét copy vào Clipboard để bạn tự xử lý trên ChatGPT. Đây là giai đoạn tối ưu hóa cốt lõi của tiến trình.

Xác Minh & Áp Dụng

Kiểm tra tính hợp lệ của bản thảo mới, lưu trữ bản sao lưu an toàn và cập nhật vào tệp gốc cho vòng lặp tiếp theo.

Hướng Dẫn Sử Dụng Lệnh CLI

Danh sách các lệnh chính để thao tác với Hermes Review Loop trên Terminal của bạn.

Kiểm tra skill đã cài đặt sẵn trong Hermes CLI hoặc tải về thủ công bằng Git:

# 1. Kiểm tra danh sách skill đã cài đặt trong Hermes CLI hermes setup hermes skills list # 2. Cài đặt thủ công bằng Git nếu chưa có sẵn git clone <repo-url> ~/.hermes/skills/hermes-review-loop cd ~/.hermes/skills/hermes-review-loop chmod +x scripts/*.sh

Chạy quy trình đánh giá mặc định hoặc tùy chỉnh tham số:

# Chạy đánh giá cơ bản cho tệp Output.md review loop --output Output.md # Chạy chế độ tự động hoàn toàn (sử dụng AI Writer để sửa bài) review loop --output Output.md --use-writer-model # Tùy chỉnh số vòng lặp tối đa và điểm số mục tiêu để hoàn thành review loop --output Output.md --rounds 2 --target-score 7

Trích xuất toàn bộ cấu trúc dự án để AI Reviewer hiểu rõ mã nguồn của bạn hơn:

# Đánh giá tài liệu kết hợp với ngữ cảnh dự án ở chế độ rút gọn (Compact Mode) review loop --output Output.md --source /path/to/project --compact

Các lệnh hỗ trợ khi bạn sử dụng chế độ sửa đổi thủ công bằng ChatGPT bên ngoài:

# Xem trạng thái tệp prompt của vòng lặp hiện tại chatgpt_helper status # Sao chép prompt đã tổng hợp vào bộ nhớ tạm (Clipboard) copy ✔ Đã sao chép vào Clipboard # Dán phản hồi nội dung đã sửa từ ChatGPT vào hệ thống để tiếp tục paste ✔ Đã nhận kết quả. Bắt đẩu review round 2

Các Tùy Chọn Cấu Hình `config.sh`

Các biến tham số chính bạn có thể điều chỉnh để tối ưu chi phí và tốc độ xử lý.

Tên Biến Cấu Hình	Giá Trị Mặc Định	Giải Thích Chức Năng
`TARGET_SCORE`	`8`	Điểm số tối thiểu (thang điểm 10) để một reviewer đánh giá là Đạt.
`MAX_ROUNDS`	`3`	Số vòng lặp kiểm duyệt tối đa trước khi dừng tiến trình.
`MIN_TARGET_SCORE_REVIEWS`	`4`	Số lượng reviewer bắt buộc phải đạt điểm để dừng sớm.
`USE_WRITER_MODEL`	`false`	`true`: AI Writer tự động sửa. `false`: Dùng chế độ ChatGPT thủ công.
`COMPACT`	`true`	Sử dụng Universal Ctags để rút gọn ngữ cảnh mã nguồn giúp tiết kiệm token.
`REVIEWER_NAMES`	`(clarity practicality completeness technical)`	Danh sách tên các AI Reviewer tham gia vào quá trình đánh giá.