Community라이팅 & 에디팅github.com

WIHATN/vault-crystallize

Claude/agent 스킬: 작업 진행 상황을 Handoff.md에 체크포인트로 저장하고, 소스를 인용 및 신뢰도 평가된 증거 로그로 증류하여 에이전트 관리형 지식 저장소(vault)에 통합합니다.

vault-crystallize란 무엇인가요?

이 스킬은 지식 저장소(vault) 내에서 `crystallize`와 `distill` 명령의 동작을 정의하는 행동 권위체입니다. `crystallize`는 현재 작업 단위(프로젝트, 연구 도메인 등)를 식별하고 변경 사항이 있을 경우에만 `Handoff.md`와 `llm-wiki/` 페이지를 업데이트하여 복구 지점 및 장기 지식을 체크포인트합니다. 변경 사항이 없으면 아무것도 쓰지 않고 이유를 설명합니다. `distill`은 사용자가 명시적으로 요청할 때만 작동하며, 파일이나 텍스트 등 구체적인 소스를 번호가 매겨진 블록으로 분할하고 증거와 추론을 분리하여 신뢰도(`high`, `medium`, `low`, `unverified`)를 할당한 증거 항목을 `llm-wiki/evidence-log.md`에 추가합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 중국어를 기본 언어로 사용하지만 기술 식별자는 영어를 유지합니다. `Handoff.md` 및 `llm-wiki/` 콘텐츠 작성 시 검토 체크리스트를 적용하여 일관성을 보장하고, `neat-freak` 같은 관련 없는 작업으로 확장되지 않도록 경계를 명확히 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add WIHATN/vault-crystallize

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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

  1. 현재 단위 식별:
    • projects/<name>/ 아래 작업 -> 해당 프로젝트.
    • research/<name>/ 아래 작업 -> 해당 연구 도메인. 단, 하위 모듈에 자체 Handoff.md가 있는 경우는 제외.
    • 저장소 거버넌스 또는 교차 저장소 규칙 -> 루트 Handoff.md 및 global/llm-wiki/.
  2. 현재 프로젝트 상태를 주장하기 전에 현재 단위 Handoff.md를 읽습니다. 단위가 불명확하면 루트 Handoff.md를 활성 프로젝트 인덱스로 읽고, 여전히 불명확하면 간결한 질문을 하나 합니다.
  3. 실제로 변경된 사항이 있는지 결정:
    • 복구 지점 변경됨 -> 현재 단위 Handoff.md 업데이트.
    • 다른 스레드가 장기적으로 알아야 할 안정적인 결론 -> 일치하는 기존 llm-wiki/ 페이지 업데이트.
    • 복구 또는 장기 변경 사항 없음 -> 아무것도 쓰지 않고 이유를 설명합니다.
  4. 쓰기 전에 각 안정적인 결론을 재사용 범위별로 라우팅:
    • 질문: 이 결론이 내일 유사한 작업을 하는 다른 프로젝트에서도 참이고 유용할까요? 예 -> 일반 사실을 일치하는 global/llm-wiki/<topic>.md 페이지에 쓰고, 프로젝트 위키에는 프로젝트별 애플리케이션 세부 정보와 위키링크 포인터만 유지합니다. 확실하지 않음 -> 프로젝트 수준 유지(기본 하향).
    • 두 번의 규칙: 이 세션이 다른 프로젝트 위키에 있는 결론을 사용하거나 다시 작성한 경우, 지금 전역 주제 페이지로 승격합니다.
    • 읽기 전에 쓰기: 대상 주제 페이지를 먼저 읽고, 동일 주제 항목이 기존에 있으면 병합합니다. 절대 맹목적으로 추가하지 마십시오. 기존 주제가 맞지 않는 경우에만 새 주제 페이지를 만들고, 같은 패스에서 global/llm-wiki/index.md의 ## Triggers를 업데이트합니다.
  5. 올바른 레이어에만 쓰기:
    • Handoff.md는 현재 상태, 활성 파일, 미해결 질문, 다음 조치 및 재개 컨텍스트를 포함합니다.
    • llm-wiki/는 안정적인 결정, 방법, 함정, 메모리, 엔티티/개념 또는 증거 항목을 포함합니다.
    • log.md는 진정으로 주요한 지식 작업에만 사용하며, 일상적인 crystallize에는 사용하지 않습니다.
    • 도구 전용 메모리, 프로세스 재생 및 에이전트 캐시는 결코 저장소 권위체가 되지 않습니다.
  6. Handoff.md에 ## Tracks가 있으면 최종 확정 전에 모든 활성 트랙을 정리합니다. 작업이 명시적으로 종료하지 않는 한 비포커스 트랙은 보존합니다.
  7. 완료 보고 전에 아래 검토 체크리스트를 실행합니다.

명령: distill

사용자가 명시적으로 distill, 蒸馏라고 말하거나 구체적인 소스를 추적된 증거로 변환하도록 요청할 때만 사용합니다.

입력:

  • 소스: 파일 경로, 붙여넣은 텍스트, 가져온 URL 콘텐츠, 노트, PDF 또는 대화 발췌문.
  • 대상 단위: 소스 경로 또는 현재 작업에서 유추합니다. 모호하면 간결한 질문을 하나 합니다.
  • 대상: 대상 단위 llm-wiki/evidence-log.md.

워크플로:

  1. 대상 단위 Handoff.md를 읽습니다.
  2. global/agent-rules/llm-wiki-protocol.md의 ## Evidence Log 및 ## Pending Contradictions 섹션을 읽습니다.
  3. 소스를 소스 순서대로 번호가 매겨진 블록 B1, B2, B3, ...으로 분할합니다. 긴 원시 소스는 sources/ 또는 notes/에 보관하고, llm-wiki/에는 포인터와 간결한 증거만 넣습니다.
  4. 증거와 추론을 분리합니다. 증거 주장은 (src: Bn)을 인용합니다. 추론은 의존하는 소스 블록의 이름을 지정합니다.
  5. 결론당 신뢰도 할당: high, medium, low 또는 unverified.
  6. 새 증거가 기존 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 / 验证于을 갱신합니다.

관련 스킬