copilot-flow

# Copilot Flow Integration

When to use this skill:
- When you need a structured AI-assisted development workflow
- When you want to leverage both Claude and Copilot's strengths
- When you require end-to-end task management from analysis to delivery

**Triggering conditions:**
- When user mentions "請 Copilot 協助" (Please ask Copilot to assist)
- When user says "詢問 Copilot" (Ask Copilot)
- When user requests "執行 copilot-flow" (Execute copilot-flow)
- When user starts with "copilot-flow:" or "c-flow:" prefix

## Core Features

This skill orchestrates a complete 5-stage AI collaboration workflow:
1. **Analyze** (Claude) - Requirements analysis and structuring
2. **Design** (Copilot) - Architecture design and planning
3. **Implement** (Claude) - Code implementation based on design
4. **Review** (Copilot) - Code quality assessment
5. **Deliver** (Claude) - Final integration and documentation

## Workflow Commands

The workflow is managed through specialized slash commands in the `/commands` directory:

### /copilot-flow:analyze [task description]
- Executes the analysis phase
- Claude analyzes requirements and prepares structured prompts
- Output: `analysis-result.md`

### /copilot-flow:design [goals]
- Executes the design phase using Copilot MCP
- Creates architecture design based on analysis
- Output: `architecture-design.md`

### /copilot-flow:implement [target]
- Executes implementation phase
- Claude implements code following Copilot's design
- Output: Source code files and `implementation-report.md`

### /copilot-flow:review [scope]
- Executes review phase using Copilot MCP
- Professional code review with focus areas
- Output: `code-review-report.md`

### /copilot-flow:deliver [objectives]
- Executes final delivery phase
- Claude integrates all results and documentation
- Output: Complete delivery package

## Usage Patterns

### Full Workflow Execution
For complete task execution, use the workflow orchestrator:

```
執行 copilot-flow 實現用戶認證系統
```

This will:
1. Show preview of all stages
2. Wait for confirmation
3. Execute each stage in sequence
4. Manage state between stages
5. Provide final delivery package

### Individual Stage Execution
Execute specific stages independently:

```
/copilot-flow:analyze 分析現有代碼庫並提出改進建議
/copilot-flow:review 審查 auth.js 檔案的安全性
/copilot-flow:implement 根據設計文檔實現 API 端點
```

## State Management

The workflow maintains state through:
- `.claude/workflow-state.json` - Current stage and progress
- Stage output files - Results from each phase
- claude-mem integration - Complete interaction history

## AI Model Collaboration

### Claude Responsibilities
- Requirements analysis and structuring
- Code implementation and modifications
- Final integration and delivery
- File system operations

### Copilot Responsibilities (via MCP)
- Architecture design recommendations
- Code quality review and feedback
- Security and performance assessment
- Best practices guidance

## Example Workflow

### User Request
```
執行 copilot-flow 實現一個 REST API 進行用戶認證，支持 JWT token
```

### Workflow Execution
1. **Preview Mode** - Shows planned stages and estimated time
2. **Analysis** - Claude breaks down requirements
3. **Design** - Copilot suggests architecture
4. **Implementation** - Claude writes code
5. **Review** - Copilot reviews implementation
6. **Delivery** - Claude prepares final package

### Outputs
- `analysis-result.md` - Structured requirements
- `architecture-design.md` - System design
- Source code files - Implementation
- `code-review-report.md` - Quality assessment
- `delivery/` - Complete package with docs

## Best Practices

### Do
- Start with clear requirements
- Let the workflow handle stage transitions
- Review each stage output before proceeding
- Use full workflow for complex tasks
- Execute individual stages for specific needs

### Don't
- Skip stages in full workflow mode
- Modify intermediate files manually
- Run stages out of sequence
- Ignore review recommendations

## Error Recovery

If workflow is interrupted:
1. Check `.claude/workflow-state.json` for current state
2. Resume from last completed stage
3. Or restart from specific stage
4. All progress is preserved

## Integration with Other Skills

- **copilot-mcp-server**: Used internally by design and review stages
- **claude-mem**: Records all workflow interactions
- File system tools: Used by Claude for implementation

## Keywords
AI collaboration, workflow, automation, Claude, Copilot, structured development, end-to-end, project management, code review, architecture design