比较规格驱动开发（SDD）环境：SpecKit vs Kiro

# 安装 Specify CLI
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# 初始化新项目
specify init my-project --ai copilot

# 或在现有项目中
specify init . --ai copilot

/speckit.constitution Create principles focused on code quality, 
testing standards, user experience consistency, and performance requirements

/speckit.specify Build an application that can help me organize my photos 
in separate photo albums. Albums are grouped by date and can be re-organized 
by dragging and dropping on the main page.

/speckit.plan The application uses Vite with minimal number of libraries. 
Use vanilla HTML, CSS, and JavaScript as much as possible.

/speckit.tasks

/speckit.implement

---
description: Create or update project governing principles
---

# Project Constitution

Create a comprehensive constitution document that includes:

1. **Code Quality Standards**
   - Naming conventions
   - Documentation requirements
   - Code review processes

2. **Testing Standards**
   - Unit test coverage requirements
   - Integration test strategies
   - Test documentation

3. **Architecture Principles**
   - Design patterns to follow
   - Technology stack constraints
   - Performance requirements

4. **User Experience Guidelines**
   - Accessibility standards
   - Responsive design requirements
   - Internationalization considerations

---
description: Define requirements and user stories
---

# Specification Template

## User Stories

**As a** [user type]
**I want** [goal]
**So that** [benefit]

### Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2

## Functional Requirements

### FR-001: [Requirement Name]
**Priority**: High/Medium/Low
**Description**: Detailed requirement description
**Dependencies**: [Other requirements]

---
description: Create technical implementation plans
---

# Implementation Plan

## Technology Stack
- Frontend: [Framework/Library]
- Backend: [Framework]
- Database: [Type]
- Deployment: [Platform]

## Architecture Overview
[系统架构图、组件图]

## Data Model
[实体关系图、表定义]

## API Specifications
[端点定义、请求/响应格式]

## Implementation Phases
1. Phase 1: [Core features]
2. Phase 2: [Advanced features]

## Technical Considerations
- Security requirements
- Performance optimization
- Scalability concerns

---
description: Generate actionable task lists
---

# Task Breakdown

## User Story: [Story ID]

### Task 1: [Task Name]
**File**: `src/components/Feature.tsx`
**Type**: Implementation
**Dependencies**: None
**Parallel**: [P] (if parallelizable)
**Description**: Detailed task description
**Acceptance**: How to verify completion

### Task 2: [Task Name]
**File**: `tests/Feature.test.tsx`
**Type**: Testing
**Dependencies**: Task 1

---
description: Execute implementation plan
---

# Implementation Execution

1. **Validate Prerequisites**
   - Constitution exists
   - Spec is complete
   - Plan is approved
   - Tasks are defined

2. **Parse Tasks**
   - Read tasks.md
   - Build dependency graph
   - Identify parallel tasks

3. **Execute Tasks**
   For each task in order:
   - Create/modify specified files
   - Run tests (if TDD)
   - Validate against acceptance criteria
   - Update task status

4. **Progress Reporting**
   - Mark tasks as In Progress/Done
   - Report errors with context
   - Suggest next steps

---
description: Clarify underspecified areas
---

# Clarification Questions

## Coverage Analysis
[识别规格中未覆盖的领域]

## Sequential Questions
1. **Question**: [具体问题]
   **Context**: [为什么这很重要]
   **Options**: [可能的答案]

[记录后将答案添加到 Clarifications 部分]

