비교
Apothem 대 원시 GitHub Copilot 구성
GitHub Copilot의 copilot-instructions.md를 직접 손으로 유지하는 것과 Apothem의 공유 프로필에서 렌더링하는 것의 비교.
GitHub Copilot은 .github/copilot-instructions.md에서 지침을 읽습니다. Apothem의
github-copilot 어댑터는 그 파일을 공유 프로필에서 렌더링합니다. 이 페이지는 그
구성을 직접 손으로 유지하는 것과 Apothem으로 관리하는 것을 대비합니다.
노력 비교
| 작업 | 수동 구성 | Apothem 관리 |
|---|---|---|
| 지침 작성 | .github/copilot-instructions.md를 직접 편집 | 렌더링: 공유 규칙이 파일에 내장됨 |
| 다른 하니스와 지침을 일치 상태로 유지 | 수동, 도구별 | apothem update 시 자동 |
| 구성 설치 / 제거 | 파일을 직접 작성하고 삭제 | apothem install / apothem uninstall |
| 재사용 가능한 스킬과 커맨드 공유 | 각 스킬 폴더를 ~/.agents/skills/에 직접 복사하고 사본을 최신 상태로 유지 | 어댑터가 ~/.agents/skills/에 모든 프로젝트용 사본 하나로 작성하고, apothem update 시 갱신 |
| 구성이 올바른지 검증 | 수동 검사 | apothem verify --harness github-copilot --project <path> |
Apothem이 관리하는 것
github-copilot 어댑터는 공유 규칙을 .github/copilot-instructions.md에
내장합니다. Copilot은 .github/hooks/*.json에서 훅을 문서화하지만 어댑터는 이를
작성하지 않으므로, 가드레일 의도는 전적으로 렌더링된 지침 안에 담깁니다. 공유 규칙에 대한 모든
변경은 다음 apothem update 시 파일을 다시 렌더링합니다.
마이그레이션 경로
- 아직 공유 프로필을 만들지 않았다면
apothem profile init을 실행합니다. - 기존
.github/copilot-instructions.md의 내용을 공유 코퍼스로 옮깁니다. apothem install --harness github-copilot --project <path>를 실행해 지침 파일을 렌더링합니다.apothem verify --harness github-copilot --project <path>를 실행해 구성이 반영되었는지 확인합니다.- 이후의 모든 변경에는
apothem update --harness github-copilot --project <path>를 사용합니다.