# 🎯 Spec Kit 重新开始 - 完整开发工作流

## 📋 项目重置状态

**✅ 已完成:**
- main分支清理完毕 (87个TypeScript文件)
- 中文宪章v1.2.0生效，库优先架构原则
- 一致性检查工具完备
- 现有feature已备份至 `backup/features/20250928/`
- 清理现有feature分支，准备全新开始

---

## 🎯 新Feature开发工作流 (基于中文宪章)

### Phase 1: 项目架构规划 📐

#### 1.1 核心库识别和规划
**遵循宪章原则一: 库优先架构**

```bash
# 第一步: 识别核心业务库
libs/
├── core-trading/          # 核心交易逻辑库
├── multi-exchange/        # 多交易所适配器库
├── credential-manager/    # 凭证管理库
├── risk-control/          # 风险控制库
├── market-data/           # 市场数据库
└── http-client/           # HTTP客户端库
```

#### 1.2 项目级别依赖架构

```
应用层 (src/)
    ↓
业务库层 (libs/)
    ↓
基础设施层 (packages/)
    ↓
外部依赖 (node_modules/)
```

### Phase 2: Feature开发标准流程 🔄

#### 2.1 Feature启动 (`/specify`)

```bash
# 创建新feature规格
/specify "实现可扩展的多平台HTTP客户端，支持Pacifica和未来交易所集成"
```

#### 2.2 规划确认 (`/plan`)

```bash
# 生成实施计划
/plan
```

#### 2.3 任务生成 (`/tasks`)

```bash
# 生成开发任务列表
/tasks
```

#### 2.4 质量分析 (`/analyze`)

```bash
# 检查一致性和质量
/analyze
```

#### 2.5 实施执行 (`/implement`)

```bash
# 开始实施
/implement
```

### Phase 3: 库优先开发模式 📚

#### 3.1 每个Feature必须首先创建独立库

```typescript
// 示例: HTTP Client库结构
libs/http-client/
├── src/
│   ├── core/
│   │   ├── HttpClient.ts       # 核心HTTP客户端
│   │   ├── ProxyManager.ts     # 代理管理
│   │   └── CredentialMatcher.ts # 凭证匹配
│   ├── adapters/
│   │   ├── PacificaAdapter.ts  # Pacifica适配器
│   │   └── BaseExchangeAdapter.ts # 基础适配器
│   └── index.ts
├── tests/
│   ├── unit/                   # 单元测试(真实环境)
│   ├── integration/            # 集成测试
│   └── contracts/              # 契约测试
├── package.json
└── README.md
```

#### 3.2 应用层集成

```typescript
// src/ 中只进行库的集成和配置
import { HttpClient } from '@libs/http-client'
import { CredentialManager } from '@libs/credential-manager'

// 配置和使用，不包含业务逻辑
const client = new HttpClient({
  credentialManager: new CredentialManager(config),
  proxy: proxyConfig
})
```

### Phase 4: 质量保证体系 🛡️

#### 4.1 测试策略 (遵循宪章原则一)

```bash
# 优先真实环境测试
tests/
├── unit/              # 真实数据库测试
├── integration/       # 实际服务测试
├── contracts/         # API契约测试
└── e2e/              # 端到端真实场景
```

#### 4.2 Feature依赖检查

```bash
# 开发前检查
.specify/scripts/check-feature-dependencies.sh

# 合并前验证
.specify/scripts/pre-merge-consistency-check.sh <feature-branch>
```

### Phase 5: 实际开发流程示例 🚀

#### 5.1 创建第一个Feature: HTTP客户端库

```bash
# Step 1: 规格定义
/specify "创建可扩展的多平台HTTP客户端库，支持智能凭证匹配和代理切换，首先实现Pacifica集成"

# Step 2: 创建feature分支
git checkout -b 001-http-client-lib

# Step 3: 生成计划和任务
/plan
/tasks

# Step 4: 开始库优先实施
mkdir -p libs/http-client
cd libs/http-client
npm init -y

# Step 5: 遵循TDD，先写契约测试
mkdir -p tests/contracts
# ... 契约测试编写

# Step 6: 实施核心库
# ... 核心逻辑开发

# Step 7: 应用层集成
# ... src/中集成使用

# Step 8: 一致性检查
.specify/scripts/pre-merge-consistency-check.sh 001-http-client-lib

# Step 9: 合并到main
git checkout main && git merge --no-ff 001-http-client-lib
```

---

## 🎯 建议的第一批Feature优先级

### 🥇 Phase A: 核心基础库 (立即开始)

1. **001-http-client-lib** - 多平台HTTP客户端库
   - 智能凭证匹配
   - 代理管理
   - Pacifica适配器

2. **002-credential-manager-lib** - 凭证管理库
   - 多平台凭证存储
   - 加密和轮换
   - 类型匹配

3. **003-market-data-lib** - 市场数据库
   - 多源数据聚合
   - WebSocket/HTTP回退
   - 实时价格管理

### 🥈 Phase B: 交易核心库 (基础库完成后)

4. **004-risk-control-lib** - 风险控制库
5. **005-trading-engine-lib** - 交易引擎库
6. **006-hedging-manager-lib** - 对冲管理库

### 🥉 Phase C: 应用集成 (库完成后)

7. **007-application-integration** - 应用层集成
8. **008-monitoring-dashboard** - 监控仪表板
9. **009-deployment-automation** - 部署自动化

---

## 🛠️ 立即开始步骤

**现在就可以开始第一个Feature:**

```bash
# 1. 创建第一个feature规格
/specify "创建可扩展的多平台HTTP客户端库，支持智能凭证匹配和代理切换，优先实现Pacifica集成"
```

这样就能开始遵循新宪章的库优先开发模式了！