OpenSkillIndex← back to search
claude-code

Skills ecc-system

Everything Claude Code (ECC) system integration - 30 agents, 77 rules, 12 languages, 4 iron laws, TDD workflow, verification gates

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/18816478335q-pixel/eccsystem" ~/.claude/skills/clawdbot-skills-ecc-system && rm -rf "$T"
manifest: skills/18816478335q-pixel/eccsystem/SKILL.md
source content

ECC System - OpenClaw Skill

Version: 1.0.0
Source: everything-claude-code (obra/ecc)
Integration Date: 2026-04-03

🎯 When to Activate

  • Starting any new project or task
  • Writing or reviewing code
  • Debugging issues
  • Planning complex features
  • Multi-language projects
  • TDD workflow required
  • Security-sensitive code
  • Before any commit or completion claim

🏆 4 Iron Laws (Mandatory)

1. TDD Iron Law

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
没有失败的测试，绝不写生产代码

Workflow:

  1. Write test first (RED)
  2. Run test → should FAIL
  3. Write minimal implementation (GREEN)
  4. Run test → should PASS
  5. Refactor (IMPROVE)
  6. Verify coverage (80%+)

2. Verification Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
没有新的验证证据，绝不声明完成

Required Evidence:

  • Test results (passing)
  • Coverage report (80%+)
  • Security scan (clean)
  • Code review (approved)

3. Debugging Iron Law

NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
没有根本原因调查，绝不修复

Investigation Steps:

  1. Reproduce the issue
  2. Gather logs and context
  3. Identify root cause (5 Whys)
  4. Propose fix
  5. Test fix
  6. Verify no regression

4. Code Review Marking

🔴 Blocker - Must fix before merge
🟡 Suggestion - Recommended improvement
💭 Nit - Optional polish

Review Checklist:

  • No hardcoded secrets
  • All inputs validated
  • SQL injection prevention
  • XSS prevention
  • CSRF protection
  • Auth/authorization verified
  • Rate limiting enabled
  • Error messages safe

📋 Core Principles (6 Mandatory)

1. Immutability (CRITICAL)

ALWAYS create new objects, NEVER mutate existing ones

WRONG:  modify(original, field, value) → changes in-place
CORRECT: update(original, field, value) → returns new copy

2. 80% Test Coverage

Minimum 80% coverage required for all code

Test Types (ALL required):
1. Unit tests - individual functions/components
2. Integration tests - API endpoints/database operations
3. E2E tests - critical user flows

3. Security First

Before ANY commit, verify:
- No hardcoded secrets (API keys, passwords, tokens)
- All user inputs validated
- SQL injection prevention (parameterized queries)
- XSS prevention (sanitized HTML)
- CSRF protection enabled
- Authentication/authorization verified
- Rate limiting on all endpoints
- Error messages don't leak sensitive data

4. TDD Workflow

RED → GREEN → REFACTOR → VERIFY

1. Write failing test
2. Write minimal implementation
3. Refactor for quality
4. Verify coverage and security

5. File Organization

MANY SMALL FILES > FEW LARGE FILES

- High cohesion, low coupling
- 200-400 lines typical, 800 max
- Extract utilities from large modules
- Organize by feature/domain, not by type

6. Agent Orchestration

Parallel execution, multi-perspective review

- Launch independent agents in parallel
- Use multiple agents for different perspectives
- Aggregate results for comprehensive analysis

🛠️ Tools & Scripts

Language Detector

python tools/language-detector.py --project .
python tools/language-detector.py --file file.ts

Language Switcher

python tools/language-switcher.py --list
python tools/language-switcher.py --set python
python tools/language-switcher.py --current

Hooks Adapter

# ecc-hooks-adapter.py
# PreToolUse/PostToolUse automation
# Automatically logs tool calls and analyzes results

Observer Manager

# ecc-observer-manager.py
# Manages observer lifecycle
# start/stop/status checks

📚 12 Language Supports

LanguageRulesSkills
TypeScriptcoding-style, hooks, patterns, security, testingtypescript-reviewer
JavaScriptcoding-style, hooks, patterns, security, testing-
Pythoncoding-style, hooks, patterns, security, testingpython-reviewer
Javacoding-style, hooks, patterns, security, testingjava-reviewer
Kotlincoding-style, hooks, patterns, security, testingkotlin-reviewer
Gocoding-style, hooks, patterns, security, testinggo-reviewer
Rustcoding-style, hooks, patterns, security, testingrust-reviewer
C++coding-style, hooks, patterns, security, testingcpp-reviewer
C#coding-style, hooks, patterns, security, testing-
PHPcoding-style, hooks, patterns, security, testing-
Perlcoding-style, hooks, patterns, security, testingperl-reviewer
Swiftcoding-style, hooks, patterns, security, testing-

🤝 30 ECC Agents

