Community코딩 & 개발github.com

CodeQuality

모든 저장소에 적용 가능한 코드 품질 향상 루프. 도구 렌즈(린터, 타입 검사기, 보안, 데드코드 및 중복 스캐너; P0 보안 → P1 정확성 → P2 유지보수 순서로 수정)와 원칙 렌즈(SOLID + 클린 코드 냄새; 한 번에 하나의 원칙, 제안 → 확인 → 적용, 특성화 테스트 뒤에)라는 두 가지 관점을 제공합니다. 무료 로컬 도구 목록 하나, 스캔 한 번, 수정 루프 하나, 필수 품질 개선 보고서 하나. 코드 품질 향상, 코드 분석, 린트 수정, 중복 감소, 타입 추가, 보안 스캔, 테스트 커버리지, 리팩터링, 코드 설계 개선, SOLID 적용, 클린 코드 리팩터링, 복잡성 감소, 코드 스멜 제거, 코드 유지보수성 향상, 레거시 코드 리팩터링, 단일 책임, 의존성 역전, 개선 스프린트, 품질 도구 설치, 품질 기준선, 스멜 보고서, 리팩터링 로드맵, 무엇을 먼저 수정해야 할지 결정할 때 사용하세요. 이슈 생명주기, 브랜치, PR 또는 병합에는 사용하지 마세요(IssueFlow 사용; 해당 워크플로의 Remediation은 이 스킬을 호출하여 작업을 선택하고 범위를 지정합니다).

CodeQuality란 무엇인가요?

이 스킬은 저장소의 코드 품질을 향상시키기 위한 포괄적인 루프를 제공합니다. 크게 두 가지 관점(렌즈)으로 작동합니다. **도구 렌즈**는 린터, 타입 검사기, 보안 스캐너 등 실제 도구를 사용하여 발견된 문제를 P0(보안) → P1(정확성) → P2(유지보수) 우선순위로 수정합니다. **원칙 렌즈**는 SOLID 원칙과 클린 코드 스멜을 기반으로 코드 설계를 개선하며, 변경 사항을 적용하기 전에 항상 제안하고 확인합니다. 스캔, 선택, 수정, 보고의 반복 루프로 구성되며, 모든 작업은 기존 테스트를 통과해야 합니다. 특히 리팩터링 시에는 특성화 테스트를 먼저 작성하여 동작을 보존합니다. 출력물로 보고서 디렉토리에 요약, 스멜 인벤토리, 로드맵, 세션 로그, 그리고 필수 품질 개선 보고서를 생성합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 코딩 에이전트와 함께 사용하도록 설계되었으며, 모든 도구는 무료이고 로컬에서 실행됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/CodeQuality

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

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

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

문서

사용자 정의

선택적 개인 환경 설정: ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/CodeQuality/PREFERENCES.md.

해당 파일이 존재하면 읽고 적용하고, 그렇지 않으면 스킬 기본값을 사용합니다. 개인 환경 설정만 해당됩니다. 저장소나 제품에 대한 사실은 해당 저장소(.claude/workflow-profile.sh 또는 도구 구성)에 속하며, 여기에 절대 두지 마세요.

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

하나의 루프, 두 개의 렌즈. 루프는 항상 감지 → 하나의 항목 선택 → 테스트 뒤에서 수정 → 검증 → 반복입니다. 도구 렌즈는 스캐너가 플래그한 내용을 우선순위에 따라 기존 테스트를 보호막으로 삼아 수정합니다. 원칙 렌즈는 코드를 변경하기 어렵게 만드는 요소(갓 클래스, 중복, 테스트 불가능한 코어)를 SOLID/클린 코드 원칙 중 하나씩 수정하며, 설계 변경을 미리 보여주지 않고 적용하지 않습니다. 두 렌즈 모두 동일한 도구 목록을 읽고, 동일한 보고서 디렉토리에 쓰며, 동일한 품질 개선 보고서로 끝납니다.

두 가지 렌즈

