#+title:      OpenCode에서 glg-skills 활용 가이드
#+date:       [2025-11-18 Tue 12:10]
#+filetags:   :skills:glg:opencode:
#+identifier: 20251118T121000

* 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 파일을 분석할 때, 에이전트에게 다음과 같이 요청합니다:

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

#+begin_example
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
#+end_example

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

2. **히스토리/History 섹션 우선 확인**
   - TOC 결과 중
     - =* 히스토리=, =* HISTORY=, =* History=, =* 작업 로그=, =* Changelog= 등
     - 버전/변화 기록 섹션을 먼저 열어 요약

3. **관심 섹션만 본문 읽기**
   - 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를 사용할 때의
"최소한의 기억 장치" 역할을 합니다.