Community생산성 & 협업github.com

OpenGHz/record-usage-issues

사용자가 프로젝트를 사용하면서 겪는 마찰과 버그를 기록하여 분류 가능한 AGENT_ISSUES.md 로그로 만드는 옵트인 에이전트 스킬입니다.

record-usage-issues란 무엇인가요?

OpenGHz/record-usage-issues는 AI 에이전트(예: Claude Code, Cursor)가 사용자와 상호작용하는 동안 발생하는 문제점을 자동으로 캡처하도록 설계된 전문 스킬입니다. 이 스킬은 프로젝트 작업 중 사용자가 경험하는 마찰, 오류, 예상치 못한 동작을 식별하고 이를 구조화된 형식으로 'AGENT_ISSUES.md' 파일에 기록합니다. 개발자는 이 기록을 통해 추세를 분석하고, 버그를 분류하며, 해결 작업의 우선순위를 정할 수 있으므로 사후 대응이 아닌 사전 예방적인 문제 관리가 가능합니다. 다양한 AI 코딩 에이전트 플랫폼에서 사용할 수 있으며, 프로젝트 문서에 원활하게 통합되어 사용자 피드백과 실제 사용 문제점 사이의 격차를 해소합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add OpenGHz/record-usage-issues

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

record-usage-issues은(는) 무엇을 하나요?

사용자가 프로젝트를 사용하면서 겪는 마찰과 버그를 기록하여 분류 가능한 AGENT_ISSUES.md 로그로 만드는 옵트인 에이전트 스킬입니다.

개요

이 스킬은 사용자가 직면한 문제를 자동으로 감지하고 기록함으로써, 프로젝트 유지보수자가 모든 상호작용을 수동으로 추적하지 않고도 일반적인 문제점을 신속하게 파악하고 해결할 수 있도록 돕습니다.

작동 방식

  1. 에이전트가 프로젝트와 사용자 상호작용을 모니터링합니다.
  2. 마찰, 버그, 또는 예상치 못한 동작이 감지되면 이를 로그에 기록합니다.
  3. 로그는 AGENT_ISSUES.md 파일에 구조화된 형식으로 저장됩니다.
  4. 이 파일은 버그 분류, 우선순위 지정, 해결 작업에 사용할 수 있습니다.

주요 기능

  • 자동 기록: 사용자 상호작용 중 문제점을 자동으로 캡처합니다.
  • 구조화된 로그: 모든 항목을 일관된 형식으로 AGENT_ISSUES.md에 저장합니다.
  • 분류 준비 완료: 로그 항목을 쉽게 분류하고 우선순위를 지정할 수 있습니다.
  • 옵트인 방식: 원하는 경우에만 활성화하여 사용할 수 있습니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 코딩 에이전트

사용 방법

  1. 스킬을 활성화합니다.
  2. 사용자가 프로젝트를 사용하는 동안 에이전트가 상호작용을 모니터링합니다.
  3. 문제가 감지되면 자동으로 AGENT_ISSUES.md에 기록됩니다.
  4. 기록된 내용을 검토하고 분류합니다.

구성

환경 변수나 구성 파일을 통해 스킬의 동작을 조정할 수 있습니다. 자세한 내용은 프로젝트 문서를 참조하세요.

예시

# AGENT_ISSUES.md

## 버그
- [2024-01-15] 사용자가 설정 페이지에서 저장 버튼을 클릭했을 때 오류 발생
- [2024-01-14] 검색 기능이 특정 키워드에서 빈 결과 반환

## 마찰
- [2024-01-13] 온보딩 과정이 너무 길어 사용자가 이탈함
- [2024-01-12] 문서화가 부족하여 API 사용법을 이해하기 어려움

라이선스

MIT

관련 스킬