opencode-sa-assistant 0.1.0

package/src/skills/docx/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: docx
+description: "Word 문서 생성, 편집, 분석. AWS Blog 스타일의 기술 문서, 아키텍처 가이드, 구현 문서 등 모든 .docx 파일 작업에 사용"
+license: Proprietary
+---
+
+# DOCX Creation, Editing, and Analysis - AWS Blog Style
+
+## Overview
+
+AWS Blog 형식의 전문적인 Word 문서를 생성합니다. docx-js 라이브러리를 사용하여 JavaScript로 Word 문서를 생성하며, AWS 공식 블로그 스타일을 준수합니다.
+
+## AWS Blog 문서 구조
+
+### 표준 섹션 구성
+
+```
+1. 제목 (Title)
+   - 명확하고 구체적인 제목
+   - 핵심 키워드 포함
+
+2. 개요 (Overview)
+   - 문서의 목적과 범위
+   - 대상 독자
+   - 예상 소요 시간
+
+3. 배경/문제 정의 (Background/Problem Statement)
+   - 현재 상황 설명
+   - 해결해야 할 문제
+   - 비즈니스 영향
+
+4. 솔루션 아키텍처 (Solution Architecture)
+   - 아키텍처 다이어그램
+   - 주요 구성 요소 설명
+   - 데이터 흐름
+
+5. 구현 단계 (Implementation Steps)
+   - 단계별 가이드
+   - 코드 예제
+   - 스크린샷/다이어그램
+
+6. 비용 분석 (Cost Analysis)
+   - 예상 비용
+   - 비용 최적화 팁
+
+7. 보안 고려사항 (Security Considerations)
+   - 보안 Best Practice
+   - IAM 정책 예시
+
+8. 결론 (Conclusion)
+   - 핵심 요약
+   - 다음 단계
+   - 추가 리소스 링크
+```
+
+## docx-js 기본 사용법
+
+### 설정 및 기본 구조
+
+```javascript
+const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell, 
+        ImageRun, Header, Footer, AlignmentType, HeadingLevel, BorderStyle, 
+        WidthType, ShadingType, LevelFormat } = require('docx');
+const fs = require('fs');
+
+// 문서 생성
+const doc = new Document({
+  styles: {
+    default: { 
+      document: { 
+        run: { font: "Arial", size: 24 } // 12pt 기본
+      } 
+    },
+    paragraphStyles: [
+      { 
+        id: "Title", 
+        name: "Title", 
+        basedOn: "Normal",
+        run: { size: 56, bold: true, color: "232F3E" }, // AWS 다크 블루
+        paragraph: { spacing: { before: 240, after: 120 }, alignment: AlignmentType.CENTER }
+      },
+      { 
+        id: "Heading1", 
+        name: "Heading 1", 
+        basedOn: "Normal",
+        run: { size: 32, bold: true, color: "232F3E" },
+        paragraph: { spacing: { before: 240, after: 120 }, outlineLevel: 0 }
+      },
+      { 
+        id: "Heading2", 
+        name: "Heading 2", 
+        basedOn: "Normal",
+        run: { size: 28, bold: true, color: "545B64" },
+        paragraph: { spacing: { before: 180, after: 90 }, outlineLevel: 1 }
+      }
+    ]
+  },
+  sections: [{
+    properties: {
+      page: { margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } }
+    },
+    children: [/* 내용 */]
+  }]
+});
+
+// 파일 저장
+Packer.toBuffer(doc).then(buffer => {
+  fs.writeFileSync("document.docx", buffer);
+});
+```
+
+### AWS 브랜드 색상
+
+```javascript
+const AWS_COLORS = {
+  SQUID_INK: "232F3E",      // 메인 다크 블루
+  SMILE_ORANGE: "FF9900",   // AWS 오렌지
+  ANCHOR: "545B64",         // 보조 그레이
+  SQUID_INK_LIGHT: "37475A", // 라이트 다크 블루
+  CLOUD: "F2F3F3",          // 배경 그레이
+  WHITE: "FFFFFF"
+};
+```
+
+### 텍스트 및 단락
+
+```javascript
+// 제목
+new Paragraph({
+  heading: HeadingLevel.TITLE,
+  children: [new TextRun("AWS 아키텍처 가이드")]
+}),
+
+// 본문 텍스트
+new Paragraph({
+  children: [
+    new TextRun("일반 텍스트 "),
+    new TextRun({ text: "강조 텍스트", bold: true }),
+    new TextRun({ text: " 코드", font: "Courier New", color: "232F3E" })
+  ]
+}),
+
+// 헤딩
+new Paragraph({
+  heading: HeadingLevel.HEADING_1,
+  children: [new TextRun("1. 개요")]
+})
+```
+
+### 리스트 (불릿/번호)
+
+```javascript
+// 문서 설정에 numbering 추가
+const doc = new Document({
+  numbering: {
+    config: [
+      {
+        reference: "bullet-list",
+        levels: [{
+          level: 0,
+          format: LevelFormat.BULLET,
+          text: "•",
+          alignment: AlignmentType.LEFT,
+          style: { paragraph: { indent: { left: 720, hanging: 360 } } }
+        }]
+      },
+      {
+        reference: "numbered-list",
+        levels: [{
+          level: 0,
+          format: LevelFormat.DECIMAL,
+          text: "%1.",
+          alignment: AlignmentType.LEFT,
+          style: { paragraph: { indent: { left: 720, hanging: 360 } } }
+        }]
+      }
+    ]
+  },
+  // ... sections
+});
+
+// 불릿 리스트 사용
+new Paragraph({
+  numbering: { reference: "bullet-list", level: 0 },
+  children: [new TextRun("첫 번째 항목")]
+}),
+new Paragraph({
+  numbering: { reference: "bullet-list", level: 0 },
+  children: [new TextRun("두 번째 항목")]
+})
+```
+
+### 테이블
+
+```javascript
+const tableBorder = { style: BorderStyle.SINGLE, size: 1, color: "CCCCCC" };
+const cellBorders = { top: tableBorder, bottom: tableBorder, left: tableBorder, right: tableBorder };
+
+new Table({
+  columnWidths: [3000, 6360], // DXA 단위 (1440 = 1인치)
+  rows: [
+    // 헤더 행
+    new TableRow({
+      tableHeader: true,
+      children: [
+        new TableCell({
+          borders: cellBorders,
+          shading: { fill: "232F3E", type: ShadingType.CLEAR },
+          children: [new Paragraph({
+            children: [new TextRun({ text: "서비스", bold: true, color: "FFFFFF" })]
+          })]
+        }),
+        new TableCell({
+          borders: cellBorders,
+          shading: { fill: "232F3E", type: ShadingType.CLEAR },
+          children: [new Paragraph({
+            children: [new TextRun({ text: "설명", bold: true, color: "FFFFFF" })]
+          })]
+        })
+      ]
+    }),
+    // 데이터 행
+    new TableRow({
+      children: [
+        new TableCell({
+          borders: cellBorders,
+          children: [new Paragraph({ children: [new TextRun("Amazon EC2")] })]
+        }),
+        new TableCell({
+          borders: cellBorders,
+          children: [new Paragraph({ children: [new TextRun("가상 서버 컴퓨팅")] })]
+        })
+      ]
+    })
+  ]
+})
+```
+
+### 코드 블록
+
+```javascript
+// 코드 블록 스타일
+new Paragraph({
+  shading: { fill: "F5F5F5", type: ShadingType.CLEAR },
+  spacing: { before: 120, after: 120 },
+  children: [
+    new TextRun({
+      text: "aws ec2 describe-instances --region ap-northeast-2",
+      font: "Courier New",
+      size: 20
+    })
+  ]
+})
+```
+
+### 이미지 삽입
+
+```javascript
+// 이미지 삽입 (type 필수)
+new Paragraph({
+  alignment: AlignmentType.CENTER,
+  children: [new ImageRun({
+    type: "png",
+    data: fs.readFileSync("architecture-diagram.png"),
+    transformation: { width: 500, height: 300 },
+    altText: { 
+      title: "아키텍처 다이어그램", 
+      description: "AWS 솔루션 아키텍처", 
+      name: "architecture" 
+    }
+  })]
+})
+```
+
+## AWS Blog 스타일 가이드
+
+### 작성 원칙
+
+1. **명확성**: 기술 용어는 처음 사용 시 설명
+2. **구조화**: 논리적인 섹션 구분
+3. **실용성**: 실행 가능한 코드와 명령어 제공
+4. **시각화**: 다이어그램과 스크린샷 활용
+5. **완결성**: 처음부터 끝까지 따라할 수 있는 가이드
+
+### 문서 체크리스트
+
+- [ ] 제목이 명확하고 검색 가능한가?
+- [ ] 개요에서 문서의 목적이 명확한가?
+- [ ] 아키텍처 다이어그램이 포함되어 있는가?
+- [ ] 코드 예제가 실행 가능한가?
+- [ ] 비용 정보가 포함되어 있는가?
+- [ ] 보안 고려사항이 명시되어 있는가?
+- [ ] 다음 단계와 추가 리소스가 안내되어 있는가?
+
+## 주의사항
+
+- **줄바꿈**: `\n` 대신 별도의 Paragraph 사용
+- **불릿**: 유니코드 기호 대신 numbering config 사용
+- **색상**: `#` 없이 hex 코드만 사용
+- **이미지**: type 파라미터 필수 지정
+- **테이블 배경**: ShadingType.CLEAR 사용 (SOLID 금지)
+
+## Dependencies
+
+필수 의존성:
+- **docx**: `npm install docx` (문서 생성)
+- **sharp**: `npm install sharp` (이미지 처리)

