Appearance
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ực | Spec Kit | Superpowers | MINAP |
|---|---|---|---|
| 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ọn | Engine ưu tiên sau Gate 1C: TDD, subagent, review, đóng branch | Orchestrator handoff tasks.md đã duyệt; Developer thực thi |
| Feature đang active | .specify/feature.json (local) | Không được tạo SoT feature song song | Orchestrator xác minh path trước mọi skill Spec Kit |
| Cài Cursor | cursor-agent → .cursor/skills/speckit-*/ | Cài theo doc chính thức Superpowers Cursor/plugin; pin version | Giữ .cursor/agents/ & rules tách; review hooks |
| Phê duyệt / work item | Khô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 repo | Không phải dependency manager portfolio | — | Work item hub cha + work item repo con |
| Bug / issue | Extension bug (assess → fix → test); .specify/bugs/<slug>/ | systematic-debugging, TDD, verification-before-completion | Orchestrator + 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.bugSkills 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)
- Backup/inventory
.cursor/,.specify/,specs/. - Cài CLI (
uv tool install specify-clihoặcpipx); pin version trong.minap/config/framework.yaml. - Dự án sẵn có: theo Existing Projects guide /
specify integration install cursor-agent. Không--forcemù quáng khi chưa review. - Review skill/hook sinh ra; chỉ commit file đã review.
- Gọi skill trong chat Cursor (ví dụ
/speckit-specify), không gọi như lệnh shell. - 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.