harness/docs/plugins.md
DESKTOP-TKLFCPR\ython c6949ffd38 feat(zioinfo): v2.1.0 — hermes 4대 특징 탑재 (memory·skill·cron·External APIs)
- agents/hermes.md 번들 신설: memory: user(채널 레지스트리·전달 이력·학습 패턴)
  + skills:[hermes-delivery] 사전 로드 (Nous Hermes Agent 특징 이식)
- skills/hermes-delivery/SKILL.md 신설: 전달 파이프라인·cron(CronCreate·/schedule)
  ·External APIs(Gitea REST·notify_webhook_url)·자가 스킬화(Observe→Plan→Act→Learn)
- plugin.json: v2.1.0 + userConfig.notify_webhook_url(선택)
- zio-harness 스폰 zioinfo:hermes 전환(폴백 general-purpose), references 4대 특징 표
- docs/README/INSTALL/CLAUDE.md/PROJECT_MAP/CHANGELOG 동기화

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 20:25:15 +09:00

106 lines
4.2 KiB
Markdown

# ythong 마켓플레이스 — 플러그인 카탈로그
이 저장소(`ythong` 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법.
> 마켓플레이스 매니페스트: [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json)
> 최종 업데이트: 2026-07-21 (4개 플러그인 → zioinfo v2.0.0 단일 통합)
---
## 플러그인 목록
| 플러그인 | 버전 | 설명 |
|----------|------|------|
| **zioinfo** (ZIO INFOTECH Suite) | 2.1.0 | 구 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo) 단일 통합판. ①풀스택 개발 6인 팀 — **hermes(전령) 번들 에이전트: Hermes Agent 4대 특징(memory·skill 자가 축적·cron·External APIs) 탑재** ②하네스 팩토리 메타 스킬 ③제안서 자동완성 7인 팀(`/zioinfo:proposal`) ④PM·PMO 8인 팀(`/zioinfo:pmo`) + graphify 지식그래프 SessionStart 훅·**LLM wiki**(`/zioinfo:wiki`)·ZIO WISE 테마·KINTEX/GUARDiA 지식베이스. |
구 harness(1.3.1)·zio-harness(1.3.0)·proposal-builder(1.0.0)·zioinfo(1.1.0)는 2026-07-21 zioinfo v2.0.0으로 통합되어 개별 배포가 종료됐다.
---
## 설치 (검증된 명령)
### 1. 마켓플레이스 등록
```bash
# 로컬 디렉토리에서
claude plugin marketplace add /경로/harness
# 또는 Git 원격에서
claude plugin marketplace add <git-url>
```
`Successfully added marketplace: ythong`
### 2. 플러그인 설치
```bash
claude plugin install zioinfo@ythong
```
`Successfully installed plugin: zioinfo@ythong`
구버전 4개를 개별 설치했던 환경은 먼저 제거한다:
```bash
claude plugin uninstall harness@ythong
claude plugin uninstall zio-harness@ythong
claude plugin uninstall proposal-builder@ythong
```
### 3. 설치·로드 검증
```bash
claude plugin list # 설치 목록·enabled 상태
claude plugin details zioinfo@ythong # 컴포넌트 인벤토리·토큰 비용
```
기대 인벤토리: Skills 5(zio-harness·harness·proposal-builder-orchestrator·pm-pmo-orchestrator·hermes-delivery) ·
Commands 3(pmo·proposal·wiki) · Agents 16(hermes 포함) · Hooks 1(SessionStart graphify) · Themes 1(ZIO WISE)
> Agent Teams 기능을 쓰는 하네스는 `export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이 필요하다. 상세: [`experimental-dependency.md`](./experimental-dependency.md).
---
## 트랙별 사용
### 풀스택 개발 (구 zio-harness)
```
사용자 로그인 기능 추가해줘 (React 화면 + API + 모바일) # 6인 파이프라인
이번 변경 Gitea에 push하고 배포 확인해줘 # hermes(전령) Deploy 트랙
```
### 하네스 팩토리 (구 harness)
```
하네스 구성해줘: <도메인 한 문장>
```
### 제안서 자동완성 (구 proposal-builder)
```
/zioinfo:proposal ○○시스템 구축 사업 제안서
```
**입력**: ① RFP 문서(PDF·DOCX·나라장터 공고; HWP는 텍스트 변환) ② PPT 디자인 템플릿(.pptx) ③ 발주처·사업명
**사전 요구사항**: `pip install python-pptx`
### PM·PMO
```
/zioinfo:pmo 이번 주 주간보고 만들어줘
/zioinfo:pmo 종료 감리 준비 (모의감리 포함)
```
### LLM wiki (신규, v2.0.0)
```
/zioinfo:wiki [경로] # graphify 지식그래프 → graphify-out/wiki/ 커뮤니티별 아티클
```
**상세 가이드**: [`plugins/zioinfo/docs/INSTALL.md`](../plugins/zioinfo/docs/INSTALL.md)
전 과정 온프레미스(외부 API·온라인 디자인 서비스 호출 없음). 선 아이콘은 외부 라이브러리 금지·직접 SVG 제작.
---
## 제거
```bash
claude plugin uninstall zioinfo@ythong
```
## 설치 오류 대응
| 증상 | 해결 |
|------|------|
| `plugin not found` | 마켓플레이스를 먼저 `add` 했는지 확인. Git 설치 시 `plugins/zioinfo/`가 커밋됐는지 확인. |
| `invalid manifest` | `plugins/zioinfo/.claude-plugin/plugin.json` 존재·JSON 유효성, 루트 `marketplace.json``plugins[]` 등록 확인. BOM 없는 UTF-8인지 확인. |
| 컴포넌트 로드 누락 | `claude plugin details zioinfo@ythong`로 인벤토리 점검(에이전트 frontmatter `name`/`description` 필수). |
| 구 플러그인과 충돌 | 구 4개 플러그인을 uninstall — 동일 스킬 중복 로드 시 트리거 불안정. |