orchestra
Orchestra thêm skills, hội đồng agent và công cụ quản lý mission vào OpenCode và Antigravity. Mission lưu tiến độ trong .orchestra/state.json, kèm bằng chứng cho từng task để có thể tiếp tục ở session sau.
Cài
OpenCode:
opencode plugin add @graviton711/orchestra
Antigravity (agy):
agy plugin install /path/to/orchestra
Mở session mới sau khi cài. Cập nhật bằng opencode plugin update, không dùng nút "check for updates" trên OpenCode 2.1.4: nút đó thêm một entry có version và gây Duplicate plugin ID: orchestra. Cài từ checkout, cài cho agy, copy agent thủ công và xử lý lỗi trùng ID: docs/install.md và docs/agy.md.
Dùng nhanh
60 giây, trong một session mới:
/plan viết docs cho CLI này→ task có acceptance và evidence./docs-review README.md→ chạy cổng kiểm tra, chấm 6 tiêu chí, sửa 3 điểm thấp nhất./hoi-dong có nên tách package này thành hai?→ 3 agent phản biện, chốt một phương án./nhiem-vu chuyển toàn bộ test sang node:test→ mission ghi state ra.orchestra/state.json;/tiepđể làm tiếp./market-pulse NVDA=Nvidia,TSLA=Tesla→ pulse 3 nguồn free kèm baseline 7 ngày, để thấy mã nào đang nóng hơn tuần trước./score-loop đẩy accuracy lên→ sổ ghi điểm append-only, tách dev/holdout, cổng chặn báo cáo khi chưa có holdout.
Có gì
- Working contract —
AGENTS.mdchứa luật docs-first, lập kế hoạch và kiểm chứng. Docs ưu tiên bảng/sơ đồ; đoạn văn 3–5 câu, quá 7 câu là lỗi. Khi đã được giao việc, agent tiếp tục đến khi xong hoặc gặp blocker thật; câu hỏi chen giữa không tự hủy task. Câu hỏi thuần thông tin được trả lời mà không tự mở thêm việc. Plugin seed vào project chưa có file, giữ nguyên file có sẵn. ADHD chỉ bật khi được yêu cầu; xem docs/communication.md. - Response guard — nhắc kiểm lại nguồn cũ, lời khẳng định đã kiểm chứng khi session chưa có tool call, và nhãn skill không có bằng chứng nạp. Guard không bắt viết lại vì từ mở đầu, số bullet, câu hỏi cuối hay thiếu chữ “Chốt”. Mỗi câu trả lời sai được nhắc sửa tối đa một lượt, tối đa hai lượt mỗi session.
- Sổ bài học đọc lại —
.orchestra/lessons.mdđược chèn vào context mỗi request: 5 nhóm lỗi mới nhất, bỏ nhóm cóharmful>helpful. Một lớp lỗi đã ghi thì không phải phát hiện lại ở session sau; không có file thì không tốn token. - Ma trận bằng chứng — bảng ứng viên × điều kiện cho một quyết định;
node scripts/check-matrix.mjsfail khi còn ô "chưa kiểm" hoặc ô không nêu artifact đo nó. Protocol điều kiện chốt: ma trận không ô trống, ≥2 ứng viên. - Market pulse —
node scripts/market-pulse.mjsđọc ba nguồn free không cần key (Reddit RSS, Hacker News, Polymarket), in volume kèm cửa sổ thời gian và baseline 7 ngày; nguồn nào dưới 10 bài/tuần thì inthinthay vì bịa xu hướng. - Score loop —
node scripts/score-loop.mjsgiữ sổ điểm append-only, tính best/baseline theo từng split, và chặn tuyên bố khi holdout cũ hơn lần cải thiện dev cuối (exit 1) hoặc khi đã plateau (exit 2). - Skills nạp khi cần —
docs-first,code-comments,docs-taste,design-taste,research,market-pulse,score-loop,ponytail,debug,planvà 18 skill khác; không rõ chọn cái nào thì nạpskill-map, bảng định tuyến đầy đủ. Không tốn token khi không dùng. - Hội đồng 3 agent —
chairvàcriticphản biện độc lập, tối đa 2 vòng, chốt một phương án. - Mission dài hạn — state trên đĩa, evidence gate, checkpoint/rewind; chạy headless bằng
orchestra-mission. - Hỗ trợ song song Antigravity (agy) — native plugin cho
agyvới 29 skills, 2 council agents, rulesrules/AGENTS.mdvà server MCPscripts/orchestra-mcp.mjscho công cụ mission/state; xem docs/agy.md.
Lệnh
| Lệnh | Việc |
|---|---|
/nhiem-vu <mục tiêu> | bắt đầu mission và gợi ý cách chạy |
/tiep | tiếp tục mission từ state |
/dung <lý do> | dừng mission, ghi checkpoint |
/bao-cao | báo cáo task, evidence, acceptance |
/hoi-dong <câu hỏi> | gọi hội đồng 3 agent |
/plan <mục tiêu> | chia task có acceptance |
/debug <lỗi> | debug có hệ thống |
/research <câu hỏi> | nghiên cứu web có trích dẫn |
/market-pulse [mã] | pulse thị trường từ nguồn free, có baseline |
/score-loop <mục tiêu> | vòng tối ưu score: sổ điểm, dev/holdout, cổng plateau |
/docs-review [file] | gate, chấm điểm và sửa README/docs |
/design-review [url] | render, screenshot, chấm 6 tiêu chí, sửa top 3 |
/i-have-adhd | style output action-first cho session |
/ponytail* | 6 lệnh code và review của ponytail |
Giới hạn
- V2 plugin API không có
AgentEditor.add(): agent cài bằng Markdown + postinstall. Copy lỗi thì hội đồng fallback sangexplorevà mất quyền read-only. rewindkhôi phục state, không khôi phục file. Muốn khôi phục môi trường, dùng git worktree/branch và reset theo SHA trong checkpoint.- Evidence gate chỉ kiểm tra evidence có nội dung, không kiểm tra nội dung đúng. Vẫn cần test thật.
- Không cài package global và giữ
.opencode/plugins/index.jscùng lúc: OpenCode báoDuplicate plugin ID: orchestra. - Trên Antigravity (
agy), các lệnh trong.opencode/command/không tự động đăng ký thành slash command; kích hoạt quy trình bằng cách nạp skill hoặc prompt. - Cập nhật package không sửa
AGENTS.mdđã seed. Project đang dùng luật cũ cần merge hai phần “Cách nói và viết” và “Làm đến khi xong” từ template; xem hướng dẫn chuyển đổi. - Chi tiết và các giới hạn còn lại: docs/limits.md.
Phát triển
npm test # unit test, không gọi model
npm run docs:check
npm run notice # cập nhật hash skill vendored
Không có runtime dependency. Quy ước cho agent: AGENTS.md.
License
MIT cho phần orchestra. Skills vendored giữ license riêng; xem NOTICE.md và LICENSE trong từng thư mục skill.