package/src/skills/guru/SKILL.md

@@ -0,0 +1,217 @@
+---
+name: guru
+description: "전문가 Guru 자문 시스템. 아키텍처 설계, 비즈니스 전략, 기술 결정, 고객 설득 등 복잡한 문제에 대해 저명한 전문가들의 사고방식 기반 조언을 제공. 모든 중요한 결정에 적극 활용 권장"
+license: Proprietary
+---
+
+# Guru 전문가 자문 시스템
+
+## Overview
+
+Guru 시스템은 저명한 전문가들의 사고방식을 학습한 AI 코치들로 구성됩니다.
+복잡한 문제, 아키텍처 결정, 비즈니스 전략 등에 대해 다각적인 관점의 조언을 제공합니다.
+
+**중요**: Guru 자문은 선택이 아닌 필수입니다. 모든 중요한 결정에 적극적으로 활용하세요.
+
+## 사용 가능한 Guru
+
+### 1. Jeff Bezos Guru (`sa-bezos`)
+**전문 분야**: 고객 중심 사고, 장기적 비전, Day 1 문화
+
+**핵심 원칙**:
+- Customer Obsession: 모든 결정의 시작점은 고객
+- Day 1 Mentality: 항상 스타트업처럼 민첩하게
+- Long-term Thinking: 단기 이익보다 장기 가치
+- Working Backwards: 고객이 원하는 결과에서 역방향으로 사고
+
+**활용 시점**:
+- 고객 가치 정의가 필요할 때
+- 비즈니스 우선순위 결정 시
+- 장기 전략 수립 시
+- 제품/서비스 방향성 검토 시
+
+**예시 사용법**:
+```typescript
+delegate_task(
+  subagent_type="sa-bezos",
+  prompt="이 아키텍처가 고객에게 어떤 가치를 제공하나요?"
+)
+
+delegate_task(
+  subagent_type="sa-bezos",
+  prompt="이 기능의 우선순위를 어떻게 정해야 할까요?"
+)
+
+delegate_task(
+  subagent_type="sa-bezos",
+  prompt="3년 후를 고려했을 때 이 결정이 맞을까요?"
+)
+```
+
+### 2. Werner Vogels Guru (`sa-vogels`)
+**전문 분야**: 분산 시스템, 확장성, 운영 우수성
+
+**핵심 원칙**:
+- Everything Fails: 장애는 필연, 복원력이 핵심
+- Design for Failure: 장애를 가정한 설계
+- Loose Coupling: 느슨한 결합, 높은 응집
+- You Build It, You Run It: 개발팀이 운영까지
+
+**활용 시점**:
+- 시스템 아키텍처 설계/검토 시
+- 확장성 전략 수립 시
+- 장애 대응 설계 시
+- 운영 프로세스 정의 시
+
+**예시 사용법**:
+```typescript
+delegate_task(
+  subagent_type="sa-vogels",
+  prompt="이 시스템의 확장성을 어떻게 개선할 수 있을까요?"
+)
+
+delegate_task(
+  subagent_type="sa-vogels",
+  prompt="이 아키텍처의 단일 장애점은 무엇인가요?"
+)
+
+delegate_task(
+  subagent_type="sa-vogels",
+  prompt="마이크로서비스 경계를 어떻게 나눠야 할까요?"
+)
+```
+
+### 3. Naval Ravikant Guru (`sa-naval`)
+**전문 분야**: 레버리지, 비대칭적 결과, 시스템적 사고
+
+**핵심 원칙**:
+- Leverage: 시간과 노력의 레버리지 극대화
+- Asymmetric Outcomes: 작은 투입, 큰 결과
+- Compounding: 복리 효과 활용
+- Clear Thinking: 명확한 사고가 명확한 결과
+
+**활용 시점**:
+- 투자 대비 효과 분석 시
+- 자동화/효율화 전략 수립 시
+- 리소스 배분 결정 시
+- 장기적 성장 전략 검토 시
+
+**예시 사용법**:
+```typescript
+delegate_task(
+  subagent_type="sa-naval",
+  prompt="이 작업에서 레버리지를 극대화하려면?"
+)
+
+delegate_task(
+  subagent_type="sa-naval",
+  prompt="한 번 만들어서 반복 사용할 수 있는 것은?"
+)
+
+delegate_task(
+  subagent_type="sa-naval",
+  prompt="이 결정의 2차, 3차 효과는 무엇인가요?"
+)
+```
+
+### 4. Richard Feynman Guru (`sa-feynman`)
+**전문 분야**: 복잡한 개념 단순화, 학습 최적화, First Principles
+
+**핵심 원칙**:
+- Feynman Technique: 가르칠 수 있어야 이해한 것
+- First Principles: 근본 원리부터 시작
+- Simplicity: 복잡한 것을 단순하게
+- Curiosity: 끊임없는 호기심
+
+**활용 시점**:
+- 복잡한 개념 설명이 필요할 때
+- 고객/이해관계자 설득 시
+- 기술 문서 작성 시
+- 문제의 본질 파악이 필요할 때
+
+**예시 사용법**:
+```typescript
+delegate_task(
+  subagent_type="sa-feynman",
+  prompt="이 아키텍처를 비전문가에게 어떻게 설명할까요?"
+)
+
+delegate_task(
+  subagent_type="sa-feynman",
+  prompt="이 문제의 근본 원인은 무엇인가요?"
+)
+
+delegate_task(
+  subagent_type="sa-feynman",
+  prompt="가장 단순한 해결책은 무엇인가요?"
+)
+```
+
+## Guru 활용 전략
+
+### 필수 활용 시점 (반드시 Guru 자문 필요)
+
+1. **아키텍처 설계/검토**
+   - sa-vogels: 기술적 타당성, 확장성, 복원력
+   - sa-bezos: 고객 가치, 장기 비전
+
+2. **비용 최적화 결정**
+   - sa-naval: 레버리지, ROI 분석
+   - sa-bezos: 고객 영향, 장기 비용
+
+3. **보안 아키텍처**
+   - sa-vogels: 기술적 보안 설계
+   - sa-feynman: 보안 원칙의 본질
+
+4. **고객 프레젠테이션 준비**
+   - sa-feynman: 명확한 설명
+   - sa-bezos: 고객 가치 강조
+
+5. **트레이드오프 결정**
+   - 최소 2명의 Guru 자문 필수
+   - 다각적 관점 확보
+
+### 권장 활용 패턴
+
+```typescript
+// 패턴 1: 단일 Guru 자문
+delegate_task(
+  subagent_type="sa-vogels",
+  prompt="이 아키텍처의 확장성 문제점은?"
+)
+
+// 패턴 2: 다중 Guru 자문 (복잡한 결정)
+delegate_task(
+  subagent_type="sa-bezos",
+  prompt="고객 관점에서 이 기능의 가치는?"
+)
+delegate_task(
+  subagent_type="sa-vogels",
+  prompt="기술적으로 구현 가능한가?"
+)
+delegate_task(
+  subagent_type="sa-naval",
+  prompt="투자 대비 효과는?"
+)
+
+// 패턴 3: 검증 자문 (결정 후 검증)
+// 결정을 내린 후 다른 Guru에게 검증
+delegate_task(
+  subagent_type="sa-feynman",
+  prompt="이 결정을 단순하게 설명하면?"
+)
+```
+
+## Best Practices
+
+1. **구체적인 질문**: 막연한 질문보다 구체적인 상황과 맥락 제공
+2. **다중 관점**: 중요한 결정은 2명 이상의 Guru에게 자문
+3. **후속 질문**: 첫 답변에서 더 깊이 파고들기
+4. **결과 종합**: 여러 Guru의 조언을 종합하여 최종 결정
+5. **적극적 활용**: 의심될 때는 항상 Guru에게 물어보기
+
+## 주의사항
+
+- Guru는 조언을 제공하지만 최종 결정은 사용자의 몫
+- 각 Guru의 전문 분야에 맞는 질문이 더 좋은 답변을 얻음
+- 복잡한 문제는 여러 Guru의 관점을 종합하여 판단

