# spec

**Repository Path**: mdunion/spec

## Basic Information

- **Project Name**: spec
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 📚 创建的文档

源文件： https://jishuzhan.net/article/2021836849153638401

# Spec-Kit、OpenSpec、Superpowers 深度对比与最佳实践



### 1️⃣ **AI_PROGRAMMING_PARADIGMS.md** 

完整的范式整合指南，包含：
- 三种范式的核心对比（工作原理、适用场景、技术栈）
- 五种任务分类与范式选择策略
- 实战示例（认证功能、用户资料、性能优化）
- 协同架构和最佳实践

### 2️⃣ **spec-paradigm-selector.md**
快速选择器，包含：
- 三步决策流程（复杂度 → 风险 → 团队）
- 快速决策表（任务类型矩阵）
- 实际案例演示（4个不同场景）
- 常见错误避免指南

### 3️⃣ **spec-prompt-templates.md** ⭐
完整的 Prompt 模板库，包含：
- **Superpowers 模板**（TDD、重构、探索、审查、Bug 修复）
- **OpenSpec 模板**（创建规格、知识库开发、并行开发）
- **Spec-Kit 模板**（宪法遵守、规格实现、审查清单）
- **混合范式模板**（完整工作流、团队协作、遗留迁移）
- **通用模板**（项目初始化、技术栈迁移、性能/安全优化）

### 4️⃣ **spec-decision-checklist.md**
决策检查清单，包含：
- 可视化决策流程图
- 多维度评估表（复杂度、风险、团队、合规、长期）
- 快速决策器（评分系统 5-25分）
- 实施检查清单（前/中/后）
- 风险信号识别和迭代优化

### 5️⃣ **README_SPEC_PARADIGMS.md**
总导航文档，包含：
- 文档结构的清晰导航
- 快速开始指南
- 三种范式速览表
- 一句话决策指南
- 学习路径建议
- FAQ 和外部资源

---

## 🎯 核心决策逻辑

```
任务时长
  ├─ < 2 小时 → Superpowers 单独
  ├─ 2-8 小时 → OpenSpec + Superpowers
  └─ > 8 小时 → 进入风险评估
      ├─ 高风险 → Spec-Kit + Superpowers
      ├─ 中风险 → OpenSpec + Superpowers
      └─ 大团队 → 三者协同完整流程
```

## 💡 关键洞察

这篇文章将 AI 编程工具形象地比作建筑施工：
- **Spec-Kit** = 建筑规范手册（立法规矩）
- **OpenSpec** = 施工变更单（变更管理）
- **Superpowers** = 施工队工作手册（执行方法）

三者协同构成了完整的工程化体系：**立法 → 立项 → 施工**

## 🚀 使用建议

对于您的 NocoBase 项目，建议：

1. **阅读 AI_PROGRAMMING_PARADIGMS.md** 了解核心概念
2. **使用 spec-decision-checklist.md 的评分系统** 评估当前任务
3. **在 spec-prompt-templates.md 中找到对应模板** 开始实践
4. **参考 spec-paradigm-selector.md 的实际案例** 学习应用