Workspace

Automates project inspection and iteration by analyzing from user, product, project, and tech perspectives to continuously improve code quality and delivery.

Auto-Evolve v4.4 (build 57fe0d7)

Four-perspective automated inspection and iteration manager.

Make your projects continuously better — automatically.

---

Core Philosophy

auto-evolve is not just a code scanner — it's a巡检伙伴 that thinks like a human.

On each scan, auto-evolve simulates receiving a Feishu message:

"What else can this project improve? Any shortcomings?"

It then examines the project from four perspectives, forming real opinions — not mechanically listing issues.

---

Scan Workflow (v4.0)

auto-evolve scan
    │
    ▼
┌─────────────────────────────────────────────────────┐
│  Step 1: project-standard project type detection      │
│  Detects: Skill / CLI / Python Library / Web / ...  │
│  Determines perspective weights + inspection focus     │
└─────────────────────┬───────────────────────────────┘
                      ▼
┌─────────────────────────────────────────────────────┐
│  Step 2: Four-perspective inspection               │
│                                                      │
│  👤 USER    → user/user-perspective.md (criteria) │
│  📦 PRODUCT → product-requirements.md (criteria)  │
│  🏗 PROJECT → project-inspection.md (criteria)     │
│  ⚙️ TECH   → code-standards.md (criteria)       │
└─────────────────────┬───────────────────────────────┘
                      ▼
┌─────────────────────────────────────────────────────┐
│  Step 3: project-standard reference docs            │
│  Used as evaluation criteria, output grouped report  │
└─────────────────────────────────────────────────────┘
                      ▼
┌─────────────────────────────────────────────────────┐
│  Step 4: Execute / Notify / Record to learnings    │
└─────────────────────────────────────────────────────┘

Relationship with project-standard

Component	Role
project-standard	Defines taxonomy + four-perspective framework + reference docs (judging criteria)
auto-evolve	Loads standards, runs inspection, records learnings, executes improvements

---

Four-Perspective Framework

┌─────────────────────────────────────────────────────┐
│              auto-evolve Inspection Framework v4.0    │
├──────────────┬──────────────────┬───────────────────┤
│   User      │     Product      │     Project       │    Tech        │
│  "Usable?"  │ "Delivered?"    │   "Healthy?"     │  "Clean?"      │
├──────────────┼──────────────────┼───────────────────┼──────────────────┤
│ CLI design  │ Feature complete │ Learnings closed  │ Code quality   │
│ Learning    │ Promise kept     │ Scan history     │ Architecture  │
│ Errors      │ Pain resolved   │ Config rational  │ Test coverage  │
│ Fault tol.  │ Docs match code │ Dependency health│ Performance   │
└──────────────┴──────────────────┴───────────────────┴──────────────────┘

---

Four Perspectives Detail

👤 User Perspective

Core question: Is it pleasant to use?

Ask	Finds
CLI design	Non-intuitive flags, missing defaults
Learning curve	How long for a newcomer?
Error messages	Machine-speak vs human-speak
Fault tolerance	What on partial failure?
Workflow	Steps per operation?

📦 Product Perspective

Core question: Does it deliver what it promises?

Ask	Finds
README promises	Features claimed but not built
Pain points	❌-marked issues still broken
Feature completeness	Half-baked features
Docs consistency	Docs ≠ code

🏗 Project Perspective

Core question: Is it managed well?

Ask	Finds
Learnings loop	Previous findings tracked?
Scan rhythm	Regular schedule?
Config rationality	Over/under-configured?
Dependency health	Outdated deps? Known CVEs?

⚙️ Tech Perspective

Core question: Is the code healthy?

Ask	Finds
Code quality	Duplicates, long functions
Architecture	Module coupling
Test coverage	Core logic tested?
Performance/security	Bottlenecks, vulnerabilities

Note: Tech is the lowest priority — it's important but should not overshadow product truth.

---

Scan Output Format

🔍 auto-evolve Inspection Report — soul-force
Generated: 2026-04-05 22:30

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👤 User Perspective ★★★★★
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  1. 🚨 Impact 0.7
     review command lacks --dry-run, users think it's safe but it writes files
     → Suggestion: Add --dry-run support to review

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 Product Perspective ★★★★
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  1. 🚨 Impact 0.8
     README promises "LLM fallback" but code has no fallback
     API failure = tool failure
     → Suggestion: Implement keyword-based rule engine as fallback

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Tech Perspective ★★
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  [opt] 🟡 duplicate_code: SoulForgeConfig init repeated 15 times

---

Commands

scan

# Scan all configured repos
python3 auto-evolve.py scan

# Single repo scan
python3 auto-evolve.py scan --repo /path/to/repo

# Preview mode (no execution)
python3 auto-evolve.py scan --dry-run

# With specific persona memory
python3 auto-evolve.py scan --recall-persona master

confirm / reject / approve

python3 auto-evolve.py confirm
python3 auto-evolve.py reject 2 --reason "too risky"
python3 auto-evolve.py approve 1,3

repo-add / repo-list

python3 auto-evolve.py repo-add ~/.openclaw/workspace/skills/hawk-bridge --type skill
python3 auto-evolve.py repo-list

schedule

python3 auto-evolve.py schedule --every 168
python3 auto-evolve.py schedule --suggest

learnings

python3 auto-evolve.py learnings
python3 auto-evolve.py learnings --type rejections
python3 auto-evolve.py learnings --summary   # v4.3: summary view

trends (v4.3)

python3 auto-evolve.py trends --repo soul-force  # Scan trend for a project
python3 auto-evolve.py trends --all              # All projects

---

Configuration

~/.auto-evolverc.json

{
  "mode": "semi-auto",
  "full_auto_rules": {
    "execute_low_risk": true,
    "execute_medium_risk": false,
    "execute_high_risk": false
  },
  "schedule_interval_hours": 168,
  "repositories": [
    {
      "path": "/path/to/repo",
      "type": "skill",
      "visibility": "public",
      "auto_monitor": true
    }
  ]
}

---

LLM Integration

auto-evolve uses OpenClaw-configured LLM (no separate API key needed).

Priority: OPENAI_API_KEY / MINIMAX_API_KEY env vars, or openclaw config get llm.

---

Iteration Storage

.auto-evolve/
  .iterations/
    {id}/
      manifest.json        -- metadata + findings
      plan.md             -- execution plan
      pending-review.json -- items pending review
      report.md           -- execution report
      metrics.json        -- iteration metrics
  .learnings/
    approvals.json       -- approved changes
    rejections.json      -- rejected changes + reasons