mirror of
https://github.com/NomaDamas/k-skill.git
synced 2026-06-24 02:04:11 +00:00
Clarify HWP markdown verification in the feature guide
The feature guide already documented `--include-images`, but it did not spell out the verification rule as clearly as the skill doc. Add a feature-level verification checklist and tighten the regression test so repo docs stay aligned with the actual `hwpjs` inline-image behavior. Constraint: `hwpjs to-markdown --include-images` embeds images as base64 data URIs instead of writing sidecar files Rejected: Leave verification guidance only in `hwp/SKILL.md` | feature docs could drift without their own regression coverage Confidence: high Scope-risk: narrow Reversibility: clean Directive: Keep the feature-guide verification text aligned with `npx --yes @ohah/hwpjs to-markdown --help` if the CLI flag behavior changes Tested: node --test scripts/skill-docs.test.js; npx --yes @ohah/hwpjs to-markdown --help; npm test; npm run ci; npx --yes skills add . --list Not-tested: End-to-end conversion against a real `.hwp` fixture
This commit is contained in:
parent
b864be65e0
commit
48b8d8153e
2 changed files with 12 additions and 0 deletions
|
|
@ -76,6 +76,16 @@ hwpjs extract-images document.hwp -o ./images
|
|||
hwpjs batch ./documents -o ./output --format json --recursive
|
||||
```
|
||||
|
||||
## 결과 확인 포인트
|
||||
|
||||
- JSON 출력: 파일 생성 여부와 최상위 구조를 확인한다.
|
||||
- Markdown 출력: `--include-images` 를 썼다면 이미지 파일 경로가 따로 생기지 않아도 정상이며, Markdown 안 `data:` URI / base64 인라인 포함 여부를 확인한다.
|
||||
- HTML 출력: 파일 생성 뒤 브라우저에서 열리는지 확인한다.
|
||||
- 이미지 추출: 출력 디렉터리에 실제 이미지 파일이 생겼는지 확인한다.
|
||||
- 배치 처리: 입력 개수와 출력 개수가 크게 어긋나지 않는지 확인한다.
|
||||
|
||||
이미지를 별도 파일로 떨궈야 한다면 `--include-images` 대신 `--images-dir` 경로를 쓴다.
|
||||
|
||||
## 직접 제어가 필요한 경우
|
||||
|
||||
`hwp-mcp`는 Windows + 한글 프로그램 설치 환경에서만 고려한다.
|
||||
|
|
|
|||
|
|
@ -47,4 +47,6 @@ test("repository docs advertise the hwp skill", () => {
|
|||
assert.match(install, /--skill hwp/);
|
||||
assert.match(featureDoc, /--include-images/);
|
||||
assert.match(featureDoc, /(data:|base64)/);
|
||||
assert.match(featureDoc, /Markdown 출력.*(data:|base64)/);
|
||||
assert.doesNotMatch(featureDoc, /Markdown 출력.*이미지 (파일 )?경로 생성 여부 확인/);
|
||||
});
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue