Community코딩 & 개발github.com

Statusnone420/agent-skills

계획, 기술적 주장 또는 구현 명세가 작업 시작 전에 타당한지 검증합니다. 추론을 점검하거나 명세를 검토하라는 요청을 받았을 때 사용합니다. 코드 diff에는 사용하지 않습니다.

agent-skills란 무엇인가요?

이 스킬은 실제 구현에 들어가기 전에 추론이나 구현 명세의 타당성을 평가하기 위해 설계된 검토 도구입니다. '개념 검토(Conceptual Review)'로 작동하며, 의사 결정이나 주장을 분석하는 '추론 모드(Reasoning mode)'와 구현 계획이나 명세를 검증하는 '명세 모드(Spec mode)' 두 가지 모드를 지원합니다. 사용자는 먼저 리포지토리 상태, 테스트, 컴파일러 출력, 문서, 로그 등 저렴한 증거를 수집해야 하며, 추론은 증거의 한계에서 시작해야 합니다. 각 검토는 주요 가정 식별, 최약 링크 파악, 반론 제시, 구체적인 수정 권장 사항을 포함한 구조화된 출력을 제공합니다. 스킬은 Anthropic과 Redwood Research의 Conceptual Reasoning Index(CRI) 작업을 개발자 워크플로우에 맞게 조정했지만, CRI 또는 그 벤치마크를 완전히 구현하지는 않습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Statusnone420/agent-skills/tree/HEAD/adapters/claude/plugins/agent-skills/skills/conceptual-review

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

개념 검토

누군가 그 위에 구축하기 전에 추론이나 구현 명세가 타당한지 결정합니다. 사용자가 별도로 편집을 요청하지 않는 한 읽기 전용으로 유지합니다.

증거부터 시작

  • 먼저 저렴한 증거를 검색합니다: 리포지토리 상태, 테스트, 컴파일러 또는 타입체커 출력, 문서, 로그, 벤치마크, 구성, 런타임 동작. 추론은 증거가 끝나는 지점에서 시작합니다. 절대 확인 대신 추론하지 마세요.
  • 요청된 리비전, 브랜치, 범위 및 읽기 제한을 준수합니다. 명세가 특정 커밋에 바인딩된 경우 작업 트리가 아닌 해당 커밋을 읽습니다.
  • 모든 인용문, 숫자, 리포지토리 주장 및 인용된 선례를 검증해야 할 대상으로 취급합니다.
  • 각 중요한 전제를 관찰됨, 추론됨, 가정됨 또는 알 수 없음으로 레이블 지정합니다. 출처를 사용할 수 없는 것은 확인이 아니라 적용 범위의 공백입니다.

모드 선택

  • 추론 모드: 결정, 주장 또는 결론에 대한 것.
  • 명세 모드: 구현자가 따를 구현 계약, 계획 또는 요약에 대한 것.

명세가 논쟁의 여지가 있는 주장에 기반한 경우 두 가지를 모두 사용합니다.

추론 모드

  1. 결정 또는 주장을 명시합니다.
  2. 그것이 의존하는 전제를 위와 같이 레이블을 붙여 나열합니다.
  3. 증거가 건너뛴 단계, 순환적 지지, 또는 전제가 허용하는 것보다 더 큰 확신 없이 결론을 뒷받침하는지 확인합니다.
  4. 모두가 참일 수 없는 전제를 찾습니다.
  5. 가장 약한 중요한 연결고리를 지목합니다.
  6. 가장 강력한 그럴듯한 반론 또는 경쟁 설명을 제시합니다. 허수아비는 안 됩니다.
  7. 다른 결정이 주요 불확실성을 더 잘 처리하는지, 중요할 때 되돌릴 가능성을 포함하여 질문합니다.
  8. 가장 작은 수정을 권장합니다: 유지, 수정, 지명된 미지수 하나 조사, 또는 전환.

명세 모드

구현 또는 그 수용을 잘못되게 만들 수 있는 것을 확인합니다:

  1. 결과: 동작, 제외 사항 및 전제 조건이 서로 일치합니다.
  2. 출처: 인용문, 범위, 프로토콜 규칙, 공식 및 외부 사실이 1차 출처와 일치합니다.
  3. 산술: 개수, 경계, 행렬 및 합계가 정확히 재계산됩니다.
  4. 적용 범위: 영향을 받는 모든 호출자, 테스트, 인터페이스, 불변 조건, 호환성 약속 및 문서 문장이 설명됩니다. 명세가 지정한 경로를 넘어 제한된 검색을 실행하되, 관련 없는 아키텍처 검토로 빠지지 않습니다.
  5. 수용 능력: 각 필수 테스트가 대상으로 하는 결함에 대해 실패할 수 있습니다. 통제는 의미 있고, 부정적인 경우는 관찰 가능한 실패가 있습니다.
  6. 실행 명확성: 파일 범위, 순서, 경계 및 실패 동작, 완료 증명이 추측할 여지를 남기지 않습니다.
  7. 범위: 선례와 향후 작업이 현재 증거가 요구하는 것보다 더 많은 것을 조용히 정당화하지 않습니다.

리포지토리의 심각도 용어로 결과를 평가하거나:

  • BLOCKING: 잘못된 구현, 거짓 통과 또는 피할 수 없는 추측을 초래할 수 있습니다.
  • AMEND: 구체적인 공백 또는 모호함; 접근 방식은 여전히 유효합니다.
  • NIT: 구현을 변경하지 않는 표현 또는 증거 수정.

출력

  • 평결로 시작합니다. 추론 모드: 추론은 타당함, 또는 무엇이 그것을 깨뜨리는지. 명세 모드: 준비됨 또는 준비되지 않음, 결정적인 이유와 함께.
  • 추론 모드는 중요한 것만 제공합니다: 주요 가정, 최약 링크, 최선의 반론 및 권장 사항.
  • 명세 모드는 우선순위 순서대로 번호가 매겨진 결과(제목, 심각도, 정확한 증거, 중요한 이유, 구체적인 수정)와 생존한 중요한 주장의 짧은 확인됨 목록을 제공합니다.
  • 신뢰도(높음, 중간 또는 낮음), 평결을 변경할 가능성이 가장 높은 증거, 적용 범위 공백 또는 확인되지 않은 출처로 끝냅니다.

규칙

  • 결정을 변경할 수 있는 사항만 제기합니다. 깨끗한 평결은 유효합니다. 절대 결과를 조작하지 마세요.
  • 증거가 뒷받침할 수 없는 확률이나 점수를 만들어내지 마세요.
  • 누락된 결정이나 요구 사항이 검토를 차단하는 경우에만 사용자에게 질문합니다. 사용 가능한 사실은 직접 가져오세요.
  • 이 검토는 구현, 편집 또는 기타 결과적 행동을 승인하지 않습니다.
  • 인터페이스 및 결합 설계의 경우, 해당 메서드를 다시 실행하는 대신 $codebase-design을 권장합니다.

근거: Anthropic and Redwood Research의 개념 추론 인덱스 작업을 개발자 워크플로우로 각색했습니다. 이 스킬은 CRI 또는 그 벤치마크를 구현하지 않습니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