project-orchestrator

Installation
SKILL.md

Project Orchestrator

Đây là skill điều phối duy nhất mà agent load ĐẦU TIÊN cho mọi yêu cầu liên quan đến app Flutter trong project. Nó không viết code, chỉ quyết định bước tiếp theo và load đúng 1 skill con tương ứng.

Nguyên tắc

  • Một Agent CLI duy nhất, không spawn agent con, không mô phỏng multi-agent.
  • Mỗi bước chỉ load đúng 1 skill con cần thiết, không load tất cả cùng lúc (tránh loãng context).
  • OpenSpec (CLI thật của Fission-AI, không phải 1 file .md đơn) là nguồn sự thật duy nhất:
    • openspec/specs/<domain>/spec.md — hành vi hiện tại của hệ thống (source of truth).
    • openspec/changes/<change-name>/{proposal.md, design.md, tasks.md, specs/<domain>/spec.md} — đề xuất thay đổi đang làm dở (delta spec).
    • openspec/config.yaml — context/tech stack cố định (Flutter, Riverpod, GoRouter, Feature-First) và rules, được tự động inject vào mọi artifact, KHÔNG cần agent tự nhắc lại các rule này mỗi lần.
  • QUAN TRỌNG - phân định trách nhiệm: flutter-skill KHÔNG được tự ý đọc/ghi trực tiếp vào openspec/specs/ hay openspec/changes/ bằng cách tự bịa thao tác file, và KHÔNG tự chạy raw openspec CLI qua bash để thay thế vòng đời spec. Toàn bộ vòng đời change (tạo, sinh artifact, thực thi, validate, merge) PHẢI đi qua slash command /opsx:* đã cấu hình (profile mở rộng: new, continue, ff, propose, explore, apply, verify, sync, archive, bulk-archive, onboard). flutter-skill là kỹ thuật Flutter cụ thể được dùng BÊN TRONG các bước đó (đặc biệt là trong /opsx:apply), không phải lớp thay thế chúng.
  • Không hỏi lại user những thứ có thể suy ra từ config.yaml/specs/ hiện có hoặc dùng mặc định hợp lý (xem phần "Quy tắc mặc định" bên dưới), NHƯNG luôn hỏi user ở bước UI-checkpoint (trong bước 4, mỗi khi task có UI) - đây là điểm dừng có chủ đích, không phải điểm dừng do thiếu thông tin.

Quy trình (checklist tuần tự, map đúng vào vòng đời opsx thật)

Giai đoạn Planning (opsx tự lo, flutter-skill chỉ đọc kết quả)

Installs
11
First Seen
Aug 14, 2026
project-orchestrator — hoangsoft90/ai_skills