Xây dựng quy trình lập trình định tuyến với Bộ điều phối Fable

Fable làm gì

Fable là một skill định tuyến nhỏ, ưu tiên cục bộ cho Codex. Skill này tách biệt việc lập kế hoạch khỏi triển khai: Claude Fable 5.1 lập kế hoạch và phân xử các quyết định, trong khi Codex vẫn là runtime, kiểm soát workspace và ủy quyền các tác vụ triển khai có phạm vi giới hạn cho các agent OpenCode Go.

Hoạt động triển khai thông thường được giao cho GPT-5.6 Luna. Công việc liên quan đến vòng lặp, lặp lại nhiều lần hoặc triển khai với thông lượng cao được giao cho DeepSeek V4 Flash. Claude Fable 5.1 nằm ngoài đồ thị triển khai, không viết mã và không sở hữu workspace.

Fable là một skill điều phối, không phải cổng kết nối mô hình độc lập hay bảng điều khiển phát triển.

Tính năng chính

• Vận hành ưu tiên cục bộ: skill được cài đặt trong thư mục skill cục bộ của Codex.
• Phân tách vai trò rõ ràng: Fable lập kế hoạch và phân xử, còn Codex thực thi và xác minh công việc.
• Ủy quyền có giới hạn: các nút triển khai chỉ sử dụng các tuyến GPT-5.6 Luna hoặc DeepSeek V4 Flash được cho phép.
• Thực thi song song: Codex có thể khởi chạy song song các worker đã sẵn sàng khi phù hợp.
• Xác minh dựa trên bằng chứng: Codex thu thập bằng chứng từ worker và xác minh kết quả trước khi hoàn tất quy trình.
• Định tuyến an toàn khi lỗi: nếu không thể gọi tuyến OpenCode Go được cho phép nào, quy trình sẽ báo cáo trở ngại thay vì thay thế bằng mô hình chưa được phê duyệt.
• Cài đặt an toàn, có thể lặp lại: trình cài đặt hỗ trợ chạy thử, đích tùy chỉnh và sao chép idempotent.

Tìm hiểu repository

Repository chứa skill có thể cài đặt, trình cài đặt, các bài kiểm thử và một tài sản kiến trúc:

skill/fable/
├── SKILL.md
├── agents/openai.yaml
└── scripts/ask_fable.sh
assets/fable-orchestrator.svg
install.sh
tests/test_skill.sh

Ba tệp bên trong skill/fable/ tạo thành skill có thể cài đặt. Tập lệnh ask_fable.sh có quyền thực thi và gọi bí danh fable cục bộ của Claude Code mà không duy trì phiên.

Điều kiện tiên quyết

Trước khi cài đặt skill, hãy cấu hình các agent có thể gọi opencode-go/ và opencode-go-responses/ thông qua Codex Router. Fable sử dụng các agent này nhưng không cung cấp proxy, bảng điều khiển, danh mục mô hình, kho thông tin xác thực hay API key riêng.

Khởi động lại Codex sau khi thay đổi định nghĩa provider hoặc agent. Việc này đảm bảo tác vụ mới sử dụng cấu hình định tuyến hiện tại.

Cài đặt Fable

1. Xem trước quá trình cài đặt

Từ thư mục gốc của repository, chạy trình cài đặt ở chế độ chạy thử:

./install.sh --dry-run

Lệnh này in ra đích đến và các thao tác sao chép chính xác mà không tạo tệp. Hãy dùng lệnh này để xác nhận trình cài đặt sẽ thực hiện gì trước khi thay đổi.

2. Cài đặt vào thư mục mặc định

Sao chép skill vào vị trí skill mặc định của Codex:

./install.sh --copy

Đích mặc định là ~/.codex/skills/fable. Trình cài đặt chỉ tạo các thư mục cần thiết và có thể chạy lặp lại an toàn.

3. Chọn thư mục skill tùy chỉnh

Sử dụng --target khi muốn cài đặt ở nơi khác với vị trí mặc định:

./install.sh --copy --target "$PWD/.local/codex/skills"

Trình cài đặt chỉ đọc repository và đường dẫn đích. Trình cài đặt không đọc, tạo hoặc sửa đổi thông tin xác thực.

Cách sử dụng cơ bản

Bắt đầu một tác vụ Codex mới, sau đó gọi skill với một mục tiêu:

$fable build the feature

Fable trả về một đồ thị công việc có phạm vi giới hạn. Codex xác thực đồ thị đó, khởi chạy song song các worker đã sẵn sàng khi phù hợp, thu thập bằng chứng và xác minh công việc kết quả. Nếu cần một quyết định lập kế hoạch khác, Codex yêu cầu Fable phân xử.