도구 렌즈원칙 렌즈
드라이버스캐너 출력 (summary.md)Principles.md에 매핑된 설계 스멜 (smell-inventory.md, roadmap.md)
작업 단위하나의 발견: 하나의 규칙, 하나의 파일:라인하나의 제한된 핫스팟에 하나의 원칙: 하나의 Extract, 하나의 클래스 분할, 하나의 의존성 역전
순서P0 보안 → P1 정확성 → P2 유지보수레버리지 사다리(아래 참조), 저장소별 조정
자율성수정 후 diff 표시제안 → 확인 → 적용; 승인 전에는 아무것도 편집되지 않음
안전망기존 테스트는 계속 통과대상이 테스트되지 않은 경우 먼저 특성화 테스트 작성
지표발견 수 감소, 도구 재실행 시 클린중복률, 순환 복잡도, 함수 길이, 팬인/팬아웃, "이제 단위 테스트 가능"
사용 시기린트/타입/보안 부채, CI 빨간불, "스캐너를 만족시켜라"변경에 저항하는 코드, 개선 스프린트의 구조적 계층

루프

SCAN → SELECT → SAFETY NET → [PROPOSE → CONFIRM] → FIX → VERIFY → REPORT → REPEAT
                             └─ 원칙 모드에서는 필수, 도구 모드에서는 건너뜀 ─┘

워크플로 라우팅

트리거워크플로생성물
"품질 도구 설치", "코드 품질 설정"Workflows/Install.md도구 목록이 설치되고 확인됨
"스캔", "기준선", "코드 품질 분석", "스멜 보고서", "무엇을 먼저 수정할까", "리팩터링 로드맵"Workflows/Scan.mdsummary.md (A), smell-inventory.md (B), roadmap.md (C)
"코드 품질 향상", "린트 수정", "품질 루프", "[발견] 수정"Workflows/Loop.md 도구 모드수정, session-log.md, 보고서
"리팩터링", "SOLID 적용", "정리", "루프 시작"Workflows/Loop.md 원칙 모드수정, session-log.md, 보고서
"이 저장소 정리" (한정어 없음)Scan A + B + C, 이후 원칙 모드 Loop위의 모든 것
"개선 스프린트", "개선 사이클"IssueFlow Remediation이 브랜치, PR 및 병합을 소유; Scan이 사이클 범위 지정, Loop가 실행사이클당 하나의 PR

루프는 주어지지 않은 경우 자체적으로 모드를 선택합니다. 저장소에 roadmap.md가 없으면 도구, 있으면 원칙입니다. 사용자는 둘 중 하나를 강제할 수 있습니다.

도구 목록

Tools/tools.tsv는 이 스킬의 유일한 도구 목록입니다. 탭으로 구분되며, 언어 및 도구당 한 행: language category priority tool install run notes. language는 js | python | yaml, category는 lint | format | types | security | deadcode | duplication | complexity | deps | coverage, priority는 P0 | P1 | P2입니다. 두 스크립트 모두 이를 읽습니다. 워크플로는 도구를 인라인으로 나열하지 않습니다. 도구를 추가하거나 제거하려면 한 행을 편집하세요.

