request-refactor-plan

request-refactor-plan에 대하여

request-refactor-plan은 mattpocock-skills-zh-cn 컬렉션(폐기된 경로)에 속하는 중국어 번역형 계획 수립 기술로, 사용자와 인터뷰를 통해 세부적인 리팩토링 계획을 작성한 뒤 이를 작은 커밋 단위로 나누어 GitHub 이슈로 저장합니다. 이 기술이 해결하려는 문제는 대규모 리팩토링을 한 번에 진행할 경우 발생할 수 있는 위험성입니다. Martin Fowler가 제시한 ‘각 리팩토링 단계를 가능한 한 작게 유지하여 프로그램이 항상 정상적으로 작동하는 상태를 확인할 수 있도록’ 하는 원칙에 따라, 이 기술은 점진적이고 항상 작동 가능한 단계들을 적용합니다.

실행 절차(단계는 생략 가능)는 다음과 같습니다: 사용자에게 문제와 잠재적 해결 방안을 설명하도록 요청하고, 저장소를 살펴보며 그들의 주장을 확인하고 현재 상태를 파악합니다. 그 다음 대안적인 옵션들을 제시한 뒤, 구현 방식에 대해 사용자와 철저히 논의합니다. 변경될 내용과 변경되지 않을 내용을 포함한 정확한 범위를 명확히 하고, 영향을 받는 영역의 테스트 커버리지를 확인한 뒤 커버리지가 부족할 경우 테스트 계획에 대해 질문합니다. 이후 구현 과정을 코드베이스가 항상 작동 가능한 상태를 유지하도록 하는 작은 커밋들로 나누고, 마지막으로 Problem Statement, Solution, Commits, Decision Document, Testing Decisions, Out of Scope, Further Notes 등의 항목이 포함된 제공된 템플릿을 사용해 GitHub 이슈를 생성합니다. 템플릿은 구체적인 파일 경로나 코드 스니펫을 의도적으로 제외했는데, 이는 해당 내용들이 빠르게 시대에 뒤처지기 때문입니다.

이 기술은 리팩토링을 계획하거나 리팩토링 관련 RFC를 작성하는 개발자 및 기술 리드들을 대상으로 하며, 엄격하고 인터뷰 중심의 접근 방식을 통해 안전하게 점진적으로 계획을 수립하여 오랫동안 보관할 수 있도록 해줍니다. 이 기술의 작동 방식은 저장소 탐색과 이슈 작성으로 구성되며, 파괴적이거나 민감한 작업은 수행하지 않습니다.

FAQ

이 기술은 무엇을 생성하나요?

Problem Statement, Solution, Commits, Decision Document, Testing Decisions, Out of Scope, Further Notes 등의 항목이 포함된 템플릿을 사용해 GitHub 이슈 형태로 저장된 세부적인 리팩토링 계획입니다.

이 기술은 어떻게 리팩토링을 안전하게 유지하나요?

Martin Fowler가 제시한 원칙에 따라 작업을 작은 커밋 단위로 나누어, 각 커밋이 코드베이스를 항상 작동 가능한 상태로 유지하도록 함으로써 리팩토링을 안전하게 진행합니다.

계획에는 특정 파일이나 코드가 언급되나요?

아닙니다. 템플릿은 구체적인 파일 경로나 코드 스니펫이 빠르게 시대에 뒤처진다는 점을 고려해 이를 의도적으로 제외했으며, 결정 사항, 모듈, 인터페이스, 동작 방식에 중점을 둡니다.

테스트와 관련해서는 어떻게 처리하나요?

영향을 받는 영역의 테스트 커버리지를 확인하고, 커버리지가 부족할 경우 사용자에게 테스트 계획에 대해 질문한 뒤 이슈에 테스트 관련 결정 사항들을 기록합니다.

사전 요구 사항은 무엇인가요?

탐색 및 인터뷰를 진행할 저장소와, 완성된 계획을 위한 GitHub 이슈를 생성할 수 있는 능력이 필요합니다.

All Files

2 filesSKILL.md1.5 KBViewagents/openai.yaml0.1 KBView