Spec Kit Sharp

一个美观的C#版规范驱动开发工具，对标GitHub spec-kit，使用Spectre.Console构建。

项目状态

🚧 开发中 - Phase 1: Setup 已完成

已完成的工作

✅ Phase 1: Setup (共享基础设施)

• T001: 创建解决方案结构
• T002: 初始化C#解决方案和依赖项
• T003: 配置项目文件 (Directory.Build.props, global.json)
• T004: 创建目录结构 (Models, Services, Storage, Commands, etc.)
• T005: 创建模板目录结构

进行中的工作

🔄 Phase 2: Foundational (阻塞前提条件)

• T006: 创建核心数据模型接口和基类
• T007: 实现文件系统存储抽象
• T008: 创建YAML序列化服务
• T009: 创建JSON序列化服务
• T010: 实现ID生成服务
• T011: 创建验证框架
• T012: 创建CLI入口点和命令路由
• T013: 创建Spectre.Console集成服务
• T014: 创建输出格式化服务
• T015: 设置错误处理和日志基础设施

项目结构

SpecKitSharp/
├── src/
│   ├── SpecKit.Core/           # 核心库
│   │   ├── Models/            # 数据模型
│   │   ├── Services/          # 业务逻辑服务
│   │   ├── Storage/           # 文件系统存储实现
│   │   └── Templates/         # 模板文件和生成器
│   ├── SpecKit.CLI/           # CLI接口
│   │   ├── Commands/          # CLI命令实现
│   │   ├── Services/          # CLI特定服务
│   │   ├── Prompts/           # 用户交互界面
│   │   └── Themes/            # 颜色主题
│   └── SpecKit.Tests/         # 测试项目
│       ├── Unit/              # 单元测试
│       ├── Integration/       # 集成测试
│       └── TestData/          # 测试数据
├── templates/                 # 项目模板文件
│   ├── project-template/
│   ├── spec-template/
│   └── task-template/
├── SpecKitSharp.sln           # 解决方案文件
├── Directory.Build.props       # 全局项目配置
└── global.json               # .NET SDK配置

技术栈

• .NET 8.0 LTS - 运行时框架
• Spectre.Console - 美观的终端界面
• System.CommandLine - CLI命令解析
• YamlDotNet - YAML文件处理
• xUnit - 测试框架
• FluentAssertions - 测试断言

快速开始

构建项目

dotnet build

运行测试

dotnet test

运行CLI（开发中）

dotnet run --project SpecKit.CLI -- --help

功能规划

用户故事

1. 项目初始化 (P1) - 通过CLI命令快速创建新的规范驱动开发项目
2. 规范创建与管理 (P1) - 创建、编辑和管理项目规范
3. 任务分解与规划 (P2) - 将功能规范分解为具体的开发任务
4. 美观的终端界面 (P1) - 美观、彩色、格式化的输出界面

核心命令

• spec-kit init <项目名称> - 初始化新项目
• spec-kit specify "功能描述" - 创建新规范
• spec-kit list - 列出规范或任务
• spec-kit plan <规范ID> - 生成任务计划
• spec-kit tasks - 显示任务状态
• spec-kit status - 项目状态概览

开发进度

• 项目初始化和依赖配置
• 核心数据模型实现
• 文件存储系统
• CLI命令实现
• 美观界面实现
• 测试覆盖

贡献指南

项目遵循规范驱动开发流程：

1. 创建功能规范 (spec-kit specify)
2. 生成任务计划 (spec-kit plan)
3. 实现和测试
4. 代码审查和合并

许可证

MIT License

---

下一步: 开始Phase 2 - Foundational基础设施开发