binance-api/SPEC_KIT_WORKFLOW.md

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

📋 项目重置状态

✅ 已完成:

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

---

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

Phase 1: 项目架构规划 📐

1.1 核心库识别和规划

遵循宪章原则一: 库优先架构

# 第一步: 识别核心业务库
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)

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

2.2 规划确认 (/plan)

# 生成实施计划
/plan

2.3 任务生成 (/tasks)

# 生成开发任务列表
/tasks

2.4 质量分析 (/analyze)

# 检查一致性和质量
/analyze

2.5 实施执行 (/implement)

# 开始实施
/implement

Phase 3: 库优先开发模式 📚

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

// 示例: 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 应用层集成

// 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 测试策略 (遵循宪章原则一)

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

4.2 Feature依赖检查

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

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

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

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

# 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: 交易核心库 (基础库完成后)

1. 004-risk-control-lib - 风险控制库
2. 005-trading-engine-lib - 交易引擎库
3. 006-hedging-manager-lib - 对冲管理库

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

1. 007-application-integration - 应用层集成
2. 008-monitoring-dashboard - 监控仪表板
3. 009-deployment-automation - 部署自动化

---

🛠️ 立即开始步骤

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

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

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