chore(skills): Reverse Sync 디버깅 워크플로우 스킬 추가

[jk-kim0]

Description

• reverse_sync_cli.py verify 실패 시 원인을 분석하고 수정하는 디버깅 워크플로우 스킬을 추가합니다.
• .claude/skills/README.md에 새 스킬 항목을 추가합니다.

스킬 내용

• 사전 준비: Confluence 원문 최신화, 대상 브랜치 준비
• 검증 실행: verify --branch 배치 검증 및 결과 판정
• 용어와 개념: page.xhtml, patched.xhtml, original.mdx, improved.mdx, verify.mdx, Forward Convert, XHTML Patch, Reverse Sync, Round-Trip Verification 정의
• 디버깅 절차 (7단계):
  1. 실패 문서에 대해 verify/debug 모드로 검증 결과 확인
  2. 테스트케이스 추가 (셸 기반 통합 테스트 또는 Python pytest 단위 테스트)
  3. commit 및 Draft PR 생성
  4. 실패 원인 분석 및 수정
  5. CI 워크플로우와 동일한 로컬 테스트 수행
  6. commit 및 PR 업데이트
  7. CI 확인 및 완료
• 실제 사례: PR confluence-mdx: reverse_sync verify 재실행 시 텍스트 중복 패치(idempotency) 수정 #845, confluence-mdx: flat list에서 inline code(backtick) 변경 누락 수정 #846, confluence-mdx: reverse_sync find_insert_pos offset 매핑 누락으로 bracket 위치 오류 수정 #847 참조

Related tickets & links

• PR confluence-mdx: reverse_sync verify 재실행 시 텍스트 중복 패치(idempotency) 수정 #845, confluence-mdx: flat list에서 inline code(backtick) 변경 누락 수정 #846, confluence-mdx: reverse_sync find_insert_pos offset 매핑 누락으로 bracket 위치 오류 수정 #847 — 디버깅 워크플로우의 실제 사례

Added/updated tests?

• Yes
• No, and this is why: 스킬 문서(마크다운) 추가이므로 테스트 불필요

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
querypie-docs	Canceled	Comment	Feb 25, 2026 0:39am