c6949ffd38
- 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>
74 lines
3.3 KiB
Markdown
74 lines
3.3 KiB
Markdown
# zioinfo 설치 & 사용 가이드 (v2.0.0 통합판)
|
|
|
|
## 설치 (2단계)
|
|
|
|
```
|
|
/plugin install zioinfo@ythong
|
|
/reload-plugins
|
|
```
|
|
|
|
설치되는 것:
|
|
- 플러그인: `zioinfo` (ZIO INFOTECH Suite) — 구 harness·zio-harness·proposal-builder·zioinfo 4개 통합
|
|
- 스킬 5종: `zio-harness`(풀스택 개발) · `harness`(하네스 팩토리) · `proposal-builder-orchestrator` · `pm-pmo-orchestrator` · `hermes-delivery`(전령 절차)
|
|
- 커맨드 3종: `/zioinfo:pmo` · `/zioinfo:proposal` · `/zioinfo:wiki`(LLM wiki)
|
|
- 에이전트 16종: **hermes**(전령 — memory·skill·cron·External APIs 4대 특징) + proposal 7 + pm·pmo 8
|
|
- (선택) userConfig `notify_webhook_url` — enable 시 입력하면 hermes가 전달 완료 알림 POST
|
|
- 훅: SessionStart → graphify 지식그래프 자동 구축/갱신
|
|
- 테마: ZIO WISE (`/theme`에서 선택, experimental)
|
|
- 지식베이스: `knowledge/kintex/` · `knowledge/guardia/`
|
|
|
|
## 구버전에서 이관
|
|
|
|
구 4개 플러그인을 개별 설치한 경우 제거 후 통합판 하나만 설치한다:
|
|
|
|
```
|
|
claude plugin uninstall harness@ythong
|
|
claude plugin uninstall zio-harness@ythong
|
|
claude plugin uninstall proposal-builder@ythong
|
|
claude plugin uninstall zioinfo@ythong # 구 1.x
|
|
claude plugin install zioinfo@ythong # v2.0.0
|
|
```
|
|
|
|
## 마켓플레이스가 등록되지 않은 경우
|
|
|
|
```
|
|
/plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git
|
|
/plugin install zioinfo@ythong
|
|
/reload-plugins
|
|
```
|
|
|
|
로컬 개발 환경(이 저장소가 있는 PC)에서는 디렉터리 마켓플레이스로 등록해도 된다:
|
|
|
|
```
|
|
/plugin marketplace add C:\GUARDiA\workspace\harness
|
|
```
|
|
|
|
## 확인
|
|
|
|
```
|
|
claude plugin list # 설치 목록
|
|
claude plugin details zioinfo@ythong # 컴포넌트 인벤토리 (스킬 4·커맨드 3·에이전트 15·훅·테마)
|
|
```
|
|
|
|
## 사용
|
|
|
|
```
|
|
사용자 로그인 기능 추가해줘 # zio-harness 6인 파이프라인 (hermes 전령 포함)
|
|
이번 변경 push하고 배포 확인해줘 # hermes Deploy 트랙
|
|
하네스 구성해줘: <도메인 설명> # harness 메타 스킬
|
|
/zioinfo:proposal RFP와 템플릿으로 제안서 작성
|
|
/zioinfo:pmo 이번 주 주간보고
|
|
/zioinfo:wiki # 코드베이스 LLM wiki 생성 (graphify-out/wiki/)
|
|
```
|
|
|
|
## 트러블슈팅
|
|
|
|
| 증상 | 조치 |
|
|
|------|------|
|
|
| `plugin not found` | 마켓플레이스를 먼저 add 했는지 확인(`/plugin marketplace add ...`). 저장소에 `plugins/zioinfo/`가 커밋됐는지 확인(git 기반 설치 시). |
|
|
| `invalid manifest` | `plugins/zioinfo/.claude-plugin/plugin.json` JSON 유효성 확인. 루트 `.claude-plugin/marketplace.json`의 `plugins[]`에 zioinfo만 등록돼 있는지 확인. |
|
|
| 설치 후 커맨드 안 보임 | `/reload-plugins` 실행 또는 세션 재시작. 커맨드는 `/zioinfo:pmo`처럼 네임스페이스가 붙는다. |
|
|
| 구 플러그인과 스킬 중복 | 구 harness·zio-harness·proposal-builder를 uninstall — 동일 스킬이 두 곳에서 로드되면 트리거가 불안정해진다. |
|
|
| graphify 훅이 안 돎 | Python·pip 설치 확인. 끄려면 환경변수 `ZIO_HARNESS_NO_GRAPHIFY=1`. |
|
|
| 테마 안 보임 | 테마는 experimental 컴포넌트 — Claude Code 최신 버전 확인 후 `/theme`에서 "ZIO WISE" 선택. |
|