@jungjaehoon/mama-os 0.53.0 → 0.57.0

package/templates/skills/multi-agent-collab.md

@@ -1,145 +0,0 @@
----
-name: 멀티에이전트 협업
-description: Skill Forge 오케스트레이터와 에이전트 역할을 동적으로 배정하여 협업 작업을 수행합니다
-keywords:
-  - 협업
-  - collab
-  - multi-agent
-  - 오케스트라
-  - 역할배정
-  - 팀작업
-output: text
-roles:
-  orchestrator: '작업 조율 및 단계 관리'
-  developer: '코드 작성 및 구현'
-  reviewer: '코드 리뷰 및 품질 검증'
----
-
-# 멀티에이전트 협업 스킬
-
-Skill Forge의 오케스트레이터 패턴을 활용하여 에이전트간 역할을 동적으로 배정하고 협업 작업을 수행합니다.
-
-## 역할 정의
-
-### 🎯 Orchestrator (조율자)
-
-- 작업을 단계별로 분해
-- 에이전트에게 역할 배정
-- 진행 상태 추적 및 핸드오프 관리
-
-### 🔧 Developer (개발자)
-
-- 실제 코드/스킬 작성
-- Architect 설계 또는 Orchestrator 지시에 따라 구현
-- 테스트 코드 포함
-
-### 📝 Reviewer (리뷰어)
-
-- 코드 품질 검증
-- 보안/성능/가독성 체크
-- 점수 기반 피드백 제공
-
-## 워크플로우
-
-```
-┌──────────────────────────────────────────┐
-│           Orchestrator                     │
-│   1. 작업 분석 및 단계 분해                 │
-│   2. 역할 배정 (Dev/Review)                │
-│   3. 핸드오프 관리                          │
-└─────────────┬────────────────────────────┘
-              │
-    ┌─────────┴─────────┐
-    ▼                   ▼
-┌─────────┐       ┌─────────┐
-│Developer│ ────→ │Reviewer │
-│(코드작성)│       │(코드리뷰)│
-└─────────┘       └────┬────┘
-    ▲                   │
-    └───────────────────┘
-        피드백 루프
-```
-
-## 사용법
-
-### 기본 협업 요청
-
-```
-/collab [작업 설명]
-```
-
-### 역할 지정 협업
-
-```
-/collab --dev [에이전트A] --review [에이전트B] [작업 설명]
-```
-
-### 예시
-
-```
-/collab --dev DevBot --review Reviewer 헬스체크 스크립트 작성
-```
-
-## 협업 프로토콜
-
-### Phase 1: 계획 (Orchestrator)
-
-1. 작업 요구사항 분석
-2. 필요 파일/모듈 식별
-3. 단계별 작업 계획 수립
-4. 에이전트 역할 배정
-
-### Phase 2: 구현 (Developer)
-
-1. Orchestrator 계획에 따라 코드 작성
-2. 파일 시스템에 코드 저장
-3. 기본 테스트 실행
-4. 완료 시 Reviewer에게 핸드오프
-
-### Phase 3: 리뷰 (Reviewer)
-
-1. 파일 시스템에서 코드 직접 읽기
-2. 체크리스트 기반 검증:
-   - [ ] 코드 구조 및 가독성
-   - [ ] 에러 핸들링
-   - [ ] 타입 안전성
-   - [ ] 보안 이슈
-   - [ ] 성능 고려사항
-3. 점수 (1-10) 및 피드백 제공
-4. Critical 이슈 시 Developer에게 재작업 요청
-
-### Phase 4: 반복 (필요시)
-
-- Reviewer 피드백 → Developer 수정 → 재리뷰
-- 10/10 또는 승인까지 반복
-
-## 핸드오프 형식
-
-### Developer → Reviewer
-
-```
-📝 리뷰 요청!
-파일: [파일 경로]
-변경 내용: [요약]
-```
-
-### Reviewer → Developer
-
-```
-🔴 Critical: [수정 필요 사항]
-🟡 Suggestion: [개선 제안]
-💡 Nitpick: [사소한 개선점]
-📊 점수: X/10
-```
-
-## 파일 공유 규칙
-
-- 같은 프로젝트 폴더를 공유하므로 **메시지에 코드 복붙 불필요**
-- 파일 경로만 공유하면 상대 에이전트가 직접 읽기 가능
-- 수정 사항은 파일에 직접 반영
-
-## 주의사항
-
-- Discord 메시지 길이 제한 (2000자) 준수
-- 에이전트 간 무한 루프 방지 (최대 3회 반복)
-- 각 단계 완료 후 사용자 확인 가능

