Skip to content

Tích hợp Spec Kit ​

Version: 1.0
Date: 2026-11-12
Status: Working baseline

Tách trách nhiệm ​

Năng lựcSpec KitSuperpowersMINAP
Skill / template SDD (làm gì)Cung cấp skill & layout Markdown tới tasks—Chọn lúc chạy; gán đúng Agent
Kỷ luật implement (làm thế nào)Fallback /speckit-implement tùy chọnEngine ưu tiên sau Gate 1C: TDD, subagent, review, đóng branchOrchestrator handoff tasks.md đã duyệt; Developer thực thi
Feature đang active.specify/feature.json (local)Không được tạo SoT feature song songOrchestrator xác minh path trước mọi skill Spec Kit
Cài Cursorcursor-agent → .cursor/skills/speckit-*/Cài theo doc chính thức Superpowers Cursor/plugin; pin versionGiữ .cursor/agents/ & rules tách; review hooks
Phê duyệt / work itemKhông phải hệ governance đầy đủKhông phải hệ phê duyệt.minap/work-items/, bảo vệ PR/CI
Hợp đồng xuyên repoKhông phải dependency manager portfolio—Work item hub cha + work item repo con
Bug / issueExtension bug (assess → fix → test); .specify/bugs/<slug>/systematic-debugging, TDD, verification-before-completionOrchestrator + work item; prompt bug-startup-prompt.md; không full feature SDD

Xem D-019 và 04-sdd-workflow.md cho luồng hybrid (feature và bug).

Spec Kit bug extension (cài trên kit) ​

bash
cd platform-ai
specify extension add bug   # pin trong .minap/config/framework.yaml → speckit_extensions.bug

Skills Cursor: .cursor/skills/speckit-bug-{assess,fix,test}/. Artifact bug ghi vào repo đích (code bị lỗi), không vào platform-ai trừ khi bug thuộc chính kit.

Chuỗi artifact ​

governance/ (chính sách chuẩn) → .specify/memory/constitution.md (active) → specs/<feature>/{spec,plan,tasks}.md → (Gate 1C) → code/tests qua Superpowers → Spec Kit Converge → evidence QA → hồ sơ phê duyệt .minap/work-items/<id>/.

Cách ly feature ​

Mỗi repo có Spec Kit state riêng. Không giả định git checkout đổi feature active. Một workflow feature active mỗi working tree; dùng worktree riêng khi song song. Worktree Superpowers phải nhắm cùng hash tasks.md đã duyệt của feature đó.

Cài Cursor (cursor-agent chính thức) ​

  1. Backup/inventory .cursor/, .specify/, specs/.
  2. Cài CLI (uv tool install specify-cli hoặc pipx); pin version trong .minap/config/framework.yaml.
  3. Dự án sẵn có: theo Existing Projects guide / specify integration install cursor-agent. Không --force mù quáng khi chưa review.
  4. Review skill/hook sinh ra; chỉ commit file đã review.
  5. Gọi skill trong chat Cursor (ví dụ /speckit-specify), không gọi như lệnh shell.
  6. Cài và pin Superpowers riêng cho giai đoạn implement (xem SOURCES.md); không ghi đè skill Spec Kit.

Orchestrator chọn skill Spec Kit và ủy quyền viết cho Agent sở hữu. Sau Gate 1C, Orchestrator chỉ Developer thực thi bằng Superpowers theo tasks.md. Một writer mỗi artifact. Hook không được tự duyệt Gate MINAP hay đụng production.

Link chính thức: SOURCES.md.

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English