프로필 편집하기
공유 프로필을 변경하고 설치된 모든 하니스를 다시 머티리얼라이즈합니다.
목표: 공유 프로필의 값을 변경하고 설치한 모든 하니스에 푸시합니다.
사전 요건
PATH에 등록된apothemCLI(또는 자체 포함 형식:PYTHONPATH="$HOME/.apothem/src"를 접두하고python -m apothem실행, 또는npx @ahmed-g-gad/apothem사용).~/.config/apothem/profile.yaml의 프로필. 없다면apothem profile init으로 생성하십시오.
프로필 형태
프로필은 단일 YAML 문서입니다. 최상위 키는 다음과 같습니다:
identity(필수) —name, 그리고 선택적으로role,email,website,github.preferences—language,style(concise/verbose/balanced),formatter,test_framework.rules— 역량 있는 하니스와 공유되는 추가 규칙 문자열 목록.seriousness—EXPLORING,PERSONAL_USE,SHARED,PUBLIC_LAUNCH중 하나.enforcement— 옵트인 토글(sprints,agent_teams,multitasking,continuous_execution,learning_loop), 모든 플래그 기본 비활성.harnesses— 하니스 id로 키가 지정된 하니스별 재정의.exclude_harnesses— 일괄(--harness all) 커맨드가 건너뛰는 하니스 id.mcp_servers— 서버 이름으로 키가 지정된 MCP 서버 정의.agent_mcp_servers— 헬퍼 이름별로, 그 헬퍼가 호출할 수 있는 MCP 서버 (헬퍼에 MCP 서버 접근 권한 부여하기 참조). 기본값은 비어 있으므로 어떤 헬퍼도 MCP 도구에 도달하지 않습니다.workspace— Apothem이 공유 작업 디렉터리를 두는 위치 (directory_name,scope).schema_version— 선택적 프로필 스키마 버전. 이 키가 없는 프로필은 버전 1로 읽힙니다.
모든 필드는 프로필 필드에 나열되어 있습니다.
단계
-
현재 프로필을 점검합니다:
apothem profile show -
편집합니다. 시스템 편집기에서 엽니다:
apothem profile edit또는 명령줄에서 단일 점 표기 키를 설정합니다. 값은 그대로 저장되며 (
true/false와 명시적[..]/{..}입력은 예외), 쓰기 전에 프로필이 스키마에 대해 검증됩니다 — 잘못된 설정은 거부되고 디스크의 프로필은 변경되지 않습니다:apothem profile set seriousness SHARED apothem profile set identity.name "Ada Lovelace" -
변경이 하니스의 네이티브 구성에 도달하도록 하니스를 다시 머티리얼라이즈합니다. 사용자 범위 하니스의 경우:
apothem update --harness claude-code프로젝트 범위 하니스의 경우 프로젝트 루트를 전달합니다. 설치된 모든 하니스를 새로 고치려면
all을 사용합니다:apothem update --harness cursor --project /path/to/project apothem update --harness all --project /path/to/project
검증
apothem profile show
apothem verify --harness allprofile show는 편집 내용을 반영합니다.
apothem verify --harness all은 프로필의 exclude_harnesses에 나열된 하니스를 제외하고 등록된 모든 하니스를 검사합니다. 따라서 나머지 하니스 중 하나라도 설치되어 있지 않으면 0이 아닌 코드로 종료합니다. 프로젝트 범위 하니스에는 --project PATH도 필요합니다. 이를 지정하지 않으면 일괄 실행은 project.required 오류와 함께 중단됩니다. 업데이트한 하니스만 확인하려면 같은 명령을 그 하니스 이름과 함께 실행하세요:
apothem verify --harness <name>설치하지 않은 하니스가 있어도 괜찮은 시스템 전체 관점의 점검이 필요하면 apothem doctor를 실행하세요.