viruagent-cli 0.5.1 → 0.6.1

package/skills/va-shared/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: viruagent
+version: 1.0.0
+description: "viruagent-cli — 블로그/SNS 자동화 에이전트. 플랫폼 라우팅, 글쓰기 규칙, 에러 처리."
+triggers:
+  - viruagent
+  - 블로그
+  - blog
+  - 인스타
+  - instagram
+  - 티스토리
+  - 네이버
+  - 좋아요
+  - 댓글
+  - 팔로우
+metadata:
+  category: "router"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# viruagent — 블로그/SNS 자동화 에이전트
+
+viruagent-cli를 사용하는 블로그/SNS 자동화 에이전트입니다.
+사용자 요청에 따라 적절한 스킬 파일을 읽고 실행합니다.
+
+## Platform Router
+
+| 트리거 | 스킬 파일 |
+|--------|-----------|
+| 티스토리, tistory | `va-tistory/SKILL.md` |
+| 네이버, naver | `va-naver/SKILL.md` |
+| 인스타, instagram, 좋아요, 댓글, 팔로우 | `va-insta/SKILL.md` |
+| 블로그 써줘 (플랫폼 미지정) | 사용자에게 플랫폼 질문 |
+| 블로거 역할 | `persona-blogger/SKILL.md` |
+| 인플루언서 관리 | `persona-influencer-manager/SKILL.md` |
+| SNS 마케팅 | `persona-sns-marketer/SKILL.md` |
+
+## 스킬 파일 위치
+
+모든 하위 스킬은 viruagent-cli 패키지 내 `skills/` 디렉토리에 있습니다:
+
+```
+SKILLS_DIR: <viruagent-cli 설치 경로>/skills/
+```
+
+사용자의 요청을 분석한 뒤, 해당 스킬 파일을 Read 도구로 읽어서 지침을 따르세요.
+
+### 단일 명령 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| va-tistory | `va-tistory/SKILL.md` | Tistory 개요 |
+| va-tistory-login | `va-tistory-login/SKILL.md` | 로그인 (2FA) |
+| va-tistory-publish | `va-tistory-publish/SKILL.md` | 글 발행 |
+| va-tistory-draft | `va-tistory-draft/SKILL.md` | 임시저장 |
+| va-tistory-categories | `va-tistory-categories/SKILL.md` | 카테고리 조회 |
+| va-tistory-posts | `va-tistory-posts/SKILL.md` | 글 목록/읽기 |
+| va-naver | `va-naver/SKILL.md` | Naver 개요 |
+| va-naver-login | `va-naver-login/SKILL.md` | 로그인 (manual) |
+| va-naver-publish | `va-naver-publish/SKILL.md` | 글 발행 |
+| va-naver-draft | `va-naver-draft/SKILL.md` | 임시저장 |
+| va-naver-categories | `va-naver-categories/SKILL.md` | 카테고리 조회 |
+| va-naver-posts | `va-naver-posts/SKILL.md` | 글 목록/읽기 |
+| va-insta | `va-insta/SKILL.md` | Instagram 개요 + 레이트리밋 |
+| va-insta-login | `va-insta-login/SKILL.md` | 로그인 + 챌린지 |
+| va-insta-like | `va-insta-like/SKILL.md` | 좋아요 |
+| va-insta-comment | `va-insta-comment/SKILL.md` | 댓글 |
+| va-insta-follow | `va-insta-follow/SKILL.md` | 팔로우/언팔 |
+| va-insta-dm | `va-insta-dm/SKILL.md` | DM |
+| va-insta-feed | `va-insta-feed/SKILL.md` | 피드/프로필/분석 |
+
+### 페르소나 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| persona-blogger | `persona-blogger/SKILL.md` | 블로거 역할 |
+| persona-influencer-manager | `persona-influencer-manager/SKILL.md` | 인플루언서 매니저 |
+| persona-sns-marketer | `persona-sns-marketer/SKILL.md` | SNS 마케터 |
+
+### 레시피 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| recipe-blog-publish | `recipe-blog-publish/SKILL.md` | 블로그 발행 워크플로우 |
+| recipe-cross-post | `recipe-cross-post/SKILL.md` | 블로그 → 인스타 홍보 |
+| recipe-engage-feed | `recipe-engage-feed/SKILL.md` | 피드 인게이지먼트 |
+| recipe-daily-engagement | `recipe-daily-engagement/SKILL.md` | 일일 루틴 |
+| recipe-grow-followers | `recipe-grow-followers/SKILL.md` | 팔로워 성장 |
+
+## Quick Reference
+
+```bash
+npx viruagent-cli list-providers
+npx viruagent-cli --spec
+npx viruagent-cli --spec <command>
+```
+
+모든 응답은 JSON: `{ "ok": true, "data": {...} }` 성공, `{ "ok": false, "error": "...", "message": "...", "hint": "..." }` 실패.
+
+## 글쓰기 규칙 (블로그 공통)
+
+### 포맷 선택 (글 성격에 따라 결정)
+| 포맷 | 용도 | 체류시간 | AI탐지 위험 |
+|------|------|---------|-----------|
+| **story** | 경험 후기, 사례, 인사이트 | 최고 | 낮음 |
+| **howto** | 설치법, 단계별 가이드 | 높음 | 중간 |
+| **list** | 추천 목록, 비교 정리 | 낮음 | 높음 |
+| **review** | 심층 분석, 솔직 리뷰 | 높음 | 낮음 |
+| **qa** | 개념 설명, FAQ | 중간 | 중간 |
+
+**기본 추천: story형** — 체류시간 최고, AI 탐지 회피 최적.
+
+### 제목
+- **네이버**: 15~25자, 핵심 키워드 앞배치
+- **티스토리**: 25~35자, 숫자/연도 포함 시 CTR +23%
+- 키워드는 제목 앞쪽에 — 뒤에 오면 검색 가중치 낮음
+
+### 분량
+- **네이버**: 1,500~2,500자 (경쟁 키워드 2,500~3,500자)
+- **티스토리**: 3,000~5,000자 (구글 상위 10위 평균 5,000자)
+
+### 서론 (첫 3문장이 체류시간 결정)
+- **공감형**: 독자 상황 공감 → 반전 → 이 글의 약속
+- **손실 회피형**: 모르면 손해 + 수치 → 해결책 예고
+- **질문형**: 검색 쿼리 그대로 → 데이터 → 내용 예고
+- 도입부에 `<blockquote>`로 임팩트 한 줄 배치
+
+### 본문 구조
+- **단락**: 모바일 기준 2~3문장 (최대 4문장). 공백 줄로 호흡 조절
+- **소제목 간격**: 네이버 300~400자마다 `<h2>`, 티스토리 600~1,000자마다 `<h3>`
+- **티스토리 H태그**: `<h2>` → `<h3>` → `<h4>` 계층 준수. 본문에 `<h1>` 사용 금지
+- **네이버**: `<h2>`만 사용 (h3 불필요)
+- **목차**: 티스토리는 3개 이상 섹션이면 앵커 링크 목차 필수
+- **문장 리듬**: 짧은 문장과 긴 문장을 의도적으로 섞기 (균일하면 AI 탐지)
+
+### 이미지
+- **네이버**: 소제목마다 1장, 총 5~10장 권장
+- **티스토리**: 1~3장 + alt 태그 `핵심키워드 + 설명` 형식 필수
+- 이미지는 설명 단락 **위**에 배치 — 시각 → 텍스트 순서
+
+### AI 탐지 회피 필수 규칙
+- 직접 경험 기반 문장 단락마다 1개 이상
+- "~에 대해 알아보겠습니다", "정리하자면", "마무리로" 금지
+- 균일한 3단락 공식(도입→근거→요약) 반복 금지
+- 모든 섹션을 같은 길이로 쓰지 말 것
+
+### 공통
+- **강조**: `<strong>`으로 핵심 용어 (섹션당 2~3개 max)
+- **근거**: 섹션마다 데이터, 수치, 실제 사례 중 하나 포함
+- **내부 링크**: 티스토리는 관련 글 2~4개 연결 (체류시간 35% 연장)
+- **마무리**: 구체적 행동 제안 + 댓글/공유 유도
+- **태그**: 정확히 5개, 쉼표 구분, 글 언어와 일치
+- **SEO**: 제목, 첫 단락, 소제목 최소 1곳에 핵심 키워드 배치
+
+## 공통 에러 처리
+
+| 에러 | 조치 |
+|------|------|
+| `NOT_LOGGED_IN` / `SESSION_EXPIRED` | `login` 재실행 |
+| `MISSING_CONTENT` | `--content` 또는 `--content-file` 확인 |
+| `PROVIDER_NOT_FOUND` | `list-providers`로 확인 |
+| `INVALID_POST_ID` | `list-posts`로 ID 확인 |
+
+## 중요 사항
+
+- 실제 발행 전 `--dry-run`으로 파라미터 검증
+- 콘텐츠는 유효한 HTML이어야 함
+- 기본 프로바이더는 `tistory`
+- `--content-file`은 절대 경로 사용