package/templates/skills/scheduling.md

@@ -1,107 +0,0 @@
-# MAMA 스케줄링 (크론잡) 스킬
-
-## 개요
-
-MAMA OS는 내장 스케줄러가 있어 반복 작업을 자동 실행할 수 있음.
-
-## 크론잡 추가 방법
-
-### 방법 1: config.yaml 직접 편집
-
-```yaml
-# ~/.mama/config.yaml
-scheduling:
-  jobs:
-    - id: naver_news_hourly
-      name: 네이버 뉴스 (매시)
-      cron: '0 * * * *'
-      prompt: '네이버 뉴스 헤드라인 10개 가져와서 디스코드에 전송'
-      enabled: true
-```
-
-### 방법 2: API 사용
-
-```bash
-# 크론잡 추가
-curl -X POST http://localhost:3847/api/scheduling/jobs \
-  -H "Content-Type: application/json" \
-  -d '{
-    "name": "네이버 뉴스",
-    "cron_expr": "*/10 * * * *",
-    "prompt": "네이버 뉴스 10개 가져와서 디스코드로 전송",
-    "enabled": true
-  }'
-
-# 크론잡 목록
-curl http://localhost:3847/api/scheduling/jobs
-
-# 크론잡 삭제
-curl -X DELETE http://localhost:3847/api/scheduling/jobs/{job_id}
-
-# 크론잡 토글 (활성화/비활성화)
-curl -X PATCH http://localhost:3847/api/scheduling/jobs/{job_id}/toggle
-```
-
-## 크론 표현식 가이드
-
-| 표현식         | 의미          |
-| -------------- | ------------- |
-| `* * * * *`    | 매분          |
-| `*/5 * * * *`  | 5분마다       |
-| `*/10 * * * *` | 10분마다      |
-| `0 * * * *`    | 매시 정각     |
-| `0 9 * * *`    | 매일 오전 9시 |
-| `0 9 * * 1-5`  | 평일 오전 9시 |
-| `0 0 * * *`    | 매일 자정     |
-
-## 크론잡 프롬프트 작성 팁
-
-### 좋은 예
-
-```
-네이버 뉴스 속보 10개를 수집해서 디스코드 채널 {channel_id}로 전송해.
-python3 스크립트로 크롤링하고 discord_send 도구로 전송.
-```
-
-### 나쁜 예
-
-```
-뉴스 보내줘
-```
-
-→ 너무 모호함. 어떤 뉴스? 어디로? 몇 개?
-
-## 결과 전달 (channel 필드)
-
-크론잡 결과를 특정 게이트웨이 채널로 자동 전달할 수 있음.
-
-```yaml
-scheduling:
-  jobs:
-    - id: daily_report
-      name: 일일 리포트
-      cron: '0 9 * * *'
-      prompt: '일일 요약 생성'
-      enabled: true
-      channel: discord:123456789 # gateway:channelId 형식
-```
-
-**지원 형식:**
-
-- `discord:채널ID` — Discord 채널로 전달
-- `slack:채널ID` — Slack 채널로 전달
-- `viewer:세션ID` — Viewer UI로 전달
-- 미지정 시 결과는 DB에만 저장
-
-## 주의사항
-
-- 크론잡은 MAMA 재시작 시 자동 로드됨
-- `enabled: false`로 비활성화 가능
-- 복잡한 작업은 스크립트 파일로 분리 권장
-- 크론잡은 OS 에이전트와 독립된 전용 프로세스에서 실행됨 (Viewer 메시지 차단 없음)
-- 프롬프트 최대 10,000자 제한
-
-## 관련 파일
-
-- 설정: `~/.mama/config.yaml`
-- 로그: `~/.mama/logs/daemon.log` (Cron 태그로 필터)

