auto-dev-setup

Auto-Dev Setup Skill

Set up a Human-in-the-Loop automated development process for any project.

When to Use

When the user says:

• "Help me set up auto-dev"
• "I want to use automated development in this project"
• "Set up a GitHub Actions automated development process"

Setup Process

Step 1: Confirm Requirements

Use AskUserQuestion to confirm:

1. Workflow 來源
   □ 使用 Reusable Workflow（推薦，自動更新）
   □ 複製完整 Workflow（可自訂）

2. Skills 來源
   □ 使用 claude-software-skills
   □ 使用自己的 skills repo
   □ 不使用額外 skills

3. 額外設定
   □ 需要任務佇列（定時處理）
   □ 需要 Feedback 處理（PR 上繼續迭代）

Step 2: Create Directory Structure

mkdir -p .github/workflows
mkdir -p .claude/memory/{learnings,failures,decisions,patterns,strategies}
mkdir -p .github/ISSUE_TEMPLATE

Step 3: Create Workflow (choose one)

Option A: Reusable Workflow (recommended)

# .github/workflows/auto-dev.yml
name: 🤖 Auto-Dev

on:
  issues:
    types: [labeled]
  issue_comment:
    types: [created]
  workflow_dispatch:
    inputs:
      goal:
        description: '開發目標'
        required: true

jobs:
  auto-dev:
    uses: {SKILLS_REPO}/.github/workflows/auto-dev-reusable.yml@main
    with:
      goal: ${{ github.event.inputs.goal || '' }}
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Replace {SKILLS_REPO} with the actual repo path.

Option B: Full Workflow

Copy from claude-software-skills:

• .github/workflows/auto-dev.yml
• .github/workflows/auto-dev-feedback.yml
• .github/workflows/auto-dev-queue.yml

Step 4: Create Issue Template

# .github/ISSUE_TEMPLATE/auto-dev.yml
name: 🤖 Auto-Dev Task
description: 建立一個自動開發任務
labels: ["auto-dev"]
body:
  - type: textarea
    id: goal
    attributes:
      label: 目標
      description: 描述開發目標
    validations:
      required: true

Step 5: Initialize Memory

# .claude/memory/index.md
# 專案記憶索引

## 最近學習
<!-- LEARNINGS_START -->
<!-- LEARNINGS_END -->

## 失敗經驗
<!-- FAILURES_START -->
<!-- FAILURES_END -->

Step 6: Remind to Set Secret

Inform the user:

請到 Repository Settings → Secrets → Actions
新增 ANTHROPIC_API_KEY

Usage Quick Reference

Action	Method
Trigger automated development	Issue + auto-dev label
Command trigger	Comment /evolve [目標]
Continue iterating	Comment on PR /evolve [調整]
Manual trigger	Actions → Run workflow

Verify Setup

After setup is complete, it is recommended to:

1. Create a test Issue
2. Add auto-dev label
3. Confirm the Action triggers correctly
4. Confirm the PR is created correctly

Related Documentation

• AUTO-DEV.md
• Evolve Skill