JeiKeiLim/인지-정렬-스킬

인지-정렬-스킬은(는) 무엇을 하나요?

Claude Code를 위한 대화형 의사 결정 보고 스킬 — 구조화된 JSON 보고서, 선택 가능한 옵션, Mermaid 다이어그램, Markdown/JSON 내보내기로 사용자와 에이전트 간의 인지 격차를 해소합니다.

개요

이 스킬은 에이전트가 결정을 내릴 때마다 구조화된 의사 결정 보고서를 생성하여 사용자에게 투명한 추론 과정을 제공합니다. 각 보고서는 다음과 같은 요소를 포함합니다:

• 결정 컨텍스트: 현재 문제 상황과 고려 사항 요약
• 선택 옵션: 사용자가 선택할 수 있는 명확한 옵션 목록
• 추론 과정: 각 옵션의 장단점과 에이전트의 논리적 추론
• 최종 결정: 선택된 옵션과 그 근거
• 시각화: Mermaid 다이어그램으로 표현된 의사 결정 트리

사용 방법

스킬이 활성화되면, 에이전트는 복잡한 결정이 필요할 때마다 자동으로 구조화된 보고서를 생성합니다. 사용자는 다음 명령어로 수동으로 보고서를 요청할 수 있습니다:

/report  # 현재 결정 상태 보고서 생성
/export  # 마크다운 또는 JSON으로 내보내기

지원 플랫폼

• Claude Code: 기본 지원 플랫폼
• Codex: 호환 가능
• Cursor: 제한적 지원 (JSON 보고서만 가능)

출력 형식

JSON 보고서 예시

{
  "decision_id": "dec_12345",
  "timestamp": "2024-01-15T10:30:00Z",
  "context": "데이터베이스 마이그레이션 전략 선택",
  "options": [
    {
      "id": "opt_1",
      "title": "단계적 마이그레이션",
      "pros": ["리스크 최소화", "점진적 테스트 가능"],
      "cons": ["전체 기간 증가", "임시 호환성 계층 필요"]
    },
    {
      "id": "opt_2",
      "title": "빅뱅 마이그레이션",
      "pros": ["빠른 전환", "단순한 롤백"],
      "cons": ["고위험", "긴 다운타임 가능"]
    }
  ],
  "selected_option": "opt_1",
  "reasoning": "단계적 마이그레이션은 현재 서비스 중단을 최소화하면서 점진적으로 전환할 수 있어 장기적 안정성에 유리합니다.",
  "mermaid_diagram": "graph TD; A[시작] -->|옵션 1| B[단계적 마이그레이션]; A -->|옵션 2| C[빅뱅 마이그레이션];"
}

Mermaid 다이어그램

graph TD
    A[데이터베이스 마이그레이션] --> B[단계적 마이그레이션]
    A --> C[빅뱅 마이그레이션]
    B --> D[리스크 최소화]
    C --> E[빠른 전환]

내보내기

생성된 보고서는 다음 명령어로 내보낼 수 있습니다:

# 마크다운 내보내기
/export markdown

# JSON 내보내기
/export json

환경 변수

• COGNITION_REPORT_DIR: 보고서 저장 디렉토리 (기본값: ./cognition-reports)
• COGNITION_AUTO_REPORT: 자동 보고서 생성 활성화 (기본값: true)
• COGNITION_MAX_OPTIONS: 옵션 최대 개수 (기본값: 5)

라이선스

MIT