Vault Crystallize
이 스킬은 지식 저장소(vault)에서 crystallize 및 distill을 위한 행동 권위체입니다. 저장소 프로토콜은 데이터 계약입니다:
AGENTS.md는 작업 공간 경계, 시작 계층 및 쓰기 소유권을 정의합니다.global/agent-rules/handoff-protocol.md는Handoff.md형식을 정의합니다.global/agent-rules/llm-wiki-protocol.md는llm-wiki/페이지 스키마, 증거, 모순, 통합 및 상태 점검을 정의합니다.global/agent-rules/llm-wiki-format.md는 존재하는 경우 페이지 템플릿을 정의합니다.
프로토콜에서 ## Crystallize 섹션을 찾지 마십시오. 이전 저장소에 존재하는 경우 이 스킬을 동작의 기준으로 삼고 프로토콜은 데이터 계약에만 사용하십시오.
경계
전용 트리거:
结晶,结晶一下,crystallize-> 복구 상태 및 안정적인 장기 지식만 변경되었을 때 체크포인트합니다.蒸馏,distill-> 구체적인 소스를 인용 및 신뢰도 평가된 증거 항목으로 변환합니다.
이 스킬을 neat-freak, 심층 감사, 광범위한 문서 정리, 메모리 동기화 또는 정리된 "结晶版" 요약에 사용하지 마십시오. 사용자가 명시적으로 별도 작업을 요청하지 않는 한, 단순한 收尾, "wrap up", "整理一下", "sync my notes"는 crystallize 트리거가 아닙니다.
이 스킬을 설치하지 않은 에이전트는 설치/업데이트 문제일 뿐, crystallize 동작을 저장소 프로토콜에 다시 복제할 이유가 아닙니다. 사용자가 명시적으로 설치 작업을 요청하지 않는 한 .claude/skills, .agents/skills, 정션(junctions) 또는 에이전트별 설치 경로를 만들지 마십시오.
네이티브 명령 래퍼는 commands/ 및 commands/<agent>/에 있습니다. 공유 일반 별칭 스킬은 skills/ 아래에 있습니다. 플랫폼별 디렉터리 아래에 중복 별칭 SKILL.md 파일을 추가하지 마십시오. Codex가 재귀적으로 두 번 발견할 수 있기 때문입니다. 이 모두를 명시적 호출 어댑터로 취급하고, 업데이트 시 SKILL.md를 동작 권위체로 유지하십시오.
언어 기본값
Handoff.md 및 llm-wiki/ 콘텐츠는 기본적으로 중국어로 작성합니다. 안정적인 기술 식별자(코드, 명령어, 변수명, 경로, API 이름, 패키지 이름 및 원본 제목을 보존해야 하는 소스 제목 포함)는 영어로 유지합니다.
사용자가 명시적으로 요청하거나, 소스 자료를 인용하거나, 기존 프로젝트 규칙이 해당 단위에 대해 더 구체적인 경우에만 다른 언어를 사용하십시오.
명령: crystallize
- 현재 단위 식별:
projects/<name>/아래 작업 -> 해당 프로젝트.research/<name>/아래 작업 -> 해당 연구 도메인. 단, 하위 모듈에 자체Handoff.md가 있는 경우는 제외.- 저장소 거버넌스 또는 교차 저장소 규칙 -> 루트
Handoff.md및global/llm-wiki/.
- 현재 프로젝트 상태를 주장하기 전에 현재 단위
Handoff.md를 읽습니다. 단위가 불명확하면 루트Handoff.md를 활성 프로젝트 인덱스로 읽고, 여전히 불명확하면 간결한 질문을 하나 합니다. - 실제로 변경된 사항이 있는지 결정:
- 복구 지점 변경됨 -> 현재 단위
Handoff.md업데이트. - 다른 스레드가 장기적으로 알아야 할 안정적인 결론 -> 일치하는 기존
llm-wiki/페이지 업데이트. - 복구 또는 장기 변경 사항 없음 -> 아무것도 쓰지 않고 이유를 설명합니다.
- 복구 지점 변경됨 -> 현재 단위
- 쓰기 전에 각 안정적인 결론을 재사용 범위별로 라우팅:
- 질문: 이 결론이 내일 유사한 작업을 하는 다른 프로젝트에서도 참이고 유용할까요? 예 -> 일반 사실을 일치하는
global/llm-wiki/<topic>.md페이지에 쓰고, 프로젝트 위키에는 프로젝트별 애플리케이션 세부 정보와 위키링크 포인터만 유지합니다. 확실하지 않음 -> 프로젝트 수준 유지(기본 하향). - 두 번의 규칙: 이 세션이 다른 프로젝트 위키에 있는 결론을 사용하거나 다시 작성한 경우, 지금 전역 주제 페이지로 승격합니다.
- 읽기 전에 쓰기: 대상 주제 페이지를 먼저 읽고, 동일 주제 항목이 기존에 있으면 병합합니다. 절대 맹목적으로 추가하지 마십시오. 기존 주제가 맞지 않는 경우에만 새 주제 페이지를 만들고, 같은 패스에서
global/llm-wiki/index.md의## Triggers를 업데이트합니다.
- 질문: 이 결론이 내일 유사한 작업을 하는 다른 프로젝트에서도 참이고 유용할까요? 예 -> 일반 사실을 일치하는
- 올바른 레이어에만 쓰기:
Handoff.md는 현재 상태, 활성 파일, 미해결 질문, 다음 조치 및 재개 컨텍스트를 포함합니다.llm-wiki/는 안정적인 결정, 방법, 함정, 메모리, 엔티티/개념 또는 증거 항목을 포함합니다.log.md는 진정으로 주요한 지식 작업에만 사용하며, 일상적인 crystallize에는 사용하지 않습니다.- 도구 전용 메모리, 프로세스 재생 및 에이전트 캐시는 결코 저장소 권위체가 되지 않습니다.
Handoff.md에## Tracks가 있으면 최종 확정 전에 모든 활성 트랙을 정리합니다. 작업이 명시적으로 종료하지 않는 한 비포커스 트랙은 보존합니다.- 완료 보고 전에 아래 검토 체크리스트를 실행합니다.
명령: distill
사용자가 명시적으로 distill, 蒸馏라고 말하거나 구체적인 소스를 추적된 증거로 변환하도록 요청할 때만 사용합니다.
입력:
- 소스: 파일 경로, 붙여넣은 텍스트, 가져온 URL 콘텐츠, 노트, PDF 또는 대화 발췌문.
- 대상 단위: 소스 경로 또는 현재 작업에서 유추합니다. 모호하면 간결한 질문을 하나 합니다.
- 대상: 대상 단위
llm-wiki/evidence-log.md.
워크플로:
- 대상 단위
Handoff.md를 읽습니다. global/agent-rules/llm-wiki-protocol.md의## Evidence Log및## Pending Contradictions섹션을 읽습니다.- 소스를 소스 순서대로 번호가 매겨진 블록
B1,B2,B3, ...으로 분할합니다. 긴 원시 소스는sources/또는notes/에 보관하고,llm-wiki/에는 포인터와 간결한 증거만 넣습니다. - 증거와 추론을 분리합니다. 증거 주장은
(src: Bn)을 인용합니다. 추론은 의존하는 소스 블록의 이름을 지정합니다. - 결론당 신뢰도 할당:
high,medium,low또는unverified. - 새 증거가 기존
llm-wiki/와 모순되는 경우## Pending Contradictions를 따릅니다. 조용히 덮어쓰지 마십시오.
증거 항목 형태:
### YYYY-MM-DD · <source title>
- **来源:** [[relative/source-or-note]]
- **原文块:**
- B1: <short source locator or excerpt summary>
- B2: <short source locator or excerpt summary>
- **证据结论:**
- <claim> (src: B1) - confidence: <high|medium|low|unverified>
- **推断:**
- <inference> (from: B1+B2) - confidence: <high|medium|low|unverified>
- **待验证:** <specific verification need, or `无`>
검토 체크리스트
Handoff 검토:
handoff-protocol.md의 정확히 요구되는 섹션.## Tracks는 병렬 활성 트랙에만 선택 사항.## Tracks가 존재하면 정확히 하나의 트랙에[focus]가 있습니다.## Last Done은 최대 4개 항목, 역시간순, 각각 날짜로 끝남.## Next Actions는 최대 3개의 구체적인 체크박스 항목.## Active Files는 각 파일이 현재 활성화된 이유를 설명하며, 파일이 무엇인지 설명하지 않음.## Decisions는[[llm-wiki/decisions]]에 대한 위키링크 또는 결정 블록 ID를 포함하거나None이라고 명시.## Resume는 다음 에이전트에게 무엇을 읽고 어떤 멘탈 모델을 유지할지 알려줌.
LLM 위키 검토:
- 새롭거나 크게 변경된 페이지는
llm-wiki-protocol.md에서 요구하는 프론트매터가 있음. - 페이지 유형이 콘텐츠와 일치: 결정, 방법, 함정, 메모리, 증거, 엔티티, 개념, 용어집 또는 작업 로그.
- 새 페이지는 로컬
llm-wiki/index.md에서 링크됨. - 주장에는 신뢰도가 있음. 증거 주장은 소스를 가리킴.
- 해결되지 않은 모순은 숨기지 않고 지정된 장소에 기록됨.
- 교차 프로젝트 재사용 가능한 결론은
global/llm-wiki/주제 페이지로 라우팅됨. 어떤 사실도 레이어 간에 중복되지 않음(프로젝트는 애플리케이션 세부 정보와 포인터를 유지). - 항목 제목과 필드 세트는 페이지 유형에 대한
llm-wiki-format.md템플릿과 일치: 주장 페이지(방법/함정/주제)는 안정적인 주제 이름으로 키 지정, 이벤트 페이지(결정/증거/로그)는 날짜로 키 지정. - 마크다운 테이블 내에 별칭이 있는 위키링크가 없음.
동작 검토:
- 명시적으로 요청하지 않는 한
neat-freak를 실행하거나 호출하지 않음. - 문서 정리, 메모리 동기화 또는 서식 변경으로 확장하지 않음.
- 명시적으로 요청하지 않는 한 에이전트 로컬 스킬 설치를 관리하지 않음.
- 변경된 사항이 없으면 쓰지 않음. "변경된 사항 없음"을 보고하는 것은 유효한 결과입니다.
검증
파일이 생성, 이동, 이름 변경되었거나 사용자가 스레드/에이전트를 전환하는 경우 저장소 루트에서 읽기 전용 상태 점검 모음을 실행합니다:
pwsh -NoProfile -File global/tools/vault-health.ps1
pwsh -NoProfile -File global/tools/vault-meta.ps1 -Audit
pwsh -NoProfile -File global/tools/vault-links.ps1
콘텐츠 전용 편집의 경우 가장 작은 관련 검사를 실행하고 건너뛴 항목을 보고합니다.
일반적인 실패 모드
| 실패 | 수정 |
|---|---|
| "스킬이 없는 다른 에이전트는 crystallize하지 않습니다." | 설치/업데이트 배포가 해결합니다. 프로토콜에 동작을 복제하지 마십시오. |
llm-wiki-protocol.md ## Crystallize를 읽습니다. | 중단하십시오. 이 스킬이 crystallize 동작을 소유합니다. 프로토콜은 형식과 상태 점검만 정의합니다. |
收尾 또는 "cleanup docs"를 crystallize로 취급합니다. | 전용 단어 또는 명시적 증거 의도가 나타나지 않는 한 트리거하지 마십시오. |
프로세스 로그를 llm-wiki/에 씁니다. | 안정적인 결론만 거기에 속합니다. |
| 오래된 Handoff 목록에 추가합니다. | 문서화된 한도 내에서 슬라이딩 윈도우를 다시 작성합니다. |
| 병합하지 않고 주장 페이지(메서드/함정/주제)에 새 날짜 항목을 추가합니다. | 주장 페이지는 주제별로 키 지정: 기존 항목을 찾아 내부에서 다시 작성하고 updated / 验证于을 갱신합니다. |