casabot 1.0.0

package/skills/chat/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: 대화 관리
+description: 대화 세션을 관리하고 외부 서비스와 연동하기 위한 매뉴얼
+metadata:
+  casabot:
+    requires:
+      bins: []
+---
+
+# 대화 관리
+
+이 매뉴얼은 대화 세션의 생성·조회·검색 방법과 외부 서비스 연동 방법을 설명합니다.
+
+---
+
+## 1. 대화 세션 관리
+
+### 세션 구조
+
+각 대화 세션은 `~/casabot/history/` 디렉토리에 JSON 파일로 자동 저장됩니다.
+
+```json
+{
+  "id": "세션 고유 ID",
+  "startedAt": "2024-01-15T09:30:00.000Z",
+  "messages": [
+    {
+      "role": "user | assistant | system | tool",
+      "content": "메시지 내용",
+      "toolCalls": [],
+      "toolCallId": ""
+    }
+  ]
+}
+```
+
+### 세션 생명주기
+- **생성**: `casabot` 명령어를 실행하면 새 세션이 자동 생성됩니다.
+- **유지**: 대화가 진행되는 동안 메시지가 자동으로 추가됩니다.
+- **종료**: 프로그램을 종료하면 세션이 닫힙니다.
+- **보존**: 종료 후에도 기록은 history 디렉토리에 영구 보존됩니다.
+
+## 2. 대화 불러오기
+
+### 최근 대화 목록 확인
+
+```bash
+# 최근 대화 20개 (최신순)
+ls -lt ~/casabot/history/ | head -20
+
+# 파일명과 크기 확인
+ls -lhS ~/casabot/history/
+```
+
+### 특정 대화 내용 보기
+
+```bash
+# 대화 전체 보기 (정리된 형태)
+cat ~/casabot/history/<conversation-id>.json | jq '.messages[] | {role, content: .content[:100]}'
+
+# 사용자 메시지만 보기
+cat ~/casabot/history/<conversation-id>.json | jq '.messages[] | select(.role == "user") | .content'
+
+# 어시스턴트 응답만 보기
+cat ~/casabot/history/<conversation-id>.json | jq '.messages[] | select(.role == "assistant") | .content'
+```
+
+### 세션 메타정보 확인
+
+```bash
+# 세션 ID와 시작 시간
+cat ~/casabot/history/<conversation-id>.json | jq '{id, startedAt, messageCount: (.messages | length)}'
+```
+
+## 3. 이전 대화 검색
+
+### 키워드로 검색
+
+```bash
+# 모든 대화에서 키워드 검색
+grep -rl "검색어" ~/casabot/history/
+
+# 키워드가 포함된 대화의 맥락 보기
+grep -l "검색어" ~/casabot/history/*.json | while read f; do
+  echo "=== $(basename $f) ==="
+  cat "$f" | jq '.messages[] | select(.content | contains("검색어")) | {role, content: .content[:200]}'
+done
+```
+
+### 날짜로 검색
+
+```bash
+# 특정 날짜 이후의 대화
+find ~/casabot/history/ -name "*.json" -newermt "2024-01-15" -type f
+
+# 오늘 대화만
+find ~/casabot/history/ -name "*.json" -newermt "$(date +%Y-%m-%d)" -type f
+
+# 최근 7일간 대화
+find ~/casabot/history/ -name "*.json" -mtime -7 -type f
+```
+
+### 역할별 검색
+
+```bash
+# 도구 호출이 포함된 대화 찾기
+grep -rl "toolCalls" ~/casabot/history/ | head -10
+
+# 특정 도구가 사용된 대화
+grep -rl "run_command" ~/casabot/history/
+```
+
+## 4. 대화 통계
+
+```bash
+# 전체 대화 수
+ls ~/casabot/history/*.json 2>/dev/null | wc -l
+
+# 가장 긴 대화 (메시지 수 기준)
+for f in ~/casabot/history/*.json; do
+  echo "$(cat "$f" | jq '.messages | length') $(basename $f)"
+done | sort -rn | head -10
+```
+
+## 5. 외부 서비스 연동
+
+외부 메시징 서비스(WhatsApp, Discord, Telegram, Slack 등)와 연동하여 CasAbot을 사용할 수 있습니다.
+
+### 연동 구조
+
+```
+외부 서비스 → [연동 서브에이전트] → base 에이전트 → [작업 서브에이전트들]
+                                    ↓
+                              사용자에게 응답
+```
+
+### 연동 설정 단계
+
+1. **연동 서브에이전트 생성** — `agent` 스킬을 참조하여 연동 전용 컨테이너를 만듭니다.
+2. **서비스 API/봇 설정** — 해당 서비스의 봇 토큰이나 웹훅 URL을 설정합니다.
+3. **메시지 수신** — 서비스에서 메시지를 수신하면 base에게 전달합니다.
+4. **응답 전송** — base의 응답을 서비스로 돌려보냅니다.
+
+### 예시: 웹훅 기반 연동
+
+```bash
+# 연동 에이전트 생성 (agent 스킬 참조)
+podman run -d \
+  --name webhook-bridge \
+  --label casabot=true \
+  -p 8080:8080 \
+  -v ~/casabot/workspaces/webhook-bridge:/workspace \
+  -v ~/casabot/skills:/skills:ro \
+  node:20-slim sleep infinity
+
+# 웹훅 서버 스크립트를 에이전트에 배포
+podman cp webhook-server.js webhook-bridge:/workspace/
+podman exec -d webhook-bridge node /workspace/webhook-server.js
+```
+
+## 6. 주의사항
+
+- **기록은 수정하지 마세요**: `~/casabot/history/`의 파일은 원본 로그입니다. 수정이 필요하면 별도 사본을 만드세요.
+- **메모가 필요하면 memory를 사용하세요**: 대화에서 중요한 내용을 기록하려면 `memory` 스킬을 참조하세요.
+- **대용량 기록 관리**: 기록이 많아지면 오래된 파일을 아카이브하거나 압축하세요.