package/skills/va-tistory/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: va-tistory
+version: 1.0.0
+description: "Tistory 블로그: 명령 개요 및 플랫폼 특화 규칙"
+metadata:
+  category: "overview"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# va-tistory — Tistory 블로그 개요
+
+Tistory 블로그 퍼블리싱을 위한 viruagent-cli 가이드. 항상 `--provider tistory` 사용.
+
+## 명령 목록
+
+| 명령 | 스킬 | 설명 |
+|------|------|------|
+| login | va-tistory-login | 카카오 로그인 (2FA 포함) |
+| publish | va-tistory-publish | 글 발행 |
+| save-draft | va-tistory-draft | 임시저장 |
+| list-categories | va-tistory-categories | 카테고리 조회 |
+| list-posts, read-post | va-tistory-posts | 글 목록/읽기 |
+
+## Tistory HTML 규칙
+
+Tistory는 `data-ke-*` 속성을 사용합니다:
+- 본문: `<p data-ke-size="size18">`
+- 여백: `<p data-ke-size="size16">&nbsp;</p>`
+- 인용: `<blockquote data-ke-style="style2">`
+
+## 환경변수
+
+```
+TISTORY_USERNAME=
+TISTORY_PASSWORD=
+```
+
+## See Also
+
+va-shared, va-tistory-login, va-tistory-publish, va-tistory-draft, va-tistory-categories, va-tistory-posts

