53f0dc5fa3
- 전문가 7인: rfp-analyst·strategist·tech-advisor(아키텍처 총동원)·writer·visual-designer(선 아이콘 직접제작)·deck-designer·qa - 오케스트레이터: '제안서 작성' 한마디로 전 파이프라인 총지휘 (Phase1~6) - 커맨드 /proposal + 번들 스크립트(inspect_template·build_deck) + 설치/사용 가이드 - marketplace 등록 + plugin.json 동기화 - SI 구축·SM 유지보수 제안 주력 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# proposal-builder 설치 & 사용 가이드
|
|
|
|
## 1. 설치
|
|
|
|
### 마켓플레이스로 설치 (권장)
|
|
```
|
|
/plugin marketplace add <이 저장소 경로 또는 URL>
|
|
/plugin install proposal-builder@ythong-harness
|
|
```
|
|
- 마켓플레이스 이름: `ythong-harness` (저장소 `.claude-plugin/marketplace.json`)
|
|
- 플러그인 이름: `proposal-builder`
|
|
|
|
### 로컬 경로로 설치
|
|
저장소를 클론한 뒤:
|
|
```
|
|
/plugin marketplace add /경로/harness
|
|
/plugin install proposal-builder@ythong-harness
|
|
```
|
|
|
|
설치 후 다음이 등록된다:
|
|
- 스킬: `proposal-builder-orchestrator`
|
|
- 커맨드: `/proposal`
|
|
- 에이전트 7: rfp-analyst · proposal-strategist · proposal-tech-advisor · proposal-writer · proposal-visual-designer · deck-designer · proposal-qa
|
|
|
|
## 2. 사용
|
|
|
|
### 가장 간단한 방법
|
|
```
|
|
제안서를 작성해줘
|
|
```
|
|
또는 슬래시 커맨드:
|
|
```
|
|
/proposal ○○시스템 구축 사업 제안서
|
|
```
|
|
→ 오케스트레이터가 전 전문가를 총지휘해 Phase1~6을 자동 진행한다.
|
|
|
|
### 필요한 입력
|
|
1. **RFP 문서** — 경로 또는 텍스트 (PDF·DOCX·나라장터 공고). HWP/HWPX는 텍스트로 변환해 제공(외부 업로드 안 함).
|
|
2. **PPT 디자인 템플릿** — `.pptx` 파일 (표지·간지·본문 마스터가 든 디자인). 없으면 디자인 시스템 기반 중립 마스터로 생성.
|
|
3. 발주처·사업명.
|
|
|
|
## 3. 사전 요구사항
|
|
|
|
```bash
|
|
pip install python-pptx # PPTX 생성에 필요
|
|
```
|
|
- 미설치 시 deck-designer가 설치를 안내한다.
|
|
- 전부 **로컬/온프레미스 처리** — 외부 API·온라인 디자인 서비스 호출 없음.
|
|
|
|
## 4. 설치 오류 해결
|
|
|
|
| 증상 | 원인 / 해결 |
|
|
|------|------------|
|
|
| `plugin not found` | 마켓플레이스를 먼저 add 했는지 확인(`/plugin marketplace add ...`). 저장소에 `plugins/proposal-builder/`가 커밋됐는지 확인(git 기반 설치 시). |
|
|
| `invalid manifest` | `plugins/proposal-builder/.claude-plugin/plugin.json` 존재·JSON 유효성 확인. 저장소 루트 `.claude-plugin/marketplace.json`의 `plugins[]`에 proposal-builder 등록 확인. |
|
|
| 스킬이 트리거 안 됨 | "제안서 작성"·"RFP 분석" 등 키워드 사용, 또는 `/proposal` 커맨드 사용. |
|
|
| PPTX 생성 실패 | `pip install python-pptx`. 템플릿 PPTX 경로 확인. |
|
|
| HWP RFP 못 읽음 | HWP→텍스트(또는 PDF) 변환 후 제공. |
|
|
|
|
## 5. 산출물
|
|
- 중간물: `_workspace/` (rfp_analysis·rtm·strategy·outline·tech_advisory·content·design_system·assets/icons·visual_concepts·template_spec·proposal_qa)
|
|
- 최종: `proposal.pptx` (+ 본문, 재생성 스크립트 `build_deck.py`)
|