package/skills/config/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: CasAbot 설정
+description: CasAbot 자체의 구조와 설정을 이해하기 위한 매뉴얼
+metadata:
+  casabot:
+    requires:
+      bins: [jq]
+---
+
+# CasAbot 설정
+
+이 매뉴얼은 CasAbot의 디렉토리 구조, 설정 파일 스키마, 공급자 관리 방법을 설명합니다.
+
+---
+
+## 1. 디렉토리 구조
+
+CasAbot의 모든 데이터는 `~/casabot/` 아래에 저장됩니다.
+
+```
+~/casabot/
+├── casabot.json          # 모든 설정 (공급자, 모델 등)
+├── skills/               # 스킬 디렉토리 (SKILL.md 포함)
+│   ├── agent/            # 에이전트 생성 및 관리
+│   ├── config/           # 설정 관리 (이 문서)
+│   ├── chat/             # 대화 관리
+│   ├── service/          # 시스템 서비스 등록
+│   └── memory/           # 기록(메모) 관리
+├── workspaces/           # 에이전트별 워크스페이스
+│   └── <agent-name>/     # 개별 에이전트 작업 디렉토리
+│       └── output/       # 에이전트 출력 결과
+├── history/              # 대화 전체 기록 (원본 로그, JSON)
+└── memory/               # 에이전트가 직접 작성한 메모 (.md)
+```
+
+### 각 디렉토리의 역할
+
+| 디렉토리 | 설명 | 형식 |
+|---------|------|------|
+| `casabot.json` | 공급자 설정, 활성 모델 등 전체 설정 | JSON |
+| `skills/` | base 에이전트가 참조하는 스킬 매뉴얼 | SKILL.md (YAML + Markdown) |
+| `workspaces/` | 서브에이전트 컨테이너에 마운트되는 작업 공간 | 자유 형식 |
+| `history/` | 자동 저장되는 대화 로그 (수정 불가) | JSON |
+| `memory/` | 에이전트가 직접 작성하는 메모 | Markdown |
+
+## 2. casabot.json 스키마
+
+설정 파일의 전체 구조입니다.
+
+```json
+{
+  "providers": [
+    {
+      "name": "공급자 이름 (고유 식별자)",
+      "type": "openai | anthropic | huggingface | openrouter | custom-openai | custom-anthropic",
+      "apiKey": "API 키",
+      "endpoint": "커스텀 엔드포인트 URL (선택, custom-* 타입에서 필수)",
+      "model": "모델 이름",
+      "isDefault": true
+    }
+  ],
+  "activeProvider": "현재 사용 중인 공급자 이름",
+  "baseModel": "기본 모델 이름"
+}
+```
+
+### 필드 설명
+
+| 필드 | 타입 | 필수 | 설명 |
+|-----|------|-----|------|
+| `providers` | 배열 | ✅ | 등록된 공급자 목록 |
+| `providers[].name` | 문자열 | ✅ | 공급자의 고유 이름 |
+| `providers[].type` | 문자열 | ✅ | 공급자 타입 (아래 지원 타입 참조) |
+| `providers[].apiKey` | 문자열 | ✅ | 해당 공급자의 API 키 |
+| `providers[].endpoint` | 문자열 | ❌ | 커스텀 엔드포인트 (custom-openai, custom-anthropic에서 필수) |
+| `providers[].model` | 문자열 | ✅ | 사용할 모델 이름 |
+| `providers[].isDefault` | 불리언 | ✅ | 기본 공급자 여부 |
+| `activeProvider` | 문자열 | ✅ | 현재 활성 공급자의 name 값 |
+| `baseModel` | 문자열 | ✅ | base 에이전트가 사용하는 모델 |
+
+### 지원하는 공급자 타입
+
+- `openai` — OpenAI API (GPT 시리즈)
+- `anthropic` — Anthropic API (Claude 시리즈)
+- `huggingface` — Hugging Face Inference API
+- `openrouter` — OpenRouter 통합 API
+- `custom-openai` — OpenAI 호환 커스텀 엔드포인트
+- `custom-anthropic` — Anthropic 호환 커스텀 엔드포인트
+
+## 3. 공급자 추가 방법
+
+casabot.json의 `providers` 배열에 새 항목을 추가합니다.
+
+```bash
+# 새 공급자 추가 (jq 사용)
+cat ~/casabot/casabot.json | jq '.providers += [{
+  "name": "my-openai",
+  "type": "openai",
+  "apiKey": "sk-...",
+  "model": "gpt-4o",
+  "isDefault": false
+}]' > /tmp/casabot.json && mv /tmp/casabot.json ~/casabot/casabot.json
+```
+
+### 커스텀 공급자 추가 예시
+
+```bash
+cat ~/casabot/casabot.json | jq '.providers += [{
+  "name": "local-llm",
+  "type": "custom-openai",
+  "apiKey": "not-needed",
+  "endpoint": "http://localhost:11434/v1",
+  "model": "llama3",
+  "isDefault": false
+}]' > /tmp/casabot.json && mv /tmp/casabot.json ~/casabot/casabot.json
+```
+
+## 4. 활성 공급자 변경
+
+현재 사용하는 공급자를 변경합니다.
+
+```bash
+# activeProvider 변경
+cat ~/casabot/casabot.json | jq '.activeProvider = "my-openai"' > /tmp/casabot.json && mv /tmp/casabot.json ~/casabot/casabot.json
+```
+
+### baseModel도 함께 변경
+
+```bash
+cat ~/casabot/casabot.json | jq '
+  .activeProvider = "my-openai" |
+  .baseModel = "gpt-4o"
+' > /tmp/casabot.json && mv /tmp/casabot.json ~/casabot/casabot.json
+```
+
+## 5. 현재 설정 확인
+
+```bash
+# 전체 설정 보기
+cat ~/casabot/casabot.json | jq .
+
+# 활성 공급자만 확인
+cat ~/casabot/casabot.json | jq '.activeProvider'
+
+# 등록된 공급자 목록
+cat ~/casabot/casabot.json | jq '.providers[] | {name, type, model}'
+```
+
+## 6. 공급자 삭제
+
+```bash
+# 이름으로 공급자 삭제
+cat ~/casabot/casabot.json | jq '.providers = [.providers[] | select(.name != "삭제할-이름")]' > /tmp/casabot.json && mv /tmp/casabot.json ~/casabot/casabot.json
+```
+
+## 7. 설정 초기화
+
+전체 설정을 초기화하려면 `casabot setup` 명령어를 다시 실행합니다.
+
+```bash
+casabot setup
+```
+
+또는 설정 파일을 직접 초기화합니다:
+
+```bash
+echo '{"providers":[],"activeProvider":"","baseModel":""}' > ~/casabot/casabot.json
+```

