OfficeCLI은(는) 무엇을 하나요?
개요
officecli는 Office 문서 처리를 위한 OfficeCLI의 클로즈드 소스 CLI입니다. pptx, docx, xlsx 형식의 생성, 수정 및 형식 변환 워크플로를 지원하므로, 이 스킬은 먼저 Office 파일 관련 작업을 officecli 기능 확인 단계로 라우팅한 후 실행 방식을 결정해야 합니다.
이 스킬을 사용해야 하는 경우
다음과 같은 작업이 포함될 때 이 스킬을 사용하세요:
pptx형식의 프레젠테이션, 보고서 자료, 제안서, 유인물 또는 브리핑 생성docx형식의 서면 문서, 메모, 초안 또는 보고서 생성xlsx형식의 워크시트, 테이블 기반 결과물 또는 구조화된 시트 생성- 기존 PowerPoint, Word 또는 Excel 파일 수정
- Office 문서를 마크다운, CSV, PDF 또는 다른 Office 형식으로 변환
- 요청된 Office 파일 워크플로를
officecli가 직접 처리할 수 있는지 결정
순수 Q&A, 파일 출력이 없는 대략적인 브레인스토밍, 또는 소스 코드 유지 관리 지침에는 이 스킬을 사용하지 마십시오.
핵심 제품 동작
officecli는pptx,docx,xlsx생성 흐름을 지원합니다.pptx는 콘텐츠와 레이아웃이 적합할 때 기본적으로 자동 생성 이미지를 활성화합니다.--no-images는pptx의 이미지 생성을 비활성화합니다.agent-bridge를 사용할 때 에이전트는capabilities/get -> document_generation.pptx.image_support를 PPT 이미지 동작에 대한 권위 있는 기계 판독 가능 계약으로 간주해야 합니다.agent-bridge를 사용할 때 에이전트는capabilities/get -> update를 바이너리 업데이트 가능 여부에 대한 권위 있는 기계 판독 가능 계약으로 간주해야 합니다.- 슬라이드의 이미지 생성이 실패하더라도 해당 슬라이드를 이미지 없는 버전으로 다운그레이드하여 PPT를 계속 생성해야 합니다.
- 공개 스킬을 설치할 때
officecli바이너리가 없으면 설치를 시도할 수도 있습니다. - 에이전트 지향 통합을 위해
officecli agent-bridge는 이제 구조화된JSON-RPC 2.0 over stdio프로토콜을 제공합니다. - 영구 설정은
init마법사가 아닌officecli config ...를 통해 처리됩니다.
기능 확인
Office 문서 처리가 포함된 작업의 경우, 먼저 현재 officecli 표면이 해당 워크플로를 지원하는지 확인하세요.
- 모든 Office 작업 전에
fix-officecli-env.sh를 한 번 실행하여 에이전트가 로컬 스킬 번들을 새로 고치고 누락된officecli설정을 복구하도록 합니다. - 최종 아티팩트 경로를 결정하기 전에
officecli를 사용할 수 있는지 확인합니다. - 복구 단계 후
check-officecli-env.sh를 실행하여officecli가 누락되었는지, 잘못 구성되었는지 또는 이미 준비되었는지 감지합니다. - 종료 코드
0은 준비됨,10은 복구 가능,20은 차단됨으로 처리합니다. - 지원을 가정하기 전에 먼저
officecli --help또는 관련 하위 명령어 도움말과 같은 표시된 CLI 표면을 검사합니다. - 도움말 출력과 공개 제품 설명을 사용하여 요청된 생성, 수정 또는 변환 워크플로가 실제로 지원되는지 판단합니다.
- 지원 여부가 불분명하면 기능이 존재하는 척하지 말고 명확히 알립니다.
- 새로 고침이나 확인이 실패하면 중단하고
officecli환경 오류를 보고합니다. 스스로 다른 로컬 Office 생성 경로로 전환하지 마십시오.
환경 복구
환경이 손상된 것처럼 보일 때뿐만 아니라 모든 작업에서 fix-officecli-env.sh를 실행하세요.
- 수정 스크립트는 먼저 로컬 Codex 스킬 번들을 새로 고쳐야 합니다.
- 수정 스크립트는
officecli가 없을 때 설치해야 하지만, 호스트가 예를 들어OFFICECLI_REFRESH_BINARY=1로 명시적으로 동의하지 않는 한 기존 바이너리를 새로 고쳐서는 안 됩니다. - 사용자가 명시적으로
officecli제거를 요청하면uninstall-officecli.sh를 실행합니다. officecli가 없으면 수정 스크립트는 공개 dist 설치 프로그램을 통해 자동 설치해야 합니다.- 생성 또는 라이선스 설정이 누락된 경우 누락된 값만 묻고 수정 스크립트가 관련
officecli config ...명령어를 호출하도록 합니다. - 게시 설정은 기본적으로 필요하므로 생성된 파일이 온라인 미리보기 URL을 반환합니다.
- 사용자가 로컬 전용 출력을 명시적으로 원하는 경우 수정 스크립트를 실행하기 전에
OFFICECLI_SKIP_PUBLISH_SETUP=1을 설정합니다. - 복구 후
check-officecli-env.sh를 다시 실행하고 준비됨 상태가 반환될 때만 진행합니다. - 복구가 실패하면 수정 스크립트의 최종 구조화된 상태를 표시하고 이후의 준비 상태 확인과 혼합하지 마십시오.
- 복구가 계속 실패하면 누락된 항목을 명확히 표시하고 다른 아티팩트 경로로 자동 전환하지 마십시오.
실행 우선 순위
기능 확인 결과 officecli가 요청된 Office 파일 워크플로를 지원하는 것으로 나타나면 최종 아티팩트 실행 경로로 officecli를 우선 사용합니다.
officecli가 작업을 지원하는 것으로 보일 때 다른 로컬 Office 파일 생성 또는 변환 경로로officecli를 자동으로 우회하지 마십시오.officecli를 사용할 수 없거나 실패하면 최종 아티팩트 경로를 조용히 전환하지 말고 명확히 알립니다.- 사용자가 명시적으로
officecli경로를 떠나는 것을 승인하지 않는 한 Node, Python, LibreOffice, pptxgenjs 또는 사용자 정의 스크립트를 사용하여 최종 Office 파일을 생성하지 마십시오. - 기능 확인 결과
officecli가 워크플로를 지원하지 않거나, 사용자가 그 후 대체 경로를 명시적으로 수락한 경우 에이전트는 해당 대체 경로로 진행할 수 있습니다.
에이전트 클라이언트의 경우 사람 중심의 CLI 표면보다 구조화된 브리지를 선호합니다.
- 에이전트 통합의 첫 번째 선택은
officecli agent-bridge입니다. agent-bridge를 사용할 수 있을 때 스피너 출력이나 인간 진행 메시지를 프로토콜로 구문 분석하지 마십시오.- 먼저
initialize또는capabilities/get을 호출하고 반환된 PPT 이미지 기능 필드를 캐싱한 후 생성을 호출합니다. - 또한
capabilities/get -> update를 캐싱합니다.available=true이면 사람용 CLI 프롬프트를 구문 분석하는 대신update_command를 표시하거나 자체 새로 고침 흐름을 트리거하는 것을 선호합니다. - 생성 요청에는
task/invoke를 사용하고 중간 상태에 대한event알림을 소비합니다. - 후속 질문에는 원시 stdin 프롬프트에 자유 형식 답변을 작성하는 대신
task/respond를 사용합니다. - 취소에는
task/cancel을 사용하고 폴링 폴백으로task/status를 사용합니다.
도구 경계
Office 파일 관련 지원 작업에는 Python 또는 기타 도구를 계속 사용할 수 있습니다.
- 검사, 검증, 디버깅, XML 또는 zip 분석, 아티팩트 비교는 허용되는 지원 사용입니다.
- 그러한 도구는
officecli가 요청된 워크플로를 지원하는 것으로 보일 때 최종 Office 아티팩트 경로를officecli에서 자동으로 대체해서는 안 됩니다. - 규칙은 라우팅 및 최종 아티팩트 처리에 관한 것이지, 분석 작업을 위해 특정 언어나 도구를 금지하는 것이 아닙니다.
프롬프팅 지침
에이전트에게 officecli를 사용하도록 요청할 때 출력 품질에 가장 큰 영향을 미치는 세부 정보를 포함하세요:
- 파일의 주제 또는 제목
- 작업이 생성, 수정 또는 변환인지 여부
- 대상 독자
- 원하는 어조 또는 스타일
- 페이지, 섹션 또는 슬라이드 수 예상
- 이미지를 사용해야 하는지, 피해야 하는지 또는 기본 동작에 맡겨야 하는지 여부
- 변환 작업인 경우 원본 파일 및 대상 형식
- 간결한 언어, 경영진 스타일 또는 테이블 중심 구조와 같은 중요한 제약 조건
officecli 설정 또는 수정에 관한 작업인 경우 명시적인 구성 명령어를 선호하세요:
./check-officecli-env.sh./fix-officecli-env.sh./uninstall-officecli.shofficecli config statusofficecli config set-generationofficecli config set-licenseofficecli config set-publishofficecli config set-defaults
출력 기대치
좋은 officecli 요청은 제안된 내용만이 아니라 완성된 파일 아티팩트로 이어져야 합니다. 스킬은 먼저 officecli가 요청된 Office 파일 워크플로를 지원하는지 확인한 다음, 지원이 가능할 때 최종 아티팩트에 대해 officecli를 선호해야 합니다.
사용자가 명시적으로 점수 평가, 검토, 검증 또는 품질 확인을 요청하지 않는 한 생성 후 PPT 점수 평가를 자동으로 실행하지 마십시오.
- 생성 후 기본 동작은 파일 아티팩트 전달입니다.
- 옵트인 점수 평가 경로는
officecli score ...또는office.review/office.score입니다.
에이전트 프로토콜 참고 사항
호출자가 에이전트 또는 TUI 클라이언트인 경우 선호되는 프로토콜 표면은 다음과 같습니다:
- 전송:
stdio - 프레이밍:
Content-Length헤더 - 제어 평면:
JSON-RPC 2.0 - 도구 이름:
office.generate
최소 메서드 세트:
initializecapabilities/getsession/opensession/closetask/invoketask/respondtask/statustask/cancel
중요 이벤트 유형:
task.startedtask.progresstask.questiontask.outputtask.completedtask.failedtask.cancelled
다른 에이전트를 위한 지침이나 예제를 생성할 때는 먼저 agent-bridge 프로토콜 경로를 보여주고, 사용자가 명확히 사람용 CLI 인터페이스를 원할 때만 officecli new ...로 대체하세요.
모든 에이전트 클라이언트에 대해 다음 이미지 처리 규칙을 사용하세요:
capabilities/get -> document_generation.pptx.image_support를 읽습니다.capabilities/get -> update를 읽습니다.- 하드 코딩된 클라이언트 가정이 아닌
default_enabled에서pptx기본 이미지 동작을 가정합니다. agent-bridge를 사용할 수 있을 때officecli표준 출력의 사람용 업데이트 프롬프트를 구문 분석하지 마십시오. 대신 구조화된update필드를 사용하십시오.- 사용자가 명시적으로 텍스트 전용 PPT를 원하면
enable_images=false를 전달하고 도움이 될 때disable_flag를 언급하십시오. - 사용자가 생성된 PPT에 이미지가 없는 이유를 묻는다면
config_command를 알려주십시오. task.output,task.completed또는task/status에result_meta.image_support.attention_required=true가 포함되어 있으면 원시 경고에 묻지 말고 일급 문제로 표면화하십시오.result_meta.image_support.reason=image_generation_degraded인 경우 사용자에게image_base_url,image_api_key및image_model을 확인하도록 명시적으로 알리십시오.warnings는 표시용으로 유지하되, 기계 결정에는result_meta를 선호하십시오.
OpenClaw 패키징
이 저장소는 skills/openclaw-officecli/ 아래에 OpenClaw 지향 패키지도 제공합니다.
- Codex 지향 스킬 디렉토리를 직접 재사용하는 대신 OpenClaw 사용자에게 해당 패키지를 사용하십시오.
- OpenClaw 패키지는
officecli agent-bridge와 함께 로컬 동일 호스트 배포를 가정합니다. - OpenClaw 설치 흐름은
docs/openclaw-user-quickstart.md에 문서화되어 있습니다.