feat(skills): add hwp-forge-donor-template-restore-build - #1305
Merged
Conversation
Encodes the HWP/HWPX institutional-form document procedure that was repeatedly re-invented as one-off zip/XML surgery scripts per document. - Path-selection rule: template inheritance vs donor restore vs from-scratch, with donor restore taking precedence when a prior canonical .hwpx exists (re-inheriting discards manual corrections). - Donor-restore surgery: replace_once uniqueness assertion (count 0 = stale donor, >=2 = unintended edits), <hp:p> nesting span calculation, full copy of remaining zip entries, placeholder-exhaustion assertion. - Warns that paraPr/charPr/borderFill IDs are per-donor measurements and must never be hardcoded across documents. - Verification requires both added-text presence AND removed-text absence, plus rendered-page visual check. Existing archive-document-template-reverse-engineering and generated-archive-document-content-verification cover generic zip/XML surgery only; a See-also cross-reference is added on the node copy. Classified claude-only in codex/compatibility.json (codex mirror candidate, none exists yet) per the fail-closed catalog gate. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
jinon86
force-pushed
the
skill/hwp-forge-donor-template-restore-build
branch
from
August 26, 2026 16:51
4d961be to
5de29a6
Compare
seoseo-ai
approved these changes
Aug 26, 2026
seoseo-ai
left a comment
seoseo-ai
left a comment
Collaborator
There was a problem hiding this comment.
Approved after explicit operator authorization using the local seoseo-ai credential.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
배경
HWP/HWPX 기관 양식 문서를 Linux 서버에서(한컴 한글 없이) 생성·개정하는 절차가 문서마다 일회성 스크립트로 재발명돼 왔습니다. 같은 문제를 서로 다른 임시방편으로 두 번 푼 사례가 근거입니다 — 하나는 hwp-forge 양식 상속 경로, 다른 하나는 기존 .hwpx에 직접 XML 문자열 수술(
make_v2.py/make_v3.py).기존
archive-document-template-reverse-engineering과generated-archive-document-content-verification은 일반 zip/XML 수술 절차만 다루며, 한글 양식 상속 경로 선택이나 도너 복원 기법을 담고 있지 않습니다.변경
claude/skills/hwp-forge-donor-template-restore-build/SKILL.md신규codex/compatibility.json에claude-only분류 등록 (fail-closed 카탈로그 게이트catalog_unclassified대응)스킬이 인코딩하는 것
.hwpx가 있으면 도너 복원이 우선(재상속하면 그동안의 수동 교정이 소실됨).replace_once유일성 단언(count 0 = 스테일 도너, ≥2 = 의도치 않은 오염),<hp:p>중첩 span 계산, 나머지 zip 엔트리 전량 복사, 플레이스홀더 소진 단언.paraPr/charPr/borderFillID는 도너별 실측값이라 문서 간 재사용 불가.분류 근거
claude-only/ "codex mirror candidate, none exists yet" —github-metered-billing-leak-diagnosis선례를 따랐습니다. 절차 자체는 런타임 중립이지만 codex 미러가 아직 없습니다.검증
scripts/validate-harness.sh2회 독립 실행 모두 exit 0, FAIL=0ok Codex compatibility catalog + managed-skill transaction tests통과/root/hwp-forge)는 일반화하고, 체크아웃이 없는 노드용 폴백을 명시했습니다.🤖 Generated with Claude Code