package/skills/va-tistory-categories/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: va-tistory-categories
+version: 1.0.0
+description: "Tistory: 블로그 카테고리 목록 조회"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli list-categories --help"
+---
+
+# va-tistory-categories — 카테고리 조회
+
+## 사용법
+
+```bash
+npx viruagent-cli list-categories --provider tistory
+```
+
+카테고리가 지정되지 않은 경우, 사용자에게 어떤 카테고리를 사용할지 질문.
+
+## 응답 예시
+
+```json
+{
+  "ok": true,
+  "data": [
+    { "id": "123", "name": "개발" },
+    { "id": "456", "name": "일상" }
+  ]
+}
+```
+
+## See Also
+
+va-tistory, va-tistory-publish

package/skills/va-tistory-draft/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: va-tistory-draft
+version: 1.0.0
+description: "Tistory: 블로그 글 임시저장"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli save-draft --help"
+---
+
+# va-tistory-draft — Tistory 임시저장
+
+## 사용법
+
+```bash
+npx viruagent-cli save-draft \
+  --provider tistory \
+  --title "Draft Title" \
+  --content "<h2>...</h2><p>...</p>" \
+  --category <id> \
+  --tags "tag1,tag2,tag3,tag4,tag5" \
+  --related-image-keywords "keyword1,keyword2"
+```
+
+`publish` 대신 `save-draft` 사용. 옵션은 동일.
+
+## See Also
+
+va-tistory-publish, va-tistory, va-shared

package/skills/va-tistory-login/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: va-tistory-login
+version: 1.0.0
+description: "Tistory: 카카오 계정으로 로그인 (2FA 지원)"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli login --help"
+---
+
+# va-tistory-login — Tistory 로그인
+
+## 인증 상태 확인
+
+```bash
+npx viruagent-cli status --provider tistory
+```
+
+## 로그인
+
+```bash
+npx viruagent-cli login --provider tistory --username <kakao_id> --password <pass> --headless
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--username` | 카카오 아이디 | - |
+| `--password` | 카카오 비밀번호 | - |
+| `--headless` | 헤드리스 브라우저 모드 | false |
+| `--two-factor-code` | 2FA 인증 코드 | - |
+
+### 2FA 처리
+
+로그인 결과가 `pending_2fa`인 경우:
+1. 사용자에게 카카오 앱에서 인증 승인 요청
+2. 승인 후 `status` 재확인
+
+### 환경변수
+
+`TISTORY_USERNAME` / `TISTORY_PASSWORD` 설정 시 자동 사용.
+
+## 로그아웃
+
+```bash
+npx viruagent-cli logout --provider tistory
+```
+
+## See Also
+
+va-tistory, va-shared

package/skills/va-tistory-posts/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: va-tistory-posts
+version: 1.0.0
+description: "Tistory: 글 목록 조회 및 개별 글 읽기"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli list-posts --help"
+---
+
+# va-tistory-posts — 글 목록 & 읽기
+
+## 글 목록
+
+```bash
+npx viruagent-cli list-posts --provider tistory --limit 10
+```
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--limit` | 조회할 글 수 | 20 |
+
+## 글 읽기
+
+```bash
+npx viruagent-cli read-post --provider tistory --post-id <id>
+```
+
+| 플래그 | 설명 |
+|--------|------|
+| `--post-id` | 글 ID |
+| `--include-draft` | 임시저장 포함 |
+
+## See Also
+
+va-tistory, va-shared