David-Li0406/meta-skill-evloving

로컬 스킬 파일 관리자

목적

사용자의 개인 로컬 스킬 파일을 경량화된 자기 개선 메모리 시스템으로 유지 관리합니다. 기본 목표는 마켓플레이스에 출시할 수 있는 일반 스킬을 생성하는 것이 아닙니다. 이 사용자, 이 팀 또는 이 워크스페이스가 향후 세션에서 재사용할 수 있는 행동을 보존하는 것입니다. 좋은 후보는 개인 작업 흐름 선호도, 프로젝트 규칙, 스타일 계약, 도구 선택, 또는 검토 게이트와 같이 다른 사용자에게는 유용하지 않지만, 의도된 소유자에게 재사용 가능하고 승인된 것이라면 무엇이든 될 수 있습니다.

이 스킬은 프로젝트별 코드, 서버, 벡터 스토어, 데이터베이스 또는 스토리지 레이아웃에 의존하지 않습니다. 일반적인 로컬 스킬 폴더에서만 작동합니다:

<skill-root>/
  <skill-name>/
    SKILL.md
    agents/openai.yaml   (선택 사항)
    scripts/             (선택 사항)
    references/          (선택 사항)
    assets/              (선택 사항)

이 스킬을 사용하여 세션에 재사용 가능한 스킬 자료가 포함되어 있는지 판단하고, 유사한 스킬이 이미 존재하는지 찾은 다음, 로컬 스킬을 폐기, 개선, 병합 또는 생성합니다. 모델은 신호가 나타나면 이 검사를 시작해야 하며, 사용자가 요청할 때까지 기다리지 않아야 합니다. 검사는 가볍고 비차단 상태를 유지해야 하며, 사용자가 명시적으로 스킬 유지 관리에 집중하도록 요청하지 않는 한 그래야 합니다.

관련 스킬 조정

이 스킬은 수명 주기 결정(추출 시기, 폐기 여부, 개선 또는 병합 여부, 작성 위치)을 소유합니다. 설치된 경우 주변 스킬과 조정하십시오:

• 새 스킬 구조, 이름 지정, 리소스 배치, agents/openai.yaml 및 유효성 검사를 위해 skill-creator를 사용하십시오.
• 기존 스킬 반복, 테스트 프롬프트, 실패 분석, 트리거 설명 조정, 전후 비교를 위해 skill-improvement 또는 이와 동등한 개선 지침을 사용하십시오.
• 중복 생성을 피하기 위해 skill-finder, find-skills 또는 이와 동등한 검색 도구를 사용하여 로컬 또는 외부 스킬 에코시스템을 검색하십시오.
• 결정 휴리스틱(이벤트 분류, 중복 제거, 반복, 우선 순위, 가치 검사 및 승격 게이트)으로만 자기 개선 패턴을 차용하십시오. 사용자가 요청하지 않는 한 다른 스킬의 저장소 경로, 데몬 가정 또는 코드 구조를 채택하지 마십시오.
• 이러한 도우미 스킬을 사용할 수 없는 경우 아래의 내장 절차를 적용하십시오. 도우미 스킬이 없다고 해서 차단하지 마십시오.
• 도우미 스킬이 추출 경계를 약화시키지 않도록 하십시오. 재사용 가능하고 사용자가 입증한 기능 변경만 저장되어야 합니다.

안전 및 동의

로컬 스킬은 향후 에이전트 동작에 영향을 미칠 수 있으며 실행 가능한 스크립트를 포함할 수 있습니다. 스킬 편집을 지속적인 동작 변경으로 취급하십시오.

