111 lines
4.6 KiB
Org Mode
111 lines
4.6 KiB
Org Mode
#+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를 사용할 때의
|
|
"최소한의 기억 장치" 역할을 합니다.
|