Agent skill

async-debugging

Analyze and fix race conditions and concurrency bugs in async code. Use when debugging async bugs, fixing race conditions, resolving concurrency issues, or when shared state is accessed by multiple async operations.

View SKILL.md on GitHub Repository
Stars 88
Forks 14

Install this agent skill to your Project

npx add-skill https://github.com/revfactory/claude-code-harness/tree/main/experiments/results/case-002/harness/.claude/skills/async-debugging

SKILL.md

Async Debugging

버그 분석 워크플로우

  1. 식별: 코드에서 공유 상태에 대한 비동기 접근을 모두 찾기
  2. 시나리오 도출: 어떤 타이밍에 문제가 발생하는지 시퀀스 작성
  3. 영향 평가: 각 버그의 심각도와 발생 가능성 평가
  4. 문서화: bug-analysis.md에 분석 결과 기록

수정 원칙

  • Deduplication: pending Map에 Promise를 저장하여 동일 키 요청 중복 방지
  • Resource Cleanup: try/finally로 에러 시에도 pending 상태 정리 보장
  • Atomic Operations: 캐시 삭제와 새 값 설정을 원자적으로 처리
  • Helper Extraction: 공통 fetch 로직을 _fetch() 헬퍼로 추출하여 DRY

수정 전 반드시

  • 버그를 분석하고 문서화할 것
  • 중복 코드는 헬퍼 메서드로 추출할 것
  • 테스트는 동시성 시나리오를 반드시 포함할 것

상세 코드 패턴은 references/patterns.md 참조.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

revfactory/claude-code-harness

interpreter-design

Programming language interpreter design and implementation guide. Use when the user requests building an interpreter, parser, lexer, or language implementation — including Pratt parsing, AST evaluation, scope chains, and closures.

88 14
Explore
revfactory/claude-code-harness

express-api-design

Express.js REST API design and implementation guide. Use when implementing REST API endpoints, creating Express routes, or setting up API project structure with MVC pattern.

88 14
Explore
revfactory/claude-code-harness

query-engine-design

SQL query engine design and implementation guide. Use when the user requests building a SQL engine, query parser, query planner, or query executor — including in-memory storage, SQL parsing, and query optimization.

88 14
Explore
revfactory/claude-code-harness

api-documentation

Write accurate and complete library API documentation. Use when creating API docs, README files, or function reference documentation. Ensures all signatures, parameters, return types, and examples are precise.

88 14
Explore
revfactory/claude-code-harness

reactive-spreadsheet-design

리액티브 스프레드시트 엔진 설계 가이드. 셀 수식 파싱, 의존성 그래프(DAG), 증분 재계산, 내장 함수 구현 시 사용한다.

88 14
Explore
revfactory/claude-code-harness

lsp-design

Language Server Protocol 서버 구현 가이드. LSP 서버, 증분 파싱, 자동완성, 진단, Go-to-Definition, 호버를 구현할 때 사용한다.

88 14
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results