Engineering (22 agents)

  • architect - System architecture design
  • build-error-resolver - Build error resolution
  • code-reviewer - Code quality review
  • cpp-build-resolver / cpp-reviewer - C++ support
  • go-build-resolver / go-reviewer - Go support
  • java-build-resolver / java-reviewer - Java support
  • kotlin-build-resolver / kotlin-reviewer - Kotlin support
  • python-reviewer - Python code review
  • rust-build-resolver / rust-reviewer - Rust support
  • typescript-reviewer - TypeScript review
  • flutter-reviewer - Flutter review
  • database-reviewer - Database review
  • doc-updater / docs-lookup - Documentation
  • performance-optimizer - Performance optimization
  • refactor-cleaner - Code cleanup
  • pytorch-build-resolver - PyTorch support
  • harness-optimizer - Harness optimization
  • healthcare-reviewer - Healthcare domain review

Testing (2 agents)

  • e2e-runner - E2E test execution
  • tdd-guide - TDD workflow guidance

Project Management (2 agents)

  • chief-of-staff - Communication triage
  • loop-operator - Autonomous loop execution

Specialized (1 agent)

  • planner - Implementation planning

📖 Documentation

Design Documents

  • docs/superpowers/specs/2026-04-03-neural-network-system-design.md
  • ECC-FINAL-REPORT.md
  • ECC-USER-GUIDE.md

Integration Reports

  • ECC-VERIFICATION-COMPLETE.md
  • ECC-TEST-REPORT.md
  • ECC-AGENTS-VERIFICATION-TODO.md

Rules Directory

  • ~/.agents/rules/
    (77 rule files)
  • common/ (10 files)
  • typescript/python/java/kotlin/go/rust/cpp/csharp/php/perl/swift/ (5 files each)
  • zh/ (11 files - Chinese translation)

🚀 Quick Start

1. Check Available Agents

openclaw agents list

2. Check Available Skills

openclaw skills list

3. Detect Project Language

python tools/language-detector.py --project .

4. Set Language Mode

python tools/language-switcher.py --set python

5. Start TDD Workflow

1. Call tdd-guide agent
2. Write failing test
3. Call engineering-python-reviewer (or language-specific)
4. Write minimal implementation
5. Run tests
6. Refactor
7. Call verification-before-completion

✅ Quality Gates

Before Commit

  • Tests passing
  • Coverage 80%+
  • Security scan clean
  • Code review approved
  • No hardcoded secrets
  • All inputs validated

Before Completion Claim

  • Fresh verification evidence
  • Test results attached
  • Coverage report attached
  • Security scan attached
  • Code review approved

Before Bug Fix

  • Root cause identified
  • 5 Whys completed
  • Fix tested
  • No regression verified

📊 Metrics

MetricTargetStatus
Agents30 ECC + existing✅ 211 total
Skills77 rules + existing✅ 164 total
Languages12✅ Activated
Iron Laws4✅ Embedded
Core Principles6✅ Embedded
Test Coverage80%+⭐ Required
Security ScanClean⭐ Required

🔧 Installation

ECC system already integrated into OpenClaw v3.4 - ECC Edition.

Files Location:

  • Agents: 
    ~/.agents/skills/agency-agents/ecc-agents/
    (30 files)
  • Rules: 
    ~/.agents/rules/
    (77 files)
  • Tools: 
    tools/
    and 
    workspace/
  • Docs: 
    workspace/
    and 
    docs/superpowers/

No additional installation required!

📝 Usage Examples

Example 1: Code Review

User: Review this Python code

Flow:
1. Call engineering-python-reviewer
2. Apply python-coding-standards rules
3. Check 4 iron laws compliance
4. Mark issues with 🔴🟡💭
5. Provide fix suggestions

Example 2: New Project

User: Create a new project

Flow:
1. language-detector.py detects language
2. Call planner agent for project structure
3. Call architect agent for architecture
4. Call tdd-guide agent for test setup
5. Apply language-specific rules

Example 3: Bug Fix

User: This feature has a bug

Flow:
1. Follow debugging iron law (investigate first)
2. Call debugging agent for analysis
3. Call language-specific reviewer for fix
4. Call testing agent for verification
5. Check test coverage

Example 4: Multi-language Project

User: This is a multi-language project

Flow:
1. language-detector.py detects all languages
2. language-switcher.py switches current language
3. Apply language-specific rules
4. Call language-specific reviewer
5. Check cross-language interfaces

🎯 Success Criteria

  • 30 ECC agents available
  • 77 rule files available
  • 12 language supports activated
  • 4 iron laws embedded
  • 6 core principles embedded
  • Language tools working
  • Hooks system running
  • New session test passed
  • All verifications complete

Status: ✅ PRODUCTION READY

📞 Support

Documentation:

  • ECC-FINAL-REPORT.md
    - Final integration report
  • ECC-USER-GUIDE.md
    - User guide
  • ECC-VERIFICATION-COMPLETE.md
    - Verification report

Version: OpenClaw v3.4 - ECC Edition
Integration Date: 2026-04-03
Integration Time: 2 hours 21 minutes
Test Pass Rate: 100%