OpenCode에서 glg-skills 활용 가이드

OpenCode에서 glg-skills 활용 가이드

OpenCode에서 glg-skills 활용 가이드 WORKLOG

이 문서는 Claude-Code가 아닌 **OpenCode 환경**(현재 이 에이전트)에서 `glg-skills`(orgmode-skills)와 Anthropic document-skills를 어떻게 같이 활용할지에 대한 최소 지침입니다.

1. 리포 위치와 역할

glg-skills (개인 스킬 세트)
- 경로: /home/goqual/repos/gh/orgmode-skills
- 핵심:
  - 루트 SKILL.md: denote-org 스킬 정의
  - scripts/org_headings_toc.py: org 헤딩 TOC 추출 스크립트
  - docs/20251118T120000--claude-skills-등록-관리-가이드__skills_claude.org: Claude용 가이드
Anthropic skills (document-skills 포함)
- 경로: /home/goqual/repos/3rd/skills
- 이 리포 안의 document-skills/ 는 PDF/XLSX/DOCX/PPTX 작업 참고용
- OpenCode에서는 여기 스크립트/문서를 **직접 호출/참조**하는 방식으로 사용

OpenCode에서는 `/plugin` 시스템이 없으므로, 이 두 리포는 "스킬 레퍼런스 + 스크립트 모음" 으로 취급합니다.

2. OpenCode에서 org 헤딩 구조 활용

org 파일을 분석할 때, 에이전트에게 다음과 같이 요청합니다:

헤딩 구조 먼저
- scripts/org_headings_toc.py 를 사용해 TOC 생성
- 예시 (에이전트가 내부적으로 실행하는 bash):

python /home/goqual/repos/gh/orgmode-skills/scripts/org_headings_toc.py \
  /home/goqual/repos/gh/orgmode-skills/docs/20251021T113500--denote-org-skills-프로젝트-시작-배경-및-작업-로그__project_skills_denote_anthropic_worklog.org

출력 형식: LEVEL<TAB>TITLE
- 예: 1\tDenote-Org Skills 프로젝트 시작, 2\t히스토리 …

히스토리/History 섹션 우선 확인
- TOC 결과 중
  - * 히스토리, * HISTORY, * History, * 작업 로그, * Changelog 등
  - 버전/변화 기록 섹션을 먼저 열어 요약
관심 섹션만 본문 읽기
- TOC를 기반으로 실제로 필요한 헤딩만 OpenCode에서 `read` 도구로 읽게 함
- 전 파일 grep은 보조 수단으로만 사용

이 전략은 glg-skills의 SKILL.md 에 이미 문서화되어 있으며, OpenCode에서는 이 문서를 **행동 기준**으로 삼습니다.

3. Silo 인식과 경로 규칙 (OpenCode 관점)

OpenCode에서 org 파일을 다룰 때, 아래 경로를 Denote/org silo 로 취급합니다:

~/org/**
~/org/meta/**
~/org/bib/**
~/org/notes/**
~/org/llmlog/**
~/claude-memory/**
~/repos/gh/*/docs/**
~/repos/work/*/docs/**

특히:

~/org/meta: 메타 모델/설계
~/org/bib: 참고문헌/레퍼런스
~/org/notes: 장문의 생각/노트
~/org/llmlog: LLM 대화 로그
리포의 docs/: 해당 코드/프로젝트에 직접 연결된 문서

OpenCode 에이전트에게 요청할 때, "이 파일/문서는 glg-skills의 silo 규칙을 따라 해석해줘"라고 명시하면, 위 경로 규칙을 기준으로 지식베이스를 바라보도록 유도할 수 있습니다.

4. document-skills와의 연계 (OpenCode)

Anthropic document-skills는 Claude-Code용 skills지만, OpenCode에서는 다음 방식으로 간접 활용할 수 있습니다:

/home/goqual/repos/3rd/skills/document-skills/pdf/SKILL.md
- PDF 처리 절차/모범 사례 참고 (스크립트 이름, 워크플로)
/home/goqual/repos/3rd/skills/document-skills/xlsx/SKILL.md
- Excel 공식/구조 보존 규칙 참고

필요하다면, 여기 나온 Python 스크립트 패턴을 별도 OpenCode 전용 스크립트로 이식해 glg-skills 안에 포함시키고, SKILL.md에 그 사용법을 추가하는 식으로 점진적으로 통합합니다.

5. 요약: OpenCode용 glg-skills 사용 패턴

지식 레퍼런스:
- glg-skills: Denote/org 구조, silo 개념, 헤딩/히스토리 우선 전략
- document-skills: PDF/XLSX 등 문서 작업 절차 참고
실행 도구:
- scripts/org_headings_toc.py: org 헤딩 TOC 추출
- 향후 필요 시 PDF/XLSX용 보조 스크립트 추가 예정
요청 패턴 예시:
- "이 org 문서를 glg-skills 기준으로 읽어줘: 먼저 헤딩 TOC, 그 다음 히스토리, 그 다음 관련 섹션만 자세히"
- "~/org/meta 와 ~/org/notes 도 glg-skills의 silo 규칙대로 참고해서 설계 의도를 함께 봐줘"

이 문서는 OpenCode 환경에서 glg-skills를 사용할 때의 "최소한의 기억 장치" 역할을 합니다.

4.6 KiB Raw Blame History

OpenCode에서 glg-skills 활용 가이드