• 사용자 동의 없이 타사 스킬을 설치, 가져오거나 활성화하지 마십시오.
• 놀라운 기능, 숨겨진 네트워크 액세스, 자격 증명 처리, 데이터 유출 또는 파괴적인 명령을 추가하지 마십시오.
• 스킬에 스크립트 또는 도구 통합이 추가된 경우 SKILL.md에서 해당 목적을 명확히 하십시오.
• 팀과 공유될 수 있는 스킬을 편집할 때는 조직 정책을 준수하고 보안에 민감한 동작을 변경하기 전에 문의하십시오.
• 각 후보를 기본적으로 personal로 취급하십시오. 해당 광범위한 대상을 뒷받침하는 증거가 있는 경우에만 team 또는 public으로 표시하십시오.
• 명시적인 사용자 승인 없이 사용자별 스킬을 게시하거나, 광범위하게 재사용 가능하다고 권장하거나, 개인 범위를 제거하지 마십시오.
• 새로운 로컬 규칙에서 첫 번째 지속적 학습 노트나 스킬 작성을 하기 전에, 사용자에게 작성될 경로를 알리고 승인을 요청하십시오.
• 일상적인 유지 관리 중에 이 autoskill 관리자 자체를 자동으로 수정하지 마십시오. 사용자가 명시적으로 이 스킬을 개선하도록 요청한 경우에만 개선하십시오.

스킬 루트

무엇을 작성하기 전에 로컬 스킬이 있는 위치를 식별하십시오.

• 먼저 명시적인 사용자 제공 경로를 사용하십시오.
• 그렇지 않으면 ${CODEX_HOME}/skills, ~/.codex/skills, ./skills, .agents/skills 및 */SKILL.md가 포함된 현재 워크스페이스 스킬 디렉토리와 같은 일반적인 루트를 확인하십시오.
• 정확히 하나의 그럴듯한 루트가 있으면 사용하십시오.
• 여러 개의 그럴듯한 루트가 있고 대상이 모호한 경우 사용자에게 유지 관리할 루트를 문의하십시오.
• 관련 없는 스킬 루트를 재구성하거나 선택한 루트 외부의 스킬을 편집하지 마십시오.

트리거 정책

세 가지 계층 트리거 정책을 사용하십시오:

1. 무음 스캔: 각 실질적인 사용자 응답 후, 해당 응답에 재사용 가능한 개인 선호도, 규칙, 수정, 작업 흐름, 실패 또는 스킬 품질 문제가 포함되어 있는지 간단히 질문하십시오.
2. 추출 검사: 아래 트리거가 실행되면 경험을 분류하고, 증거와 가치를 할당하고, 유사한 스킬을 검색하고, 추출 경계에 대해 테스트하십시오.
3. 쓰기/업데이트: 후보가 경계를 통과하고, 대상 스킬 루트가 명확하며, 사용자가 정확한 변경 사항을 승인한 경우에만 로컬 스킬 파일을 편집하십시오.

모델은 사전 예방적으로 스캔 및 추출 검사를 시작해야 합니다. 사용자에게 "스킬을 확인해야 할까요?"라고 묻지 마십시오. 대상 루트가 모호하거나, 편집으로 인해 불확실한 동작을 덮어쓰게 되거나, 사용자가 외부 설치 또는 민감한 스크립트를 승인해야 하는 경우에만 문의하십시오.

후보 수명 주기

특정 스토리지 시스템과 별도로 수명 주기를 유지하십시오: 신호를 관찰하고, 선택적으로 사용자에게 후보 제목/주제를 선택하도록 요청하고, 후보를 초안 작성하고, 패턴별로 중복을 제거하고, discard/keep_note/improve/merge/create를 결정하고, 완전한 제안된 스킬 또는 diff를 표시한 다음, 가장 작은 승인된 변경 사항을 적용하고 유효성을 검사하십시오.

정확한 표현보다는 작업 패밀리, 트리거, 도구, 실패 모드, 출력 계약 및 대상 스킬별로 중복을 제거하십시오. 이 스킬의 일부로 개인 데이터베이스, 데몬, 스케줄러 또는 숨겨진 백그라운드 저장소를 생성하지 마십시오.

제목 선택 게이트

