skill-pipeline

# Skill Pipeline

リサーチから実装までを一気通貫で実行するパイプライン。

## Prerequisites

**Required subagents** (`.claude/agents/`):
- `parallel-researcher.md` - Stage 1: Research
- `auto-validator.md` - Stage 4: Validate

**Optional subagents**:
- `skill-reviewer.md` - Optional quality check

**Error if missing**: Pipeline will report which subagent is unavailable and suggest creating it.

## Usage

```
/skill-pipeline [topic] [--type skill|subagent]
```

例:
- `/skill-pipeline "Go error handling best practices" --type skill`
- `/skill-pipeline "TypeScript型安全性" --type subagent`

## Workflow

### Stage 1: Research (parallel-researcher)

```
Task: subagent_type=parallel-researcher
Prompt: "[topic]についてベストプラクティスを調査。Skill/Subagent作成に必要な情報を収集"
```

Output: `.research/[topic]/synthesis.json`

### Stage 2: Design

リサーチ結果から Skill/Subagent の設計を生成:

```yaml
name: [derived from topic]
description: [1-line summary]
type: skill | subagent
triggers: [when to use]
core_functionality:
  - [capability 1]
  - [capability 2]
references_needed:
  - [reference doc 1]
tools_required:
  - [tool 1]
  - [tool 2]
```

### Stage 3: Generate

#### Skill の場合

```
.claude/skills/[name]/
├── SKILL.md           # メインスキル定義
├── references/        # 参考ドキュメント
│   └── best-practices.md
└── scripts/           # 必要に応じてスクリプト
    └── validate.sh
```

#### Subagent の場合

```
.claude/agents/[name].md   # サブエージェント定義
```

### Stage 4: Validate (auto-validator)

```
Task: subagent_type=auto-validator
Prompt: "生成した Skill/Subagent を検証: 構文チェック、必須フィールド確認、ベストプラクティス適合"
```

### Stage 5: Report

最終レポートを出力:

```json
{
  "pipeline_id": "skill-pipeline-[timestamp]",
  "topic": "Original topic",
  "type": "skill|subagent",
  "research_summary": "Key findings from research",
  "generated_files": [
    ".claude/skills/[name]/SKILL.md",
    ".claude/skills/[name]/references/best-practices.md"
  ],
  "validation_result": {
    "status": "pass|fail",
    "issues": []
  },
  "next_steps": [
    "テストしてみる: /[skill-name]",
    "改善点があれば: /skill-pipeline feedback"
  ]
}
```

## Pipeline Stages

```
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  Research   │───▶│   Design    │───▶│  Generate   │───▶│  Validate   │───▶│   Report    │
│  (parallel) │    │             │    │             │    │  (auto)     │    │             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
      │                  │                  │                  │                  │
      ▼                  ▼                  ▼                  ▼                  ▼
 .research/         design.yaml      .claude/skills/    validation.json    report.json
 synthesis.json                      or agents/
```

## Error Handling

| Stage | Failure | Recovery |
|-------|---------|----------|
| Research | WebSearch fails | Retry with alternative queries |
| Design | Ambiguous requirements | Ask user for clarification |
| Generate | Missing template | Use default template |
| Validate | Syntax errors | Auto-fix and retry |

## Options

| Option | Description | Default | Status |
|--------|-------------|---------|--------|
| `--type` | `skill` or `subagent` | Inferred | Implemented |
| `--skip-research` | Use existing research | `false` | Implemented |
| `--no-validate` | Skip validation | `false` | Implemented |
| `--output-dir` | Custom output directory | `.claude/` | Implemented |

## Execution Flow

1. **Parse input** - Extract topic and options
2. **Check existing research** - If `.research/[topic]/synthesis.json` exists and `--skip-research` not set, ask to reuse
3. **Spawn parallel-researcher** - If needed
4. **Wait for research** - Monitor agent completion
5. **Read synthesis** - Extract key findings
6. **Design structure** - Create skill/subagent spec
7. **Generate files** - Write SKILL.md or agent.md
8. **Spawn auto-validator** - Validate generated files
9. **Collect results** - Merge all outputs
10. **Report** - Display summary and next steps

## Example Session

```
User: /skill-pipeline "Claude Code hooks automation"

Pipeline Starting...

[Stage 1/5] Research
  ├─ Spawning parallel-researcher...
  ├─ 4 research agents deployed
  └─ Waiting for completion...

[Stage 2/5] Design
  ├─ Analyzing synthesis.json
  ├─ Type: skill (detected from topic)
  └─ Name: hooks-automation

[Stage 3/5] Generate
  ├─ Creating .claude/skills/hooks-automation/
  ├─ Writing SKILL.md
  └─ Writing references/hooks-patterns.md

[Stage 4/5] Validate
  ├─ Spawning auto-validator...
  ├─ Checking syntax: ✓
  ├─ Checking required fields: ✓
  └─ Checking best practices: ✓

[Stage 5/5] Report
  ✓ Pipeline completed successfully

  Generated:
  - .claude/skills/hooks-automation/SKILL.md
  - .claude/skills/hooks-automation/references/hooks-patterns.md

  Try it: /hooks-automation
```

## Integration with Other Skills

This skill orchestrates:
- `parallel-researcher` (subagent) - For comprehensive research
- `auto-validator` (subagent) - For validation
- `skill-reviewer` (subagent) - Optional quality check

## Best Practices Encoded

From Claude Code official guidelines:
- Skills are single-task focused
- Subagents handle multi-step workflows
- Always include `allowed-tools` or `tools`
- Use `model: haiku` for simple skills
- Include triggers in description