package/skills/memory/SKILL.md

@@ -0,0 +1,245 @@
+---
+name: 기록
+description: base와 서브에이전트가 기록(memory)을 작성하고 조회하기 위한 매뉴얼
+metadata:
+  casabot:
+    requires:
+      bins: []
+---
+
+# 기록 (Memory)
+
+이 매뉴얼은 기억(History)과 기록(Memory)의 차이를 설명하고, 에이전트가 메모를 작성하고 조회하는 방법을 안내합니다.
+
+---
+
+## 1. 기억(History)과 기록(Memory)의 차이
+
+CasAbot에는 두 가지 저장소가 있습니다. 반드시 구분하여 사용하세요.
+
+### 기억 (History) — 대화 로그
+
+| 항목 | 설명 |
+|------|------|
+| **경로** | `~/casabot/history/` |
+| **형식** | JSON |
+| **작성자** | 시스템 (자동 저장) |
+| **수정 가능** | ❌ 수정 불가 |
+| **용도** | 대화 전체의 원본 기록 |
+| **내용** | 사용자 입력, 에이전트 응답, 도구 호출 결과 등 |
+
+### 기록 (Memory) — 에이전트 메모
+
+| 항목 | 설명 |
+|------|------|
+| **경로** | `~/casabot/memory/` |
+| **형식** | Markdown (.md) |
+| **작성자** | 에이전트 (직접 작성) |
+| **수정 가능** | ✅ 자유롭게 수정 가능 |
+| **용도** | 중요한 정보, 학습 내용, 분석 결과 등을 기록 |
+| **내용** | 에이전트가 기억해야 할 사항 |
+
+### 핵심 원칙
+
+- **History는 절대 수정하지 않습니다.** 원본 대화 로그로서 보존됩니다.
+- **Memory는 에이전트가 자유롭게 작성·수정·삭제합니다.** 중요한 정보를 정리하는 공간입니다.
+- 대화에서 중요한 내용이 나오면, 그 내용을 Memory에 기록하세요.
+
+## 2. 기록 파일 위치
+
+```
+~/casabot/memory/
+├── 2024-01-15-프로젝트-분석.md
+├── 2024-01-16-서버-설정.md
+├── 사용자-선호도.md
+├── 자주-사용하는-명령어.md
+└── ...
+```
+
+## 3. 기록 작성 규칙
+
+### 파일명 규칙
+
+- **날짜 포함 (권장)**: `YYYY-MM-DD-주제.md` — 특정 시점의 기록
+- **날짜 미포함**: `주제.md` — 지속적으로 업데이트되는 기록
+- 한글, 영문, 숫자, 하이픈(`-`) 사용
+- 공백 대신 하이픈 사용
+
+### 파일 형식
+
+모든 기록은 마크다운(.md) 형식으로 작성합니다.
+
+### 기록 내용 구조 (권장)
+
+```markdown
+# 제목
+
+- **작성자**: 에이전트 이름
+- **날짜**: YYYY-MM-DD
+- **태그**: #키워드1 #키워드2
+
+## 요약
+핵심 내용 한두 줄 요약
+
+## 상세
+자세한 내용...
+
+## 관련 항목
+- 관련 기록 파일명
+- 관련 대화 ID
+```
+
+### 기록 작성 예시
+
+```bash
+cat > ~/casabot/memory/2024-01-15-프로젝트-분석.md << 'EOF'
+# 프로젝트 분석 결과
+
+- **작성자**: code-reviewer
+- **날짜**: 2024-01-15
+- **태그**: #프로젝트 #코드분석
+
+## 요약
+사용자의 Node.js 프로젝트를 분석한 결과, Express 기반 REST API 서버이며 TypeScript를 사용합니다.
+
+## 상세
+- 프레임워크: Express 4.18
+- 언어: TypeScript 5.3
+- 데이터베이스: PostgreSQL (Prisma ORM)
+- 테스트: Jest
+- 주요 엔드포인트: /api/users, /api/posts, /api/auth
+
+## 개선 제안
+1. 에러 핸들링 미들웨어 추가
+2. 환경변수 검증 로직 추가
+3. API 문서화 (Swagger)
+EOF
+```
+
+### 기록 업데이트 예시
+
+지속적인 기록은 내용을 추가하거나 수정합니다:
+
+```bash
+# 기존 기록에 내용 추가
+cat >> ~/casabot/memory/사용자-선호도.md << 'EOF'
+
+## 2024-01-16 추가
+- 코드 스타일: ESLint + Prettier 선호
+- 커밋 메시지: Conventional Commits 형식 선호
+EOF
+```
+
+## 4. 기록 조회 및 검색
+
+### 전체 기록 목록
+
+```bash
+# 최신순으로 기록 목록
+ls -lt ~/casabot/memory/
+
+# 파일명만 목록
+ls ~/casabot/memory/
+```
+
+### 키워드 검색
+
+```bash
+# 전체 기록에서 키워드 검색
+grep -rl "검색어" ~/casabot/memory/
+
+# 검색 결과와 함께 맥락 보기 (앞뒤 2줄 포함)
+grep -rn -C 2 "검색어" ~/casabot/memory/
+```
+
+### 태그 검색
+
+```bash
+# 태그로 기록 찾기
+grep -rl "#프로젝트" ~/casabot/memory/
+grep -rl "#코드분석" ~/casabot/memory/
+```
+
+### 특정 기록 읽기
+
+```bash
+# 기록 전체 읽기
+cat ~/casabot/memory/<filename>.md
+
+# 제목(h1)만 모아보기
+grep "^# " ~/casabot/memory/*.md
+```
+
+### 날짜별 검색
+
+```bash
+# 특정 날짜 이후 수정된 기록
+find ~/casabot/memory/ -name "*.md" -newermt "2024-01-15" -type f
+
+# 최근 7일 내 수정된 기록
+find ~/casabot/memory/ -name "*.md" -mtime -7 -type f
+
+# 파일명에 날짜가 포함된 기록 검색
+ls ~/casabot/memory/2024-01-*.md 2>/dev/null
+```
+
+### 작성자별 검색
+
+```bash
+# 특정 에이전트가 작성한 기록
+grep -rl "작성자.*code-reviewer" ~/casabot/memory/
+```
+
+## 5. 기록 관리
+
+### 기록 삭제
+
+```bash
+rm ~/casabot/memory/<filename>.md
+```
+
+### 기록 백업
+
+```bash
+# 전체 기록 백업
+tar czf ~/casabot-memory-backup-$(date +%Y%m%d).tar.gz ~/casabot/memory/
+```
+
+### 오래된 기록 아카이브
+
+```bash
+# 아카이브 디렉토리 생성
+mkdir -p ~/casabot/memory/archive
+
+# 30일 이상 된 기록 이동
+find ~/casabot/memory/ -maxdepth 1 -name "*.md" -mtime +30 -exec mv {} ~/casabot/memory/archive/ \;
+```
+
+## 6. 서브에이전트의 기록 작성
+
+서브에이전트도 동일한 `~/casabot/memory/` 디렉토리에 기록을 작성할 수 있습니다. 컨테이너에 memory 디렉토리를 마운트합니다:
+
+```bash
+podman run -d \
+  --name <agent-name> \
+  --label casabot=true \
+  -v ~/casabot/workspaces/<agent-name>:/workspace \
+  -v ~/casabot/skills:/skills:ro \
+  -v ~/casabot/memory:/memory \
+  node:20-slim sleep infinity
+```
+
+서브에이전트 내부에서:
+
+```bash
+# 기록 작성
+cat > /memory/2024-01-15-분석결과.md << 'EOF'
+# 분석 결과
+- **작성자**: <agent-name>
+...
+EOF
+
+# 기록 조회
+ls /memory/
+cat /memory/<filename>.md
+```