전체 추출 전에 재사용 가능한 주제가 모호하거나 여러 개의 그럴듯한 스킬이 있는 경우, 2-5개의 간결한 재사용 가능 기능 제목과 한 줄의 증거 사유, 그리고 none of these 및 custom topic을 표시하십시오. 사용자가 제목을 선택하거나 주제를 입력하면 방향으로만 취급하십시오: 해당 방향에 대해 추출 경계 및 유사 스킬 검색을 다시 실행하고, 실패하면 폐기하거나, 통과하면 완전한 제안된 SKILL.md/diff를 최종 승인을 위해 표시하십시오. 사용자가 none of these를 선택하면 비영구 노트를 폐기하거나 유지하고, 파일을 작성하지 마십시오.

언어 일관성

새 스킬의 경우 사용자 증거의 주요 언어로 후보 제목, 제안된 SKILL.md, agents/openai.yaml 및 소규모 리소스를 작성하십시오. 중국어 입력은 중국어 스킬을, 영어 입력은 영어 스킬을 생성합니다. 업데이트 또는 병합의 경우 사용자가 명시적으로 번역을 요청하지 않는 한 대상 스킬의 주요 언어를 유지하십시오. 혼합된 증거로 인해 언어가 모호한 경우 초안 작성 전에 문의하십시오. 추출된 스킬 콘텐츠를 기본적으로 영어로 설정하지 마십시오.

백그라운드 실행

스킬 추출 및 유지 관리는 사용자의 주요 작업을 차단해서는 안 됩니다.

• 가능할 때마다 추출 검사, 유사 스킬 검색, 후보 초안 작성 및 트리거 평가 준비를 백그라운드 유지 관리 작업으로 취급하십시오.
• 백그라운드 작업은 후보를 준비하고, 유사한 스킬을 찾고, diff를 초안으로 작성할 수 있지만, 사용자 확인 없이 스킬을 쓰거나, 업데이트하거나, 삭제하거나, 설치하거나, 활성화해서는 안 됩니다.
• 먼저 기본 사용자 요청을 계속 처리하십시오. 사용자가 명시적으로 스킬 유지 관리에 집중하도록 요청하지 않는 한 스킬 추출을 위해 사용자를 기다리게 하지 마십시오.
• 실행 가능한 후보 결정, 제안된 파일 diff 또는 설명/동의 질문이 있는 경우에만 백그라운드 결과를 표시하십시오.
• 사용자가 일괄 처리를 요청하지 않는 한 활성 대화당 최대 하나의 백그라운드 스킬 유지 관리 작업을 실행하십시오. 추가 신호는 대기열에 넣거나 병합하십시오.
• 포그라운드에서 비용이 많이 드는 검색, 광범위한 평가 또는 대규모 재작성을 시작하지 마십시오. 먼저 가벼운 검사를 사용한 다음, 자연스러운 일시 중지 또는 명시적 유지 관리 패스까지 더 깊은 유효성 검사를 연기하십시오.
• 런타임이 실제로 백그라운드 작업을 실행할 수 없는 경우, 현재 답변이 완료되거나 다음 자연스러운 일시 중지가 될 때까지 유지 관리 검사를 연기하여 이를 에뮬레이트하십시오.
• 요청된 작업이 스킬 유지 관리 자체가 아닌 한, 후보 추출을 완료하기 위해 사용자가 요청한 작업의 전달을 차단하지 마십시오.

확인 게이트

스킬 파일이 생성, 업데이트, 삭제, 가져오기, 설치, 활성화 또는 실질적으로 재작성되기 전에 사용자 확인이 필요합니다. 먼저 초안을 작성하고, 두 번째로 요청하십시오: 제목/주제 선택 후, 제안된 콘텐츠 또는 변경 사항이 검토를 위해 이미 작성될 때까지 "스킬을 추가/업데이트해야 할까요?"라고 묻지 마십시오.

