关于 kc-recover
为编码 Agent 提供谨慎的 Git 恢复流程,先保留当前工作,再按用户期望的状态恢复,并验证结果与外部影响。
主要功能
- 01检查分支、变更与历史记录
- 02恢复前保存当前工作
- 03避免破坏性历史改写
- 04验证恢复效果与外部状态
- 05依据记录重新应用更改
适用场景
- 01撤销指定的未提交更改
- 02恢复已记录的变更且保留历史
- 03检查 Git 无法恢复的外部状态
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ taehalim/ kc-skills --skill kc-recover安装后在 Claude Code 中输入/kc-recover确认已加载。
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
안전하게 복구하기
Git을 내부 안전장치로 사용하고 결과는 사용자가 이해할 수 있는 상태와 행동으로 설명한다. 복구는 변경 손실 위험이 있으므로 다른 스킬보다 보수적으로 진행한다.
진행
상태와 대상 확인
- 현재 브랜치, 변경 파일, 최근 기록과 보존된 변경을 Git에서 직접 확인한다.
- 사용자가 원하는 화면이나 동작 상태를 기준으로 복구 대상을 특정한다. commit hash나 Git 방식을 고르게 하지 않는다.
- 관련 없는 변경이 섞였는지, 안전하게 분리할 수 있는지 확인한다. 같은 파일의 같은 부분에 섞여 있으면 자동 복구하지 않는다.
- 데이터베이스, 파일 저장소, 환경변수, 배포 설정과 외부 서비스 상태가 함께 바뀌었는지 확인하고 Git으로 복구되지 않는 항목을 구분한다.
되돌리기
- 현재 작업이 사라지지 않도록 먼저 보존하고 보존 위치를 기록한다. 비밀 파일이나 ignored 파일을 강제로 추적하지 않는다.
- 미커밋 변경은 대상 범위를 안전하게 보존한 뒤 요청한 변경만 되돌린다.
- 기록된 변경은 이력을 지우지 않는 복구 방식을 사용한다.
reset --hard, 강제 checkout, 광범위한 삭제와 history rewrite는 사용하지 않는다. - 복구 후 사용자가 원한 동작과 영향을 받을 기존 핵심 동작을 확인한다.
- 복구되지 않은 외부 상태와 다시 적용할 수 있는 지점을 보고한다.
다시 적용하기
- 직전 복구 기록과 현재 변경을 확인하고 충돌 가능성이 있으면 현재 작업을 먼저 보존한다.
- 기록된 stash 또는 복구 commit을 이용해 변경을 다시 적용한다. 기억이나 추측으로 코드를 재작성하지 않는다.
- 재적용된 동작을 확인하기 전에는 보존 기록을 삭제하지 않는다.
안전한 기준점이나 복구 기록이 없으면 임의로 정상 상태를 추측하거나 재작성하지 않는다.
완료
복구한 상태, 보존한 현재 작업, 실제 확인 결과, Git으로 복구되지 않은 외부 상태와 다시 적용할 수 있는 지점을 보고한다.
评论
支持 Markdown