Cách định tuyến hoạt động

1. Fable phân tích mục tiêu và tạo một kế hoạch có phạm vi giới hạn.
2. Codex xác thực đồ thị được đề xuất trước khi thực thi.
3. Các nút triển khai thông thường được định tuyến đến GPT-5.6 Luna.
4. Các nút triển khai cần lặp lại nhiều hoặc có thông lượng cao được định tuyến đến DeepSeek V4 Flash.
5. Codex thu thập bằng chứng và xác minh kết quả cuối cùng.
6. Fable được tham vấn lại khi cần phân xử thêm.

Mỗi nút triển khai phải sử dụng một trong hai tuyến OpenCode Go được cho phép. Nếu không có tuyến nào khả dụng, hãy xem trở ngại được báo cáo là vấn đề cấu hình thay vì tìm cách vượt qua chính sách định tuyến.

Xử lý an toàn các gói lập kế hoạch

Gói được truyền đến ask_fable.sh chỉ nên chứa các quyết định và thông tin thực tế về workspace. Không bao giờ đưa thông tin xác thực, API key, token hoặc bí mật khác vào gói.

Vì tập lệnh gọi bí danh fable cục bộ mà không duy trì phiên, mỗi yêu cầu nên bao gồm các thông tin thực tế liên quan cần thiết cho bước lập kế hoạch hoặc phân xử đó.

Kiểm thử cài đặt

Chạy bộ kiểm thử ít phụ thuộc của repository từ thư mục gốc repository:

tests/test_skill.sh

Bài kiểm thử bao gồm:

• Cú pháp shell.
• Các tệp nguồn được trình cài đặt sao chép.
• Các chuỗi định tuyến bắt buộc.
• Cấu trúc YAML cơ bản.
• Xác thực XML tùy chọn thông qua xmllint.
• Các ràng buộc an toàn của SVG.
• Chạy thử bằng thư mục home tạm thời.
• Thao tác sao chép idempotent.
• Kiểm tra các chuỗi phổ biến có dạng thông tin xác thực.

Bài kiểm thử không yêu cầu PyYAML hoặc đăng nhập Claude đang hoạt động, nên phù hợp để xác thực cục bộ nhẹ.

Mẹo vận hành nâng cao

Xác thực định tuyến trước khi gỡ lỗi skill

Nếu Fable báo rằng không thể gọi bất kỳ tuyến triển khai nào được cho phép, trước tiên hãy kiểm tra các định nghĩa Codex Router cho opencode-go/ và opencode-go-responses/. Sau khi thay đổi định nghĩa nhà cung cấp hoặc tác nhân, hãy khởi động lại Codex và bắt đầu một tác vụ mới.

Sử dụng chế độ chạy thử cho các triển khai tùy chỉnh

Khi cài đặt vào thư mục kỹ năng cục bộ của dự án hoặc thư mục không theo tiêu chuẩn, hãy kết hợp --dry-run với --target trước khi sao chép:

./install.sh --dry-run --target "$PWD/.local/codex/skills"
./install.sh --copy --target "$PWD/.local/codex/skills"

Điều này cho phép bạn kiểm tra thư mục đích và các thao tác tệp dự kiến trước khi sửa đổi thư mục đã chọn.

Chạy lại quá trình cài đặt khi cập nhật

Vì thao tác sao chép là bất biến theo thời gian, bạn có thể chạy lại một cách an toàn khi làm mới kỹ năng đã cài đặt từ kho lưu trữ. Sau thao tác sao chép, hãy chạy tests/test_skill.sh để xác thực các bước kiểm tra của kho lưu trữ.

Phân tách các trách nhiệm

Không nên xem Fable là một tác nhân thực hiện triển khai. Các trách nhiệm được ghi rõ của Fable là lập kế hoạch và phân xử cuối cùng. Codex vẫn nắm quyền kiểm soát thời gian chạy, quyền sở hữu không gian làm việc, việc ủy quyền, thu thập bằng chứng và xác minh.

Kết luận

Fable cung cấp một cách tập trung để bổ sung khả năng lập kế hoạch có giới hạn và định tuyến mô hình cho Codex. Hãy cấu hình các tác nhân OpenCode Go, xem trước và sao chép kỹ năng, gọi kỹ năng bằng một mục tiêu rõ ràng, rồi sử dụng các bài kiểm tra đi kèm để xác thực thiết lập. Không đưa thông tin xác thực vào các gói lập kế hoạch và khởi động lại Codex bất cứ khi nào các định nghĩa định tuyến thay đổi.