Decision Advisor Skill
목적
의사결정 지점에서 사용자에게 판단 근거와 추천사항 제공
실행 시점
각 체크포인트 스크립트에서 호출 시 (checkpoint.sh)
분석 내용
- •현재 단계 완성도 평가: 완료/부분완료/재작업필요
- •발견된 문제점 및 위험요소: 기술적/구조적 문제 식별
- •다음 단계 진행 가능 여부 판단: 가능/조건부 가능/불가능
- •추천 조치사항: 진행/수정후진행/재작업
- •각 선택지의 장단점: 의사결정을 위한 상세 정보
출력 형식
구조화된 텍스트로 명확하게 제시
응답 템플릿
code
======================================== 🤖 AI 의사결정 분석 ======================================== 📊 현재 단계 완성도 상태: [완료 ✅ / 부분완료 ⚠️ / 재작업필요 ❌] 진행률: XX% 📝 완료된 항목 ✅ 항목 1 ✅ 항목 2 ... ⚠️ 발견된 문제점 위험도: [낮음/중간/높음] - 문제 1: 설명 및 영향 - 문제 2: 설명 및 영향 ... 🔍 검증 결과 - 구문 검증: [통과/실패] - 테스트 실행: [통과/실패] - 보안 체크: [통과/보류/실패] - 성능 체크: [통과/보류/실패] 📋 다음 단계 진행 가능 여부 결론: [✅ 진행 가능 / ⚠️ 조건부 가능 / ❌ 진행 불가] 근거: - 이유 1 - 이유 2 ... 💡 추천 조치 추천: [1) 진행 / 2) 수정 후 진행 / 3) 재작업] 선택지별 설명: 1️⃣ 진행 - 장점: ... - 단점: ... - 예상 소요 시간: ... 2️⃣ 수정 후 진행 - 수정 필요 사항: ... - 예상 수정 시간: ... - 우선순위: ... 3️⃣ 재작업 - 재작업 필요 이유: ... - 예상 소요 시간: ... - 학습 포인트: ... ======================================== 👤 사용자 선택을 기다립니다... ========================================
평가 기준
완료 (✅)
- •모든 계획된 작업 완료
- •테스트 100% 통과
- •치명적 문제 없음
- •다음 단계로 진행 가능
부분완료 (⚠️)
- •핵심 기능은 완료되었으나 일부 부가 기능 미완
- •테스트 80% 이상 통과
- •경미한 문제만 존재 (나중에 수정 가능)
- •조건부 다음 단계 진행 가능
재작업필요 (❌)
- •핵심 기능 미완성
- •테스트 80% 미만 통과
- •치명적 버그 또는 구조적 문제
- •다음 단계 진행 불가
위험도 분류
낮음 (🟢)
- •코딩 스타일 문제
- •경미한 성능 이슈
- •문서 미비
- •나중에 수정해도 무방
중간 (🟡)
- •보안 경고 (치명적이지 않음)
- •일부 테스트 실패
- •확장성 우려
- •수정 권장
높음 (🔴)
- •치명적 보안 취약점
- •데이터 손실 가능성
- •시스템 크래시 위험
- •즉시 수정 필수
주의사항
- •비개발자도 이해할 수 있는 설명 사용
- •기술 용어에는 쉬운 설명 추가
- •명확한 추천사항 제시 (애매한 표현 금지)
- •위험요소는 반드시 강조 (🔴 사용)
- •객관적 데이터 기반 판단 (주관적 의견 최소화)
실행 예시
checkpoint.sh 스크립트에서 호출
bash
# AI에게 의사결정 분석 요청 agy chat "다음 핸드오프 문서를 분석하고 의사결정 조언을 해줘: $(cat .agent/handoffs/01-plan-summary.md) @decision-advisor skill을 사용해서 다음 형식으로 답변: 1. 현재 단계 완성도: [완료/부분완료/재작업필요] 2. 발견된 문제점: [있음/없음 - 구체적 내용] 3. 다음 단계 진행 가능 여부: [가능/불가능 - 이유] 4. 추천 조치: [진행/수정후진행/재작업] "
AI 응답 예시
code
======================================== 🤖 AI 의사결정 분석 ======================================== 📊 현재 단계 완성도 상태: 완료 ✅ 진행률: 95% 📝 완료된 항목 ✅ 전체 기능 목록 정의 완료 ✅ 우선순위별 구현 단계 수립 ✅ 기술 스택 선정 (Python/FastAPI/PostgreSQL) ✅ 데이터베이스 스키마 초안 작성 ✅ API 엔드포인트 정의 ⚠️ 발견된 문제점 위험도: 낮음 🟢 - 인증 방식이 JWT로 결정되었으나 OAuth 2.0 통합은 2단계로 연기됨 - 캐싱 전략(Redis)은 계획되었으나 구체적 캐싱 정책 미정의 🔍 검증 결과 - 구문 검증: N/A (계획 단계) - 문서 완성도: 통과 ✅ - 아키텍처 일관성: 통과 ✅ - 보안 고려사항: 통과 ✅ 📋 다음 단계 진행 가능 여부 결론: ✅ 진행 가능 근거: - 모든 핵심 아키텍처 결정 완료 - 다음 단계(구현)에 필요한 정보 충분히 제공됨 - 발견된 문제는 구현 단계에서 해결 가능 - ADR 문서로 주요 결정 사항이 명확히 기록됨 💡 추천 조치 추천: 1️⃣ 진행 선택지별 설명: 1️⃣ 진행 (추천) - 장점: 계획이 충분히 구체적이며 즉시 구현 시작 가능 - 단점: 없음 - 예상 소요 시간: 아키텍처 설계 4-6시간 2️⃣ 수정 후 진행 - 필요 없음 3️⃣ 재작업 - 필요 없음 ======================================== 👤 다음 단계로 진행하시겠습니까? ========================================
통합 워크플로우
bash
# 1. 핸드오프 문서 생성 완료 # .agent/handoffs/01-plan-summary.md # 2. 체크포인트 실행 bash .agent/scripts/checkpoint.sh ".agent/handoffs/01-plan-summary.md" "아키텍처 설계" # 3. decision-advisor가 자동으로 분석 수행 # AI가 의사결정 조언 출력 # 4. 사용자 선택 # 1) 예 - 다음 단계 진행 # 2) 수정 필요 - AI에게 수정 지시 # 3) 중단 - 워크플로우 종료
판단 로직 (AI 내부 가이드라인)
진행 가능 판단 기준
code
IF (완료된_항목 >= 90%) AND (치명적_문제 == 0) AND (다음단계_정보_충분 == true):
return "진행 가능"
ELIF (완료된_항목 >= 70%) AND (치명적_문제 <= 1) AND (수정_가능 == true):
return "조건부 가능 (수정 후 진행)"
ELSE:
return "진행 불가 (재작업 필요)"
위험도 평가
code
치명적_문제 = COUNT(보안취약점) + COUNT(데이터손실위험) + COUNT(시스템크래시)
경미한_문제 = COUNT(코딩스타일) + COUNT(문서미비) + COUNT(성능경고)
IF 치명적_문제 > 0:
위험도 = "높음 🔴"
ELIF 경미한_문제 > 5:
위험도 = "중간 🟡"
ELSE:
위험도 = "낮음 🟢"