package/src/skills/mcp/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: mcp
+description: "AWS MCP 도구 사용 가이드. AWS Documentation, Support, Pricing, Well-Architected Security MCP 서버를 활용한 정보 조회 및 분석"
+license: Proprietary
+---
+
+# AWS MCP Tools Skill
+
+AWS 관련 정보를 조회하고 분석하기 위한 MCP 도구 사용 가이드입니다.
+
+## AWS Documentation MCP Server
+
+AWS 공식 문서를 검색하고 읽을 수 있습니다.
+
+### 도구 목록
+
+#### search_documentation
+AWS 문서를 검색합니다.
+
+```
+사용 예시:
+- 서비스 기능 검색: "Lambda concurrency limits"
+- Best Practice 검색: "S3 security best practices"
+- 아키텍처 패턴 검색: "serverless architecture patterns"
+```
+
+**파라미터:**
+- `query`: 검색어 (필수)
+- `max_results`: 최대 결과 수 (선택, 기본: 10)
+
+#### read_documentation
+특정 문서의 내용을 읽습니다.
+
+**파라미터:**
+- `url`: 문서 URL (필수)
+
+### 사용 시점
+- 서비스 기능 및 제한사항 확인
+- Best Practice 및 권장사항 조회
+- 아키텍처 패턴 및 사례 연구
+- API 및 SDK 문서 참조
+
+---
+
+## AWS Support MCP Server
+
+AWS Support 케이스를 검색하고 조회합니다.
+
+### 도구 목록
+
+#### search_cases
+지원 케이스를 검색합니다.
+
+**파라미터:**
+- `query`: 검색어 (필수)
+- `status`: 케이스 상태 필터 (선택)
+
+#### get_case
+특정 케이스의 상세 정보를 조회합니다.
+
+**파라미터:**
+- `case_id`: 케이스 ID (필수)
+
+### 사용 시점
+- 알려진 이슈 확인
+- 해결 방안 조사
+- 유사 문제 사례 검색
+
+---
+
+## AWS Pricing MCP Server
+
+AWS 서비스 가격 정보를 조회합니다.
+
+### 도구 목록
+
+#### get_pricing
+서비스 가격 정보를 조회합니다.
+
+**파라미터:**
+- `service`: 서비스 코드 (필수, 예: "AmazonEC2", "AmazonS3")
+- `region`: 리전 (선택)
+- `filters`: 추가 필터 (선택)
+
+#### estimate_cost
+예상 비용을 계산합니다.
+
+**파라미터:**
+- `resources`: 리소스 목록 (필수)
+- `period`: 기간 (선택, 기본: "monthly")
+
+### 사용 시점
+- 비용 분석 및 추정
+- TCO (Total Cost of Ownership) 계산
+- 비용 최적화 권장사항 도출
+- 서비스 간 비용 비교
+
+---
+
+## Well-Architected Security MCP Server
+
+AWS Well-Architected Framework 보안 관련 정보를 제공합니다.
+
+### 도구 목록
+
+#### get_security_best_practices
+보안 Best Practice를 조회합니다.
+
+**파라미터:**
+- `category`: 보안 카테고리 (선택)
+  - "identity": IAM 및 접근 관리
+  - "detection": 탐지 및 모니터링
+  - "infrastructure": 인프라 보호
+  - "data": 데이터 보호
+  - "incident": 인시던트 대응
+
+#### evaluate_security
+보안 구성을 평가합니다.
+
+**파라미터:**
+- `architecture`: 아키텍처 설명 (필수)
+- `checklist`: 평가 체크리스트 (선택)
+
+### 사용 시점
+- 보안 아키텍처 검토
+- 컴플라이언스 확인
+- 보안 권장사항 도출
+- 취약점 분석
+
+---
+
+## MCP 도구 사용 원칙
+
+1. **정보 수집 우선**: 답변 전 관련 정보를 MCP로 확인
+2. **다중 소스 활용**: 여러 MCP 도구를 조합하여 종합적 분석
+3. **최신 정보 확인**: 캐시된 정보보다 실시간 조회 우선
+4. **근거 명시**: MCP에서 얻은 정보의 출처 명시
+5. **제한사항 인지**: 각 도구의 제한사항 고려
+
+## 일반적인 워크플로우
+
+```
+1. 요구사항 분석
+   ↓
+2. AWS Documentation MCP로 관련 서비스 문서 검색
+   ↓
+3. Pricing MCP로 비용 정보 수집
+   ↓
+4. Well-Architected Security MCP로 보안 검토
+   ↓
+5. Support MCP로 알려진 이슈 확인 (필요시)
+   ↓
+6. 종합 분석 및 권장사항 도출
+```
+
+## 서비스 코드 참조
+
+### 주요 AWS 서비스 코드
+| 서비스 | 코드 |
+|--------|------|
+| Amazon EC2 | AmazonEC2 |
+| Amazon S3 | AmazonS3 |
+| Amazon RDS | AmazonRDS |
+| AWS Lambda | AWSLambda |
+| Amazon DynamoDB | AmazonDynamoDB |
+| Amazon CloudFront | AmazonCloudFront |
+| Amazon EKS | AmazonEKS |
+| Amazon ECS | AmazonECS |
+| Amazon VPC | AmazonVPC |
+| AWS Fargate | AWSFargate |