heldinhow-speckit-swarm

类 oh-my-opencode 的 OpenClaw 原生多智能体编排与 Ultrawork 并行执行。

## 概述（中文）

类 oh-my-opencode 的 OpenClaw 原生多智能体编排与 Ultrawork 并行执行。

## 技能正文

# Speckit Swarm — 智能体编排系统

## Overview

使用 OpenClaw 工具原生实现 oh-my-opencode 风格编排。

## 架构

### 核心组件

1. **Ultrawork 检测器** — 检测 "ulw"/"ultrawork" 关键词并触发并行执行
2. **智能体人格** — 针对不同任务的专用系统提示
3. **任务规划器** — 将复杂任务拆分为并行块
4. **完成强制器** — 确保任务完整完成

## 文件结构

```
skills/speckit-swarm/
├── SKILL.md                      # This file
├── src/
│   ├── ultrawork.ts              # Ultrawork detection & trigger
│   ├── personas/
│   │   ├── mod.ts               # Persona exports
│   │   ├── sisyphus.ts          # Main orchestrator
│   │   ├── hephaestus.ts        # Deep worker
│   │   ├── oracle.ts            # Design/debug
│   │   ├── librarian.ts         # Research/docs
│   │   └── explore.ts            # Fast scout
│   ├── planner.ts               # Task decomposition
│   └── index.ts                 # Main entry
```

## Usage

### 手动模式
```bash
# Use personas directly
sessions_spawn task:"..." model:"minimax-m2.5" thinking:"high"
```

### Ultrawork 模式
当用户包含 "ulw" 或 "ultrawork" 时：
1. 检测关键词
2. 将任务分解为并行块
3. 使用 parallel_spawn 执行
4. 聚合结果

## 人格

### Sisyphus（主编排器）
- Model: minimax-m2.5
- Thinking: high
- 行为：不懈执行、并行协调、待办跟踪

### Hephaestus（深度工作者）
- Model: minimax-m2.5
- Thinking: high
- 行为：自主执行、无需手把手、完成完整范围

### Oracle（设计/调试）
- Model: minimax-m2.5
- Thinking: high
- 行为：架构决策、缺陷狩猎、代码审查

### Librarian（研究）
- Model: minimax-m2.1
- Thinking: medium
- 行为：文档查找、代码探索、模式发现

### Explore（侦察）
- Model: minimax-m2.5-highspeed
- Thinking: low
- 行为：快速 grep、文件查找、快速分析

## 如何使用

### 1. 直接使用人格
```typescript
import { PERSONAS, buildTaskPrompt } from './speckit-swarm';

const persona = PERSONAS.hephaestus;
const task = "Fix the login bug in auth.ts";

sessions_spawn({
  task: buildTaskPrompt({ task, persona: 'hephaestus' }),
  model: persona.config.model,
  thinking: persona.config.thinking
});
```

### 2. Ultrawork 模式（自动检测）
当用户包含 "ulw" 或 "ultrawork" 时：
```typescript
import { planTask, shouldUseUltrawork } from './speckit-swarm';

const task = "ulw refactor the auth module";
if (shouldUseUltrawork(task)) {
  const plan = planTask(task);
  // Execute plan.chunks with parallel_spawn
}
```

### 3. 任务分解
```typescript
import { planTask } from './speckit-swarm';

const plan = planTask("Create a new API endpoint");
// plan.chunks = [{ label: 'spec', ... }, { label: 'setup', ... }, ...]
```

## Ultrawork 处理器

处理器自动检测 "ulw" 并为 parallel_spawn 准备任务。

### 导出函数

```typescript
// Verifica se contém keyword ulw
containsUltrawork(task: string): boolean

// Limpa o prefixo ulw da tarefa
cleanUltraworkTask(task: string): string

// Prepara execução ultrawork
prepareUltrawork(task: string): {
  shouldExecute: boolean;
  chunks: Array<{
    label: string;
    task: string;
    model?: string;
    thinking?: string;
  }>;
  cleanedTask: string;
}
```

### 使用示例

```typescript
// Na minha resposta, quando receber mensagem com "ulw":

const ultrawork = prepareUltrawork("ulw create a new API");

if (ultrawork.shouldExecute) {
  // Executar com parallel_spawn
  parallel_spawn({
    tasks: ultrawork.chunks,
    wait: "all"
  });
}
```

### 如何检测与执行

### 并发安全分析

并行化前检查是否存在冲突：

| 任务类型 | 策略 |
|----------------|------------|
| 创建新项目/CLI/API | **并行** ✓ |
| 多个新文件 | **并行** ✓ |
| 重构模块 | 谨慎（检查依赖） |
| 修复 bug | **串行** ✗ |
| 编辑同一文件 | **串行** ✗ |
| 简单任务 | 单一 |

### 决策流程

1. **分析复杂度** — 是否为大任务？
2. **检查冲突** — 是否会修改同一文件？
3. **决定策略** — parallel / sequential / single

这避免多个智能体尝试修改同一文件时的并发问题。

### 使用示例

```typescript
// Detecção automática
const result = prepareParallelExecution("criar um novo CLI");
// result.shouldExecute = true (detectou complexidade)

if (result.shouldExecute) {
  parallel_spawn({
    tasks: result.chunks,
    wait: "all"
  });
}
```