oscardlfr/AndroidCommonDoc

AndroidCommonDoc은(는) 무엇을 하나요?

Android/KMP 프로젝트를 위한 중앙 집중식 개발자 툴킷 — 40개의 AI 스킬, 17개의 Detekt 규칙, 크로스 플랫폼 스크립트, MCP 서버, 자동 동기화 엔진. 다중 프로젝트 생태계를 위한 L0 계층입니다.

개요

이 스킬은 여러 Android 및 Kotlin Multiplatform 프로젝트가 공통 도구, 지식 기반, 정적 분석 규칙, AI 통합을 공유할 수 있도록 설계되었습니다. 주요 목표는 개발 경험을 표준화하고 반복 작업을 자동화하며 프로젝트 전반에 걸쳐 일관된 품질을 보장하는 것입니다.

주요 기능

• 40개의 AI 스킬: 커스텀 AI 에이전트(예: Claude Code, Cursor)를 위한 미리 정의된 스킬로, 코드 리뷰, 리팩토링, 테스트 작성, 문서화 등을 지원합니다.
• 17개의 Detekt 규칙: Android/KMP에 특화된 맞춤형 정적 분석 규칙으로, 코드 품질과 모범 사례를 강화합니다.
• 크로스 플랫폼 스크립트: Android, KMP, iOS, 웹 프로젝트에서 공통으로 사용되는 유틸리티 스크립트(빌드, 린트, 테스트 등)입니다.
• MCP 서버: Model Context Protocol 서버를 통해 AI 도구와 통합되어, AI 에이전트가 프로젝트 컨텍스트, 파일, 규칙에 접근할 수 있습니다.
• 자동 동기화 엔진: 중앙 저장소(oscardlfr/AndroidCommonDoc)의 변경 사항을 각 프로젝트에 자동으로 동기화하는 엔진입니다. 동기화 규칙은 SKILL.md에 정의됩니다.

지원 플랫폼

• Android (네이티브)
• Kotlin Multiplatform (KMP)
• iOS (KMP 공유 코드)
• 웹 (KMP 공유 코드)

사용 방법

1. 저장소 추가: 프로젝트의 SKILL.md 파일에 이 저장소를 하위 모듈 또는 참조로 추가합니다.
2. 동기화 구성: SKILL.md에 동기화 규칙을 정의하여 중앙 도구와 규칙을 가져옵니다.
3. AI 스킬 활성화: AI 에이전트(Claude Code, Cursor, Codex 등)에서 원하는 스킬을 활성화합니다.
4. Detekt 규칙 적용: detekt.yml 설정 파일에 커스텀 규칙을 포함시킵니다.
5. MCP 서버 연결: MCP 서버를 시작하여 AI 도구와 통합합니다.

예시

# SKILL.md
skills:
  - name: oscardlfr/AndroidCommonDoc
    config:
      auto_sync: true
      detekt_rules: true
      mcp_server: true

# Detekt 규칙 가져오기
curl -O https://raw.githubusercontent.com/oscardlfr/AndroidCommonDoc/main/detekt/rules.yml

기여

버그 리포트, 기능 제안, 풀 리퀘스트는 GitHub 저장소에서 환영합니다.

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.