Community코딩 & 개발github.com

trkbt10/indexion-refactor

코드 작성 후 복사-붙여넣기 블록, 패키지 간 공유 코드, 불필요한 래퍼, 개념 수준의 단일 진실 공급원(SoT) 위반 등 세 가지 수준의 중복을 감지하고 정리합니다. indexion으로 감지하고, 수정하고, 검증합니다.

indexion-refactor란 무엇인가요?

이 스킬은 개발자가 코드베이스에서 중복을 체계적으로 탐지하고 제거할 수 있도록 설계된 AI 어시스턴트 도구입니다. 복사-붙여넣기 수준, 패키지 간 공유 코드, 불필요한 래퍼 및 추상화, 그리고 개념 수준의 단일 진실 공급원(SoT) 위반이라는 세 가지 주요 중복 계층을 식별합니다. indexion 기반 감지 엔진을 사용하여 중복을 정확히 찾아내고, 자동 리팩토링을 적용한 후 변경 사항의 무결성을 검증하는 워크플로우를 제공합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 코딩 에이전트와 호환되며, 대규모 코드베이스의 유지보수성과 일관성을 크게 향상시킵니다. 핵심 동작 방식은 '감지 → 수정 → 검증'의 반복 주기를 통해 점진적으로 중복을 제거하는 것입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/trkbt10/indexion-skills/tree/main/skills/indexion-refactor

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

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

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

문서

indexion-refactor은(는) 무엇을 하나요?

코드 작성 후 복사-붙여넣기 블록, 패키지 간 공유 코드, 불필요한 래퍼, 개념 수준의 단일 진실 공급원(SoT) 위반 등 세 가지 수준의 중복을 감지하고 정리합니다. indexion으로 감지하고, 수정하고, 검증합니다.

개요

indexion-refactor는 코드베이스 내 중복을 체계적으로 관리하기 위한 AI 에이전트 스킬입니다. 이 스킬은 다음 세 가지 계층에서 중복을 식별합니다:

  1. 복사-붙여넣기 블록: 코드가 단순히 반복되는 경우
  2. 패키지 간 공유 코드: 여러 패키지에 걸쳐 유사한 기능이 존재하는 경우
  3. 개념 수준 SoT 위반: 동일한 개념이 여러 방식으로 구현된 경우

작동 방식

  1. 감지: indexion 도구를 사용하여 코드베이스를 스캔하고 중복을 탐지합니다.
  2. 수정: 감지된 중복을 적절한 리팩토링 기법으로 제거합니다.
  3. 검증: 수정 후 코드가 정상 작동하는지 확인합니다.

지원 플랫폼

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

사용 예시

# indexion으로 중복 감지
indexion scan .

# 감지 결과 확인
indexion report

# 특정 수준의 중복만 선택적으로 정리
indexion fix --level copy-paste

참고 사항

  • 이 스킬은 코드베이스의 일관성을 유지하고 유지보수 비용을 줄이는 데 도움을 줍니다.
  • 각 중복 계층마다 서로 다른 리팩토링 전략이 적용됩니다.
  • 항상 수정 후 단위 테스트를 실행하여 검증하는 것이 좋습니다.

Individual skills in this repo

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

trkbt10/indexion-agent-orient

Generate and use a pre-edit structure brief so coding agents learn likely owners, consumer surfaces, and unsafe edit locations before implementing.

trkbt10/indexion-documentation

Documentation analysis — assess coverage, detect code-to-doc drift with plan reconcile, visualize dependencies with doc graph. Answers "what needs docs?" and "are docs still accurate?"

trkbt10/indexion-identity

Detect and review name/content drift in code using `indexion identity audit`, then plan verified renames, moves, folder changes, or splits.

trkbt10/indexion-kgf

Debug and inspect KGF specs — view tokenization results, parse trees, and extracted edges from source files. Use when adding/fixing language support or when indexion's analysis output looks wrong.

trkbt10/indexion-readme

README construction — initialize template structure, generate per-package READMEs from doc comments, plan writing tasks, assemble root README from docs/ and package READMEs via doc.json config, and verify edits with `plan drift`.

trkbt10/indexion-sdd

Generate SDD requirements from RFCs/specs and quantitatively verify implementation conformance. spec draft → spec align → spec verify → automated validation loop with codex/claude. Operate spec-to-impl drift gates as CI checks.

trkbt10/indexion-segment

Split text into contextual chunks for RAG/embedding pipelines. Document segmentation and section extraction using window, tfidf, punctuation, or hybrid strategies chosen by intent.

trkbt10/indexion-wiki

Project wiki lifecycle — create pages, track source changes with ingest, update stale pages, lint structural integrity, detect code-to-doc drift with reconcile, and manage search indexes. A runbook for navigating and maintaining the wiki as an agent.

관련 스킬