@graviton711/orchestra

中文文档
0.9.8发布于 2026/11/05MITES Module零依赖近 30 天下载 4971

OpenCode bundle: always-on senior-dev protocol, skills, 3-agent council, and verifiable long-horizon missions.

原始使用文档
文档目录7 节
  1. Cài
  2. Dùng nhanh
  3. Có gì
  4. Lệnh
  5. Giới hạn
  6. Phát triển
  7. License

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:

  1. /plan viết docs cho CLI này → task có acceptance và evidence.
  2. /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.
  3. /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.
  4. /nhiem-vu chuyển toàn bộ test sang node:test → mission ghi state ra .orchestra/state.json; /tiep để làm tiếp.
  5. /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.
  6. /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.md chứ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.mjs fail 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ì in thin thay vì bịa xu hướng.
  • Score loop — node scripts/score-loop.mjs giữ 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, plan và 18 skill khác; không rõ chọn cái nào thì nạp skill-map, bảng định tuyến đầy đủ. Không tốn token khi không dùng.
  • Hội đồng 3 agent — chair và critic phả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 agy với 29 skills, 2 council agents, rules rules/AGENTS.md và server MCP scripts/orchestra-mcp.mjs cho công cụ mission/state; xem docs/agy.md.

Lệnh

LệnhViệc
/nhiem-vu <mục tiêu>bắt đầu mission và gợi ý cách chạy
/tieptiếp tục mission từ state
/dung <lý do>dừng mission, ghi checkpoint
/bao-caobá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-adhdstyle 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 sang explore và mất quyền read-only.
  • rewind khô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.js cùng lúc: OpenCode báo Duplicate 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.

版本与发布记录

@graviton711/orchestra 共发布 23 个版本,首次发布于 2026/10/21;过去 12 个月发布了 23 个版本。

版本发布日期距今
0.9.8latest2026/11/0512 天前
0.9.72026/11/0412 天前
0.9.62026/11/0413 天前
0.9.52026/10/2720 天前
0.9.42026/10/2720 天前
0.9.32026/10/2721 天前

关于 @graviton711/orchestra 的常见问题

@graviton711/orchestra 是什么?

OpenCode bundle: always-on senior-dev protocol, skills, 3-agent council, and verifiable long-horizon missions.

如何安装 @graviton711/orchestra?

在项目目录运行 npm install @graviton711/orchestra,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 orchestra-mission,可以用 npx orchestra-mission 直接运行。

@graviton711/orchestra 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/graviton711__orchestra 是否存在。

@graviton711/orchestra 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@graviton711/orchestra 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@graviton711/orchestra 可以商用吗?

@graviton711/orchestra 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@graviton711/orchestra 的下载量有多少?

根据 npm 官方下载统计,@graviton711/orchestra 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,971 次,日均约 166 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@graviton711/orchestra 还在维护吗?

最新版本 0.9.8 发布于 2026/11/05(12 天前);至今共发布 23 个版本,其中过去 12 个月发布了 23 个;首次发布于 2026/10/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。