https://github.com/timcsy/vibe2
https://github.com/timcsy/vibe2
Last synced: 18 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/timcsy/vibe2
- Owner: timcsy
- Created: 2026-03-06T07:19:34.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-13T08:01:02.000Z (3 months ago)
- Last Synced: 2026-03-13T16:15:45.798Z (3 months ago)
- Language: Python
- Size: 146 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# vibe2
**Vibe2** 是一個規格驅動的軟體工程框架，透過自動化工具鏈將自然語言需求轉換為可執行任務。
## 🎮 VoxelSandbox 遊戲
| 連結 | 說明 |
|------|------|
| 🌐 **[遊戲首頁](https://timcsy.github.io/vibe2/)** | GitHub Pages 遊戲介紹頁（含下載連結） |
| ⬇ **[下載最新版本](https://github.com/timcsy/vibe2/releases/latest)** | Windows / macOS / Linux 可執行檔 |
| 📋 **[所有版本](https://github.com/timcsy/vibe2/releases)** | 版本歷史與變更紀錄 |
### 發布新版本
```bash
# 透過 git tag（自動觸發 release workflow）
git tag v1.0.0
git push origin v1.0.0
```
或至 **Actions → Release → Run workflow** 手動填入版本號觸發。
---
## 工作流
遵循以下線性工作流開發任何功能：
```
自然語言描述 → 規格 → 澄清 → 計畫 → 任務 → 分析 → 實現 → GitHub Issues
```
### 工作流命令（在 VS Code 中）
| 命令 | 輸出 | 目的 |
|------|------|------|
| `/speckit.specify` | `spec.md` | 從自然語言生成正式規格 |
| `/speckit.clarify` | 更新 `spec.md` | 澄清規格不明確的地方 |
| `/speckit.plan` | `plan.md`, 設計文件 | 生成技術實現計畫 |
| `/speckit.tasks` | `tasks.md` | 將計畫轉為有序任務 |
| `/speckit.analyze` | 檢查報告 | 驗證一致性和品質 |
| `/speckit.implement` | 執行任務 | 按順序實現所有任務 |
| `/speckit.checklist` | 檢查清單 | 生成品質驗證清單 |
| `/speckit.taskstoissues` | GitHub Issues | 將任務轉為 GitHub 議題 |
## 憲法
所有開發必須遵守 [Vibe2 規格憲法](./.specify/memory/constitution.md)，該憲法定義了 5 個核心原則：
1. **規格驅動** - 所有功能從清晰的自然語言規格開始
2. **設計優先** - 實現前先完成詳盡的設計文件
3. **自動化工作流** - 使用 speckit 工具鏈自動轉換需求到任務
4. **測試驅動開發 (TDD)** - 測試在實現前完成
5. **簡潔性優先** - 避免過度設計，遵循 YAGNI 原則
## 專案結構
```
vibe2/
├── .specify/
│ ├── templates/ # 規格、計畫、任務等模板
│ ├── memory/
│ │ └── constitution.md # 專案治理憲法
│ └── scripts/ # 自動化腳本
├── .github/
│ ├── agents/ # Agent 定義
│ ├── prompts/ # 對應的 prompt 文件
│ └── skills/ # Agent 技能說明
└── README.md # 此文件
```
## 開始使用
1. **定義功能需求** - 用自然語言描述您的功能
2. **執行工作流** - 在 VS Code 中按順序使用 `/speckit.*` 命令
3. **遵守憲法** - 確保每個階段都符合規格憲法的原則
4. **提交變更** - 在每個工作流階段進行 git commit
## 相關資源
- [Vibe2 規格憲法](./.specify/memory/constitution.md) - 治理原則和開發標準
- [規格模板](./.specify/templates/spec-template.md)
- [計畫模板](./.specify/templates/plan-template.md)
- [任務模板](./.specify/templates/tasks-template.md)