package/templates/workspace/skill-forge/DESIGN.md

@@ -1,115 +0,0 @@
-# Skill Forge - Multi-Agent Skill Generator
-
-> 다단계 에이전트 팀이 실시간 협업으로 스킬을 생성하는 시스템
-
-## Problem
-
-스킬 작성이 복잡하고 일관성 부족. 매번 구조를 새로 설계해야 하고, 품질 검증이 누락되기 쉬움.
-
-## Solution
-
-**Architect → Developer → QA** 파이프라인으로 스킬 생성 자동화.
-5초 카운트다운으로 각 단계에서 유저 검토 기회 제공.
-
----
-
-## Requirements
-
-### 필수 기능
-
-| #   | 기능                     | 설명                                  |
-| --- | ------------------------ | ------------------------------------- |
-| 1   | **Architect 에이전트**   | 프롬프트/구조 설계 담당               |
-| 2   | **Developer 에이전트**   | 실제 코드/스킬 작성                   |
-| 3   | **QA 에이전트**          | 체크리스트 검증                       |
-| 4   | **에이전트 간 핸드오프** | 자동 위임 + 컨텍스트 전달             |
-| 5   | **Discord 피드백 루프**  | 리액션/버튼으로 승인/수정 요청        |
-| 6   | **MAMA 연동**            | decision 저장, TOOLS.md 자동 업데이트 |
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────┐
-│                   Discord Interface                  │
-└─────────────────────┬───────────────────────────────┘
-                      │
-                      ▼
-┌─────────────────────────────────────────────────────┐
-│                   Orchestrator                       │
-│        (상태 머신 + 카운트다운 + 핸드오프)            │
-└─────────────────────┬───────────────────────────────┘
-                      │
-        ┌─────────────┼─────────────┐
-        ▼             ▼             ▼
-   ┌─────────┐   ┌─────────┐   ┌─────────┐
-   │Architect│ → │Developer│ → │   QA    │
-   │(Sonnet) │   │ (Opus)  │   │(Haiku)  │
-   └─────────┘   └─────────┘   └─────────┘
-```
-
----
-
-## Status
-
-- [x] 설계 문서 작성
-- [x] **Phase 1: 기반 구축** ✅
-  - [x] 1.1 Orchestrator 기본 구조
-  - [x] 1.2 Architect 에이전트
-  - [x] 1.3 5초 카운트다운 + Discord 버튼
-  - [x] 1.4 첫 테스트
-- [x] **Phase 2: 핵심 기능** ✅
-  - [x] 2.1 Developer 에이전트 (코드 생성)
-  - [x] 2.2 에이전트 간 핸드오프
-  - [x] 2.3 QA 에이전트 (체크리스트)
-  - [x] 2.4 통합 테스트
-- [x] **Phase 3: 완성** ✅
-  - [x] 3.1 MAMA 연동 (decision 저장)
-  - [x] 3.2 실제 Claude API 연동
-  - [x] 3.3 Discord UI 개선
-  - [x] 3.4 에러 핸들링 강화
-
----
-
-## Files
-
-| 파일                  | 역할               | Lines |
-| --------------------- | ------------------ | ----- |
-| `types.ts`            | 타입 정의          | ~160  |
-| `orchestrator.ts`     | 상태 머신 + 조율   | ~450  |
-| `agents/architect.ts` | 구조 설계          | ~200  |
-| `agents/developer.ts` | 코드 생성          | ~250  |
-| `agents/qa.ts`        | 체크리스트 검증    | ~200  |
-| `discord-ui.ts`       | Discord UI + Embed | ~350  |
-| `claude-api.ts`       | Claude API 연동    | ~280  |
-| `mama-integration.ts` | MAMA MCP 연동      | ~250  |
-| `error-handler.ts`    | 통합 에러 처리     | ~280  |
-
----
-
-## Test Results
-
-```
-🔥 Full Pipeline Test
-
-📥 REQUEST_RECEIVED
-🚀 Architect → ✅ COMPLETE
-⏱️ 2초 카운트다운 → ⏰ 자동 승인
-🚀 Developer → ✅ COMPLETE
-⏱️ 2초 카운트다운 → ⏰ 자동 승인
-🚀 QA → ✅ COMPLETE
-⏱️ 2초 카운트다운 → ⏰ 자동 승인
-🎉 SESSION_COMPLETE
-
-Generated Files:
-- skills/hello-world/index.ts
-- skills/hello-world/types.ts
-- skills/hello-world/README.md
-
-QA Result: 9/9 checks passed ✅
-```
-
----
-
-Generated by Skill Forge 🔥

package/templates/workspace/skill-forge/agents/architect.ts

@@ -1,295 +0,0 @@
-/**
- * Skill Forge - Architect Agent
- *
- * 역할: 스킬 구조 설계
- * 모델: Sonnet 4 (빠른 구조화)
- *
- * 입력: 사용자 요청 (스킬 이름, 설명, 트리거 등)
- * 출력: ArchitectOutput (구조, 워크플로우, 파일 구조)
- */
-
-import { SkillRequest, ArchitectOutput } from '../types';
-
-// ===== Architect System Prompt =====
-
-const ARCHITECT_SYSTEM_PROMPT = `당신은 Skill Forge의 **Architect 에이전트**입니다.
-
-## 역할
-OpenClaw 스킬의 구조를 설계합니다. 코드를 작성하지 않고, **설계도**만 제공합니다.
-
-## 출력 형식 (JSON)
-{
-  "skillName": "스킬 영문 이름 (kebab-case)",
-  "purpose": "스킬의 목적 (1-2문장)",
-  "triggers": ["트리거1", "트리거2"],
-  "workflow": [
-    {"step": 1, "action": "동사", "description": "설명"},
-    ...
-  ],
-  "fileStructure": [
-    {"path": "상대경로", "purpose": "용도"},
-    ...
-  ],
-  "toolsRequired": ["Read", "Write", ...],
-  "estimatedComplexity": "simple | medium | complex"
-}
-
-## 설계 원칙
-1. **단순함 우선**: 최소한의 파일로 시작
-2. **명확한 워크플로우**: 3-7단계 이내
-3. **기존 도구 활용**: OpenClaw의 기존 도구 사용
-4. **확장 가능성**: 나중에 확장할 수 있는 구조
-
-## 복잡도 기준
-- **simple**: 단일 파일, 1-3 워크플로우 단계
-- **medium**: 2-3 파일, 4-5 워크플로우 단계
-- **complex**: 4+ 파일, 6+ 워크플로우 단계, 외부 API 연동
-
-## 예시 입력
-스킬명: weather-check
-설명: 날씨 정보를 조회합니다
-트리거: /weather, 날씨 알려줘
-
-## 예시 출력
-{
-  "skillName": "weather-check",
-  "purpose": "OpenWeatherMap API를 통해 현재 날씨 정보를 조회하고 사용자에게 알려줍니다",
-  "triggers": ["/weather", "날씨 알려줘", "오늘 날씨"],
-  "workflow": [
-    {"step": 1, "action": "parse", "description": "도시명 추출 (기본값: Seoul)"},
-    {"step": 2, "action": "fetch", "description": "OpenWeatherMap API 호출"},
-    {"step": 3, "action": "format", "description": "응답을 사용자 친화적으로 포맷"},
-    {"step": 4, "action": "respond", "description": "Discord로 결과 전송"}
-  ],
-  "fileStructure": [
-    {"path": "skills/weather-check/index.ts", "purpose": "메인 진입점"},
-    {"path": "skills/weather-check/api.ts", "purpose": "API 호출 로직"},
-    {"path": "skills/weather-check/README.md", "purpose": "사용법 문서"}
-  ],
-  "toolsRequired": ["WebFetch", "discord_send"],
-  "estimatedComplexity": "medium"
-}
-
-JSON만 출력하세요. 설명이나 마크다운 블록 없이 순수 JSON만.`;
-
-// ===== Architect Agent Class =====
-
-export class ArchitectAgent {
-  private systemPrompt: string;
-
-  constructor() {
-    this.systemPrompt = ARCHITECT_SYSTEM_PROMPT;
-  }
-
-  /**
-   * 스킬 요청을 받아 구조를 설계합니다
-   */
-  async design(request: SkillRequest): Promise<ArchitectOutput> {
-    const userPrompt = this.buildUserPrompt(request);
-
-    // Claude API 호출 (Sonnet 4)
-    // 현재는 mock 구현, 실제 API 연동은 Phase 2에서
-    const response = await this.callClaude(userPrompt);
-
-    return this.parseResponse(response);
-  }
-
-  private buildUserPrompt(request: SkillRequest): string {
-    return `스킬명: ${request.name}
-설명: ${request.description}
-트리거: ${request.triggers.join(', ')}
-기능: ${request.capabilities.join(', ')}
-
-원본 입력: ${request.rawInput}`;
-  }
-
-  private async callClaude(userPrompt: string): Promise<string> {
-    // TODO: 실제 Claude API 호출
-    // Phase 2에서 구현
-
-    // Mock 응답 - 프롬프트 기반으로 구조 생성
-    const skillName = this.extractSkillName(userPrompt);
-
-    return JSON.stringify({
-      skillName,
-      purpose: this.extractPurpose(userPrompt),
-      triggers: this.extractTriggers(userPrompt),
-      workflow: this.generateWorkflow(userPrompt),
-      fileStructure: this.generateFileStructure(skillName),
-      toolsRequired: this.inferTools(userPrompt),
-      estimatedComplexity: this.estimateComplexity(userPrompt),
-    });
-  }
-
-  private parseResponse(response: string): ArchitectOutput {
-    try {
-      // JSON 블록 추출 (```json ... ``` 형식 지원)
-      let jsonStr = response;
-      const jsonMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/);
-      if (jsonMatch) {
-        jsonStr = jsonMatch[1];
-      }
-
-      const parsed = JSON.parse(jsonStr.trim());
-
-      // 필수 필드 검증
-      return {
-        skillName: parsed.skillName || 'unnamed-skill',
-        purpose: parsed.purpose || '목적 미정의',
-        triggers: parsed.triggers || [],
-        workflow: parsed.workflow || [],
-        fileStructure: parsed.fileStructure || [],
-        toolsRequired: parsed.toolsRequired || [],
-        estimatedComplexity: parsed.estimatedComplexity || 'simple',
-      };
-    } catch (error) {
-      console.error('[ArchitectAgent] JSON parse error:', error);
-      throw new Error(`Architect 응답 파싱 실패: ${error}`);
-    }
-  }
-
-  // ===== Mock Helpers (실제 API 연동 전까지 사용) =====
-
-  private extractSkillName(prompt: string): string {
-    const match = prompt.match(/스킬명:\s*([^\n]+)/);
-    if (match) {
-      return match[1].trim().toLowerCase().replace(/\s+/g, '-');
-    }
-    return 'unnamed-skill';
-  }
-
-  private extractPurpose(prompt: string): string {
-    const match = prompt.match(/설명:\s*([^\n]+)/);
-    return match ? match[1].trim() : '목적 미정의';
-  }
-
-  private extractTriggers(prompt: string): string[] {
-    const match = prompt.match(/트리거:\s*([^\n]+)/);
-    if (match) {
-      return match[1]
-        .split(',')
-        .map((t) => t.trim())
-        .filter(Boolean);
-    }
-    return [];
-  }
-
-  private generateWorkflow(
-    prompt: string
-  ): Array<{ step: number; action: string; description: string }> {
-    // 기본 워크플로우 템플릿
-    return [
-      { step: 1, action: 'parse', description: '사용자 입력 파싱' },
-      { step: 2, action: 'validate', description: '입력 검증' },
-      { step: 3, action: 'execute', description: '핵심 로직 실행' },
-      { step: 4, action: 'format', description: '결과 포맷팅' },
-      { step: 5, action: 'respond', description: '응답 반환' },
-    ];
-  }
-
-  private generateFileStructure(skillName: string): Array<{ path: string; purpose: string }> {
-    return [
-      { path: `skills/${skillName}/index.ts`, purpose: '메인 진입점' },
-      { path: `skills/${skillName}/types.ts`, purpose: '타입 정의' },
-      { path: `skills/${skillName}/README.md`, purpose: '사용법 문서' },
-    ];
-  }
-
-  private inferTools(prompt: string): string[] {
-    const tools: string[] = ['discord_send']; // 기본
-
-    const lowerPrompt = prompt.toLowerCase();
-
-    if (
-      lowerPrompt.includes('파일') ||
-      lowerPrompt.includes('읽') ||
-      lowerPrompt.includes('read')
-    ) {
-      tools.push('Read');
-    }
-    if (
-      lowerPrompt.includes('작성') ||
-      lowerPrompt.includes('쓰') ||
-      lowerPrompt.includes('write')
-    ) {
-      tools.push('Write');
-    }
-    if (
-      lowerPrompt.includes('api') ||
-      lowerPrompt.includes('fetch') ||
-      lowerPrompt.includes('http')
-    ) {
-      tools.push('WebFetch');
-    }
-    if (
-      lowerPrompt.includes('검색') ||
-      lowerPrompt.includes('search') ||
-      lowerPrompt.includes('grep')
-    ) {
-      tools.push('Grep');
-    }
-    if (
-      lowerPrompt.includes('명령') ||
-      lowerPrompt.includes('bash') ||
-      lowerPrompt.includes('실행')
-    ) {
-      tools.push('Bash');
-    }
-
-    return [...new Set(tools)]; // 중복 제거
-  }
-
-  private estimateComplexity(prompt: string): 'simple' | 'medium' | 'complex' {
-    const lowerPrompt = prompt.toLowerCase();
-
-    // 복잡도 키워드 체크
-    const complexKeywords = ['api', 'database', 'auth', 'multi', '연동', '통합'];
-    const mediumKeywords = ['검색', '파싱', 'parsing', 'format', '변환'];
-
-    for (const kw of complexKeywords) {
-      if (lowerPrompt.includes(kw)) return 'complex';
-    }
-
-    for (const kw of mediumKeywords) {
-      if (lowerPrompt.includes(kw)) return 'medium';
-    }
-
-    return 'simple';
-  }
-}
-
-// ===== Factory Function =====
-
-export function createArchitectAgent(): ArchitectAgent {
-  return new ArchitectAgent();
-}
-
-// ===== 테스트 =====
-
-async function runTest() {
-  console.log('🏗️ Architect Agent Test\n');
-
-  const agent = createArchitectAgent();
-
-  const request: SkillRequest = {
-    name: 'code-review',
-    description: '코드 리뷰를 수행하고 피드백을 제공합니다',
-    triggers: ['/review', '코드 리뷰해줘'],
-    capabilities: ['파일 읽기', '분석', '피드백 제공'],
-    rawInput: '/forge code-review - 코드 리뷰를 수행하고 피드백을 제공합니다',
-  };
-
-  try {
-    const output = await agent.design(request);
-    console.log('✅ Architect Output:\n');
-    console.log(JSON.stringify(output, null, 2));
-  } catch (error) {
-    console.error('❌ Error:', error);
-  }
-}
-
-// ESM entry point
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
-if (isMainModule) {
-  runTest();
-}