구현 스킬 (implement) — 승인된 변경만 실제 반영

implement는 반복 업무를 더 안정적으로 처리하기 위한 AI 에이전트 스킬입니다.

사용자가 “수정 진행해”, “구현해”, “이 계획대로 만들어줘”처럼 실제 변경을 명시적으로 승인했을 때 사용한다. 승인된 범위 안에서 파일을 수정하고, 작업에 맞는 확인을 거쳐 사용할 수 있는 상태로 마무리한다.

사용 방법

Codex나 호환되는 AI 에이전트의 스킬 폴더에 아래 SKILL.md 내용을 저장한 뒤, 설명에 포함된 트리거 문장으로 호출하세요.

사용 예:
implement 스킬 사용해줘.
이 작업은 implement 기준으로 진행해줘.

원본 위치

.codex/skills/implement/SKILL.md

SKILL.md

---
name: implement
description: 사용자가 “수정 진행해”, “구현해”, “이 계획대로 만들어줘”처럼 실제 변경을 명시적으로 승인했을 때 사용한다. 승인된 범위 안에서 파일을 수정하고, 작업에 맞는 확인을 거쳐 사용할 수 있는 상태로 마무리한다.
---

# Implement

## 목적

- 확정된 요구사항이나 승인된 계획을 실제 결과물로 완성한다.
- 기존 작업을 존중하면서 필요한 범위만 정확하게 수정한다.
- 작성으로 끝내지 않고 적절한 확인과 결과 보고까지 마무리한다.

## 시작 전 확인

- 사용자가 실제 수정을 명시적으로 승인했는지 확인한다.
- 승인된 계획, 확정된 요구사항과 관련 지침 문서를 읽는다.
- 현재 파일 상태와 사용자 또는 다른 작업자가 만든 변경을 확인한다.
- 필요한 파일, 명령과 모듈이 실제로 존재하는지 확인한다.

## 구현 원칙

- 승인된 범위 안에서 가장 단순하고 명확한 방법을 사용한다.
- 관련 없는 파일과 동작은 수정하지 않는다.
- 사용자나 다른 작업자가 만든 변경을 되돌리지 않는다.
- 계획에 없는 기능, 패키지와 대규모 리팩터링을 임의로 추가하지 않는다.
- 기존 구조를 무조건 따르지 말고, 명백한 문제를 발견하면 영향과 대안을 설명한다.
- 작은 작업을 불필요하게 여러 파일이나 계층으로 나누지 않는다.
- 이해하기 어려운 로직에는 무엇보다 왜 필요한지를 설명하는 주석을 남긴다.

## 진행 순서

1. 변경할 파일과 현재 동작을 확인한다.
2. 핵심 변경부터 작은 단위로 구현한다.
3. 연결된 파일과 사용처를 함께 갱신한다.
4. 작업 범위에 맞는 테스트, 정적 분석, 빌드 또는 수동 확인을 수행한다.
5. 오류가 발생하면 원인을 확인하고 범위 안에서 해결한다.
6. 변경 결과와 사용자가 확인할 내용을 정리한다.

## 멈추고 확인해야 할 때

- 요구사항 해석에 따라 결과가 크게 달라질 때
- 승인된 계획과 현재 구조가 중요한 부분에서 다를 때
- 데이터 삭제, 외부 배포, 결제, 메시지 전송 또는 권한 변경이 필요할 때
- 새로운 운영 의존성이나 큰 구조 변경이 필요할 때
- 사용자만 제공할 수 있는 정보나 인증이 필요할 때

## 완료 보고

- 무엇을 변경했는지 결과부터 설명한다.
- 중요한 파일과 사용자에게 보이는 변화를 짧게 정리한다.
- 실행한 확인과 결과를 알린다.
- 실행하지 못한 확인이 있다면 이유를 숨기지 않는다.
- 남은 작업이 없다면 불필요한 추가 기능을 제안하지 않는다.