OpenCode
OpenCode(베타)를 위한 Apothem 하니스 어댑터.
벤더: OpenCode
설치 이름: opencode
상태: 베타
네이티브 구성: ~/.config/opencode/
설치
apothem install --harness opencode어댑터는 OpenCode의 JSON 구성을 작성하고, Apothem 스킬을 OpenCode 스킬 표면에 설치하며, 커맨드 프롬프트를 OpenCode Markdown 커맨드 파일로 변환하고, Apothem 도우미 정의를 OpenCode 하위 도우미로 정규화합니다.
작성되는 파일:
~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/프로필에서 네이티브 구성으로의 매핑
어댑터는 여러분의 프로필 문서, 네 개의 핵심 규칙, 그리고 규칙 색인을 명시하는
instructions 파일 목록과 함께 opencode.json을 렌더링한 다음, 공유된 각
Apothem 코호트를 OpenCode 네이티브 표면 또는 Apothem 소유 지원 하위 트리로
전파합니다. 일치하는 기존 Apothem 관리 하위 항목은 교체 전에 백업됩니다.
호환성 참고 사항
OpenCode는 instructions 목록이 명시하는 모든 파일을 모든 세션에 결합합니다
(OpenCode 규칙). 따라서 이 목록은 여러분의
프로필 문서를 먼저 명시하고, 그다음 alwaysApply가 true인 규칙만 규칙마다
하나의 명시적 ~/.config/opencode/.apothem/support/rules/<name>.md 경로로
명시합니다. OpenCode는 앞에 오는 ~/를 여러분의 홈 디렉터리 기준으로
확장합니다. 그 규칙들은 agnostic-posture, authority-inquiry,
context-management, session-closure, 그리고 규칙 색인
apothem-rule-index입니다. OpenCode는 어떤 규칙도 경로로 범위를 지정하지
않으므로, 다른 모든 규칙은 필요할 때 읽힙니다. 이 규칙들은
~/.config/opencode/.apothem/support/ 아래에 참조 자료로 설치된 채 남으며, 색인은
각 규칙과 그 규칙이 필요한 상황을 명시합니다. 규칙, 템플릿, 또는 훅 프롬프트를
인용하는 규칙, 스킬, 또는 커맨드는 그곳에서 이를 읽습니다. 커맨드, 스킬, 도우미
정의는 네이티브 디스커버리 위치를 사용합니다.
프로필 문서 ~/.config/opencode/apothem/rules/00-apothem-profile.md는 공유
프로필에서 가져온 여러분의 신원과 선호를 담고, Apothem 지원 파일 섹션으로
끝납니다. 이 섹션은 저장소 스타일의 각 인용(rules/<name>.md, templates/...,
hooks/...)이 해석되는 기준인 ~/.config/opencode/.apothem/support/ 아래의 절대
디렉터리를 명시합니다. 이 문서는 첫 번째 instructions 항목이므로 OpenCode는
모든 세션에서 이 문서를 로드합니다.
이전 릴리스가 작성한 opencode.json은 모든 규칙을 로드하는 단일 glob
~/.config/opencode/.apothem/support/rules/*.md를 나열하거나, 당시 상시
적용이던 28개 규칙 각각에 대한 명시적 경로를 나열합니다. apothem install과 apothem update는 어느 형태든 위의 목록으로 교체하며, 이때 더 이상
시작 시 로드되지 않는 24개의 경로가 빠집니다. apothem uninstall은 그것들을
모두 제거합니다. 여러분이 직접 작성한
instructions 항목은 어떤 경우에도 유지됩니다.
검증
apothem verify --harness opencodeverify 명령은 다음을 확인합니다.
- 네이티브 구성이 예상 경로에 존재합니다.
- 각 관리 대상이 존재하고, 관리되는 파일은 비어 있지 않으며, JSON 또는 YAML
구성은 파싱됩니다. 설치된 파일이 그 프로필과도 일치하는지 확인하려면
--profile PATH를 추가하세요. - 어댑터별 검증 루틴이 성공을 보고합니다.
업데이트
apothem update --harness opencodeopencode.json, 네이티브 커맨드, 스킬, 도우미 정의, 그리고 Apothem 지원 하위 트리를
새로 고칩니다.
제거
apothem uninstall --harness opencode어댑터가 ~/.config/opencode/opencode.json에 추가한 항목을 제거합니다(여러분의
키, MCP 서버, instructions 항목은 그대로 남으며, 이 파일은 Apothem이 직접
만들었고 여러분의 항목이 하나도 남아 있지 않은 경우에만 삭제됩니다). 프로필 문서
~/.config/opencode/apothem/rules/00-apothem-profile.md에서 Apothem 블록을
제거하고 그 안의 다른 텍스트는 유지하며, 이 파일은 그 안에 다른 내용이 남아 있지
않은 경우에만 삭제됩니다. 또한 ~/.config/opencode/commands/,
~/.config/opencode/skills/, ~/.config/opencode/agents/,
~/.config/opencode/.apothem/support/에 있는 Apothem 파일을 제거하며, 그
폴더들의 다른 파일은 그대로 남습니다. 각 파일은 변경하거나 제거하기 전에
~/.apothem/backups/ 아래에 백업됩니다. 공유 프로필 YAML과 Apothem 엔진은 영향을
받지 않습니다.
적합성 게이트
python -m apothem.conformity.gate --all .문제 해결
| 증상 | 해결 방법 |
|---|---|
| 구성 파일을 찾을 수 없음 | apothem install --harness opencode를 다시 실행 |
| 검증 실패 | apothem update --harness opencode를 실행한 다음 다시 검증 |
| 예기치 않은 구성 내용 | ~/.config/apothem/profile.yaml 또는 --profile PATH를 확인한 다음 apothem update --harness opencode를 다시 실행 |
구성 노브
| 플래그 | 기본값 | 설명 |
|---|---|---|
--dry-run | false | 파일을 작성하지 않고 설치를 미리 봅니다. |
함께 보기
- 전체 하니스 — 지원되는 도구의 전체 카탈로그
- 설치 가이드 — 이 하니스에 Apothem 설치
apothem harnesses참조 — CLI에서 어댑터를 나열하고 검사