my-project/
├── .specify/
│   ├── memory/
│   │   └── constitution.md          # 项目原则
│   ├── specs/
│   │   └── 001-photo-albums/
│   │       ├── spec.md               # 功能规格
│   │       ├── plan.md               # 实施计划
│   │       ├── tasks.md              # 任务列表
│   │       ├── data-model.md         # 数据模型
│   │       ├── contracts/
│   │       │   └── api-spec.json    # API 规格
│   │       └── research.md           # 技术研究
│   ├── scripts/
│   │   ├── create-new-feature.sh
│   │   └── setup-plan.sh
│   └── templates/
│       ├── spec-template.md
│       ├── plan-template.md
│       └── tasks-template.md
├── .github/
│   └── prompts/
│       ├── speckit.constitution.prompt.md
│       ├── speckit.specify.prompt.md
│       ├── speckit.plan.prompt.md
│       ├── speckit.tasks.prompt.md
│       ├── speckit.implement.prompt.md
│       ├── speckit.clarify.prompt.md
│       └── speckit.analyze.prompt.md
└── src/
    └── [实施文件]

WHEN [condition/event]
THE SYSTEM SHALL [expected behavior]

{
  "hooks": [
    {
      "trigger": "onFileSave",
      "pattern": "**/*.tsx",
      "action": "generateTests"
    }
  ]
}

my-project/
├── .kiro/
│   ├── steering/
│   │   ├── tech-stack.md
│   │   ├── coding-standards.md
│   │   └── workflows.md
│   └── specs/
│       └── photo-albums/
│           ├── requirements.md    # EARS 格式需求
│           ├── design.md          # 架构设计
│           └── tasks.md           # 实施任务
└── src/
    └── [实施文件]

# spec.md

## User Stories
As a user, I want to...

## Functional Requirements
FR-001: Feature description

## Review Checklist
- [ ] Requirements are clear
- [ ] Acceptance criteria defined

# requirements.md (EARS format)

WHEN user clicks upload button
THE SYSTEM SHALL display file selection dialog

WHEN file size exceeds 10MB
THE SYSTEM SHALL display error message

# plan.md

## Architecture
- Frontend: React
- Backend: Node.js

## Implementation Details
[详细实施指南]

# data-model.md
[数据库架构]

# contracts/api-spec.json
{OpenAPI specification}

# design.md

## Component Architecture
[系统架构图]

## Sequence Diagrams
[流程图]

## Technical Considerations
[性能、安全等]

# tasks.md

## User Story: US-001

### Task 1: Setup database schema
File: src/db/schema.sql
Dependencies: None
[P] Parallel: Yes

### Task 2: Create API endpoint
File: src/api/upload.ts
Dependencies: Task 1

# tasks.md

## Phase 1: Core Implementation

- [ ] Task 1: Database setup
  Status: Not Started
  Assignee: [Auto]
  
- [ ] Task 2: API development
  Status: Not Started
  Dependencies: Task 1

---
description: Custom quality checklist generator
---

# /speckit.custom-checklist

为以下内容生成质量检查清单：

1. **安全审查**
   - 认证检查
   - 授权验证
   - 输入验证

2. **性能审查**
   - 数据库查询优化
   - 缓存策略
   - 负载测试结果

[输出格式：spec 目录中的 Markdown 检查清单]

# 功能 1
specify init . --ai copilot
/speckit.specify Build user authentication system

# 功能 2（在新分支上）
git checkout -b feature/002-payment
/speckit.specify Integrate payment gateway

graph TD
    A[产品经理] -->|定义需求| B["speckit.specify"]
    B --> C["生成 spec.md"]
    C --> D[技术负责人]
    D -->|技术选择| E["speckit.plan"]
    E --> F["生成 plan.md, data-model.md"]
    F --> G[开发者]
    G -->|审查任务| H["speckit.tasks"]
    H --> I["生成 tasks.md"]
    I --> J["speckit.implement"]
    J --> K["生成代码"]
    K --> L[Pull Request]
    L --> M[代码审查]
    M -->|批准| N[Merge]

graph TD
    A[想法] --> B[Spec 聊天]
    B --> C[生成需求]
    C --> D[生成设计]
    D --> E[生成任务]
    E --> F[参考 #spec 编写代码]
    F --> G[保存文件]
    G --> H[触发 Hooks]
    H --> I[自动生成测试]
    I --> J[在后台运行]