스크립트목록에서 읽는 항목수행 작업
Tools/install-quality-tools.sh [--dry-run] [lang ...]선택한 언어의 install 셀언어 감지(package.json → js; pyproject.toml, requirements.txt 또는 *.py → python; *.yaml/*.yml → yaml); 저장소의 패키지 관리자(lockfile → npm/pnpm/bun)로 js 도구를 devDependencies에 설치, python 및 yaml 도구는 uv pip install 또는 pip로 설치; npm:/pip: 접두사는 채널을 재정의, -는 아무것도 설치하지 않음
Tools/run-quality-baseline.sh [--dry-run] [lang ...]run 셀모든 도구를 reports/codequality/<YYYY-MM-DD>-<HHMMSS>/에 실행, $OUT(보고서 디렉토리), $SRC(QUALITY_SRC_DIRS, 기본값 src(존재하는 경우) 또는 .), $PM 및 $NPX를 대체; 설치되지 않은 도구는 MISSING, 충돌하는 도구는 FAILED, 둘 다 실행을 중단하지 않음; 도구별 상태, 파싱된 이슈 수 및 P0/P1/P2 합계가 포함된 summary.md 작성; 보고서 경로 출력

run이 -인 행(커버리지 도구)은 설치되지만 기준선에서 실행되지는 않습니다. 커버리지는 Loop에서 대상 범위 내에서 측정됩니다. 모든 도구는 무료이며 로컬로 실행됩니다. npm audit, pip-audit 및 checkov는 취약점 데이터베이스에 대해서만 네트워크에 연결됩니다.

레버리지 사다리 (원칙 렌즈 기본 순서)

  1. 이름 — 읽을 수 없는 코드는 안전하게 변경할 수 없습니다. 저렴하고 모든 것을 차단 해제합니다.
  2. DRY / 중복 — 가장 낮은 위험으로 가장 많은 코드를 제거합니다. 숨겨진 추상화를 드러냅니다.
  3. 작은 함수 — 긴 메서드 → Extract; 함수당 하나의 추상화 수준.
  4. SRP — 둘 이상의 이유로 변경되는 클래스와 모듈을 분할합니다.
  5. OCP / DIP — 의존성을 역전시키고, 이음새를 추가합니다. 높은 영향, 더 높은 위험, 먼저 안전망.
  6. ISP / LSP — 두꺼운 인터페이스와 깨진 대체 가능성; 5단계의 이음새가 필요합니다.

Scan 파트 C는 실제 인벤토리에 따라 이 순서를 조정합니다(레버리지 = 영향 ÷ 위험; Principles.md 파트 3 참조).

불가침의 원칙

  • 반복당 하나의 항목. 하나의 발견, 또는 하나의 제한된 대상에 하나의 원칙. 작고 검토 가능한 diff.
  • 동작 보존. 구조는 변경되지만 동작은 변경되지 않습니다. 동작이 변경되어야 하면 중단하고 플래그를 지정하십시오. 그것은 수정이 아니라 기능입니다.
  • 초록에서 초록으로. 변경 전후로 테스트가 통과합니다. 변경 후 빨간색은 되돌리기를 의미하며, 절대 앞으로 수정하지 않습니다.
  • 특성화 테스트 먼저 수정할 라인이 테스트되지 않은 경우. 안전망 없음, 리팩터링 없음.
  • 설계 변경 전 제안 (원칙 모드). 도구 모드는 직접 수정한 후 diff를 표시할 수 있습니다.
  • P0 → P1 → P2 도구 발견의 경우, 언어를 넘어서, 언어별로가 아닙니다.
  • 초록색을 얻기 위해 테스트나 린트 규칙을 약화시키지 마십시오. 오래된 테스트는 새로운 올바른 동작으로 이동합니다. 규칙은 코드에서 충족됩니다.
  • 보이 스카우트, 범위 제한. 건드린 파일은 더 깨끗하게 남겨두되, 현재 항목을 넘어 범위를 확장하지 마십시오.
  • 증거, 의견이 아닙니다. 규칙이나 원칙의 이름을 지정하고, 존재하는 경우 지표를 제시하십시오.

출력 아티팩트

모두 reports/codequality/ 아래에 있습니다(git 무시됨):

파일작성자
<YYYY-MM-DD>-<HHMMSS>/summary.md + 원시 도구 출력run-quality-baseline.sh (Scan A)
<YYYY-MM-DD>/smell-inventory.mdScan B
<YYYY-MM-DD>/roadmap.mdScan C
<YYYY-MM-DD>/session-log.mdLoop, 반복당 하나의 항목
<YYYY-MM-DD>/quality-report.mdLoop, 세션 종료 시 (아래)

품질 개선 보고서 (필수)

모든 Loop 세션은 이 보고서로 종료되며, 어느 모드든지 상관없습니다. 이것은 코드 변경과 함께 제공되는 결과물이며, 작업이 IssueFlow를 통해 전달될 때 PR 또는 트래커 댓글의 본문입니다.

섹션내용
요약 표추가/제거/순 라인 수; 우선순위별 이슈 전 → 후; 제거된 데드코드 핫스팟; 테스트 전 → 후(개수, 모두 초록색)
제거된 코드파일, 내용, 라인, 위험
추가 또는 수정된 코드파일, 내용, 라인, 목적
수정된 버그심각도, 설명, 근본 원인 (발견된 경우에만)
복잡도 델타최대 및 평균 순환 복잡도 전 → 후, 핫스팟당 ASCII 막대 포함
연기됨발견되었지만 범위를 벗어난 항목과 그 이유

Individual skills in this repo

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

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

MeetingAnalysis

Turn meetings into structured summaries and tracked action items. Transcribes recordings locally (faster-whisper on CUDA, Apple Silicon or CPU), imports Google Meet / Gemini notes through connectors, or takes pasted notetaker transcripts; writes a summary with decisions and an action table; pushes only your own items to the BattlePlan tracker. Includes an unattended inbox ingest (drop a recording, get a summary) and a hard rule that recordings never land in a git repo. USE WHEN analyze meeting, meeting summary, transcribe meeting, transcribe recording, summarize this call, what happened in the meeting, import meeting notes, Gemini notes, Google Meet notes, import meetings to tracker, auto ingest meetings, meeting inbox, process recordings folder, set up meeting analysis.

관련 스킬