rag-fallback

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Chỉ load skill này khi CẢ HAI điều sau đúng:

```
mcp-loop
```
đã chạy tối thiểu 3-5 lần và vẫn còn lỗi compile cùng một chỗ.
Lỗi có dấu hiệu liên quan đến API/package đã đổi signature, bị deprecated, hoặc hàm không tồn tại như mô tả trong skill/agent-plugins hiện có (ví dụ: "method not found", "this constructor is deprecated", tên hàm đã đổi giữa các version).

Nếu lỗi là do logic của chính agent viết sai (không liên quan version) → không cần fallback, quay lại sửa trực tiếp trong

mcp-loop

仅当以下两个条件同时满足时，才加载此skill：

```
mcp-loop
```
已运行至少3-5次，但同一位置仍存在编译错误。
错误迹象表明API/package已更改签名、被废弃，或者当前skill/agent-plugins中描述的函数不存在（例如："method not found"、"this constructor is deprecated"、函数名称在不同版本间已更改）。

如果错误是由于agent自身编写的逻辑错误（与版本无关）→ 无需回退，直接返回

mcp-loop

中修改。

Xác định chính xác package/API đang gây lỗi (tên package + version hiện tại trong
```
pubspec.lock
```
).
Dùng
```
web_fetch
```
/
```
mcp_fetch
```
lấy tài liệu chính thức mới nhất của package đó (changelog, migration guide nếu có) - ưu tiên nguồn chính chủ (pub.dev, docs.flutter.dev, GitHub repo của package).
Tìm phần liên quan đến API đang lỗi, đối chiếu cú pháp mới.
Cập nhật code theo cú pháp mới, quay lại
```
mcp-loop
```
để build lại.
Nếu skill/agent-plugins hiện tại rõ ràng đã lỗi thời (không chỉ 1 API lẻ mà cả cách tiếp cận), ghi chú lại vào
```
openspec/config.yaml
```
(mục
```
context
```
) hoặc báo user để cân nhắc cập nhật lại skill gốc - không tự động sửa file skill của Google.

Tối đa 2 lần fetch + sửa theo hướng RAG fallback. Nếu vẫn lỗi sau đó → dừng hẳn theo quy định trong

mcp-loop/SKILL.md

(xuất log, báo user), không tiếp tục fetch thêm nhiều nguồn khác nhau gây tốn token.

最多进行2次RAG回退方向的获取+修改操作。如果之后仍出错→按照

mcp-loop/SKILL.md

中的规定停止（输出日志，告知用户），不得继续获取更多不同来源的内容以避免浪费token。

Route lệnh fetch qua model/kênh rẻ nhất đủ dùng (nếu có 9Router hoặc tương đương), không cần dùng model mạnh nhất chỉ để đọc changelog.
Không fetch "phòng hờ" trước khi biết chắc có lỗi - đây là fallback, không phải bước mặc định của
```
flutter-coding
```
.