create의 경우 작성 전에 다음을 표시하십시오:

• 제안된 스킬 이름 및 대상 경로
• 의도된 대상: personal, team 또는 public, 이식성 제한
• 후보가 재사용 가능한 스킬 경계를 통과한 이유
• 증거 수준, 반복 신호, 우선 순위 및 가치 신호
• 확인된 유사 스킬 및 이것이 중복이 아닌 이유
• 완전한 제안된 SKILL.md 콘텐츠
• 완전한 제안된 agents/openai.yaml 및 인라인으로 검토할 수 있을 만큼 작은 경우 모든 제안된 스크립트, 참조 또는 자산 텍스트; 대규모 자산의 경우 정확한 파일 목록, 목적, 출처 및 생성된 diff 또는 매니페스트를 표시하십시오.

improve 또는 merge의 경우 작성 전에 다음을 표시하십시오:

• 정확한 대상 스킬 경로
• 결정 유형: improve 또는 merge
• 변경 사항이 해당 기존 스킬에 속하는 이유
• 증거 수준, 반복 신호, 우선 순위 및 가치 신호
• 완전한 통합 diff, 또는 통합 diff를 사용할 수 없는 경우 변경된 각 섹션에 대한 완전한 전후 텍스트
• 추가, 수정, 삭제 또는 변경되지 않은 모든 파일
• 승인 후 실행할 유효성 검사 계획 또는 명령

전체 제안된 아티팩트 또는 diff를 표시한 후에만 명확한 예/아니오 승인을 요청하십시오. 사용자가 승인하지 않으면 스킬을 편집하지 마십시오. 후보가 연기되었거나 폐기되었다고 보고하십시오.

즉시 트리거

다음 상황 중 하나가 발생하면 즉시 또는 사용자가 주요 작업을 기다리고 있는 경우 다음 자연스러운 일시 중지 시 추출 검사를 실행하십시오:

• 사용자가 향후 유사한 작업에 영향을 주어야 하는 방식으로 모델의 접근 방식을 수정, 거부 또는 구체화합니다.
• 사용자가 지속적인 선호도, 출력 계약, 작업 흐름, 명명 규칙, 도구 규칙 또는 품질 게이트를 제공합니다.
• 명령, 스크립트, 통합 또는 작업 흐름이 실패하고 세션에서 재사용 가능한 수정 사항을 발견합니다.
• 에이전트가 재사용 가능한 리소스가 되어야 하는 사소하지 않은 설정, 스크립팅, 변환 또는 유효성 검사 작업을 반복합니다.
• 유사한 로컬 스킬이 트리거를 덜 실행하거나, 과도하게 실행하거나, 불완전한 지침을 생성합니다.
• 세션에서 향후 반복적인 노력을 방지할 누락된 참조, 템플릿, 스크립트 또는 체크리스트를 드러냅니다.
• 사용자가 "이것을 스킬로 기억해", "이 작업 흐름을 저장해", "로컬 스킬을 업데이트해", "다음에는 이렇게 해", "이것은 나의 표준 프로세스야", 또는 "이 대화에서 스킬을 만들어"와 같은 미래 지향적인 언어를 사용합니다.

여전히 추출을 요구 사항이 아닌 검사로 취급하십시오. 종종 스킬 변경이 없는 것이 올바른 결과입니다.

사용자가 규칙이 일시적이라고 말하거나, 기억하지 말라고 요청하거나, 일회성 답변만을 원하는 경우 추출하지 마십시오.

예정된 검사

단일 응답으로는 명확하지 않은 점진적 학습을 포착하기 위해 예정된 검사를 사용하십시오:

• 대화 길이 검사: 마지막 검사 이후 약 6개의 실질적인 사용자 메시지, 총 12턴 또는 2-3개의 뚜렷한 작업 시도 후.
• 토큰/볼륨 검사: 특히 대화가 곧 요약되거나 압축될 수 있는 경우, 긴 새 컨텍스트 청크 후.
• 작업 경계 검사: 결과물이 완료되거나, 디버깅 루프가 종료되거나, 계획이 수락되거나, 사용자가 새 작업으로 전환할 때.
• 세션 종료 검사: 실질적인 세션의 최종 응답 전에 폐기, 개선, 병합, 생성 또는 기록해야 할 사항이 있는지 검토하십시오.

예정된 검사를 가볍게 유지하십시오. 일반적으로 자동으로 수행되어야 하며, 실행 가능한 결정이나 필요한 설명이 있는 경우에만 사용자에게 표시되어야 합니다.

디바운스 및 배치 처리

시끄러운 반복 추출을 방지하십시오:

• 하나의 세션에서 동일한 신호를 반복적으로 재확인하지 마십시오.
• 작업 경계 또는 예정된 검사까지 여러 개의 약한 신호를 일괄 처리하십시오.
• 사용자가 명시적으로 일괄 처리를 요청하지 않는 한 검사당 최대 하나의 스킬을 생성하거나 업데이트하십시오.
• 경계선 신호의 경우 증거가 강화될 때까지 keep_note 또는 discard를 선호하십시오.
• 후보가 가깝지만 아직 재사용 가능할 정도로 충분하지 않은 경우 스킬을 생성하는 대신 완료 노트에 근거를 기록하십시오.
• 동시 트리거를 하나의 백그라운드 유지 관리 패스로 통합하십시오.
• 여러 후보가 경쟁할 때 가장 우선 순위가 높은 반복 실패 또는 사용자 확인 선호도를 먼저 처리하십시오.

경험 분류

스킬을 변경하기 전에 세션 경험을 분류하십시오. 지속 가능한 범주는 error, correction, best_practice, knowledge_gap 및 preference입니다. one_off_result는 세션이 유용한 작업을 생성했지만 지속 가능한 프로세스 변경이 없음을 의미합니다.

지속 가능한 범주만 스킬 변경이 될 수 있으며, 추출 경계를 통과한 후에만 가능합니다. 일회성 결과는 승격되어서는 안 됩니다.

가치 및 우선 순위 게이트

• 우선 순위 P0: 안전하지 않거나, 파괴적이거나, 개인 정보에 민감하거나, 반복적으로 실패하는 동작을 방지합니다.
• 우선 순위 P1: 중요한 반복 실수, 누락된 트리거, 잘못된 병합 또는 비용이 많이 드는 반복 작업 흐름을 방지합니다.
• 우선 순위 P2: 반복되는 작업 패밀리의 품질, 속도 또는 명확성을 향상시킵니다.
• 우선 순위 P3: 제한된 증거가 있는 편의성 또는 스타일 개선.

참신함이 아니라 지속적인 가치로 승격하십시오. 가치는 신뢰성, 안전성, 속도, 품질, 일관성 또는 반복 작업 감소로 설명할 수 있어야 합니다. 명확한 가치 차원이 없으면 비영구 노트를 폐기하거나 유지하십시오.

기존 스킬을 개선할 때는 한 번에 하나의 동작 레버(트리거 문구, 작업 흐름 단계, 유효성 검사 게이트, 리소스 배치 또는 안전 제약 조건)를 변경하십시오.

승격 규칙

모든 경험을 스킬 편집으로 전환하지 마십시오. 의도적으로 경험을 승격하십시오:

• 사용자가 다음 번에 규칙이 적용되어야 한다고 명시적으로 말하는 경우 즉시 승격하십시오.
• 수정 사항이 심각한 반복 실패, 안전하지 않은 작업 또는 파괴적인 작업 흐름을 방지하는 경우 즉시 승격하십시오.
• 동일한 오류, 수정 또는 모범 사례가 여러 유사한 작업에 걸쳐 나타나는 경우 반복 후 승격하십시오.

...

(이하 생략 - 원본이 잘렸습니다)