WolfMarkDown은(는) 무엇을 하나요?
AI 출력물을 검토하고 보관할 준비가 된 전문 Markdown으로 변환하는 에이전트 출판 워크플로입니다.
구조에 대한 에이전트 판단. 검증을 위한 결정론적 도구.
AI 에이전트는 유용한 연구, 계획, 문서를 생성할 수 있지만, 평평한 비교, 일관성 없는 제목, 복사된 채팅 스캐폴딩, 깨진 펜스, 변경된 기술 식별자 등을 남길 수 있습니다.
WolfMarkDown은 에이전트에게 체계적인 출판 워크플로를 제공합니다:
- 에이전트가 의미, 구조, 정리, 구성을 결정합니다;
- 결정론적 도구가 결과 Markdown의 형식을 지정하고 유효성을 검증합니다;
- 보호된 콘텐츠, 롤백, 출판 경계가 결과를 보관하기 전에 확인됩니다.
결과는 마법 같은 Markdown 수리 엔진이 아닙니다. 아티팩트에 대한 결정론적 증명을 갖춘 에이전트 워크플로입니다.
WolfMarkDown이 존재하는 이유
Prettier는 훌륭한 Markdown 포매터입니다. 하지만 평평한 블록이 비교 테이블인지, 짧은 문장이 제목인지, 복사된 에이전트 메시지가 문서에 속하는지 판단할 수 없습니다.
WolfMarkDown은 이러한 결정을 명시적이고 보수적으로 만듭니다. 명확한 구조는 수리하고, 진정으로 모호한 자료는 보존하며, 복구된 내용을 보고합니다. 소스의 사실 여부를 확인하거나 출판을 승인하지 않습니다.
| 기능 | Prettier 단독 | WolfMarkDown |
|---|---|---|
| 결정론적 Markdown 포맷팅 | 예 | 예 |
| 의미론적 문서 구조 수리 | 아니요 | 예 |
| 복사된 AI 대화 스캐폴딩 제거 | 아니요 | 예 |
| 잘못된 비교 테이블 재구성 | 아니요 | 예 |
| URL, 코드, 해시, 버전, 식별자 보호 | 아니요 | 예 |
| GFM 파싱 및 펜스 균형 확인 | 아니요 | 예 |
| 출판 전 markdownlint 실행 | 아니요 | 예 |
| 멱등성 확인 | 아니요 | 예 |
| 실패한 Clean 후 원본 복원 | 아니요 | 예 |
| 실패한 Compose 출판 거부 | 아니요 | 예 |
WolfMarkDown은 이미 좋은 산문을 다르게 들리도록 다시 쓰지 않습니다. 목표는 결정론적 증명과 함께 안전하게 보관할 수 있는 최소한의 의미론적 정리입니다.
설치
npx skills add WolfMarkTools/WolfMarkDown --skill wolfmarkdown
skills CLI는 선택한 Agent Skills 호환 호스트의 정식 wolfmarkdown/ 스킬을 설치합니다. 저장소 체크아웃에서 직접 실행할 수도 있습니다:
npm ci --prefix wolfmarkdown
node wolfmarkdown/scripts/install.mjs
비대화형 Claude Code 설치:
npx skills add WolfMarkTools/WolfMarkDown \
--skill wolfmarkdown \
-g \
-a claude-code \
-y
설치 프로그램은 필요할 때만 런타임 종속성을 수리하고, 공유 .agents/skills/wolfmarkdown 검색 경로를 구성하며, Claude Code 호환성 경로를 구성하고, Windows에서는 적절한 경우 디렉터리 정션을 사용하며, 관련 없는 경로를 덮어쓰지 않습니다.
빠른 사용법
WolfMarkDown을 사용하여 docs/architecture.md를 처리하세요.
WolfMarkDown을 사용하여 이 연구를 Markdown으로 내보내세요.
WolfMarkDown을 사용하여 docs/architecture.md를 변경 없이 검증하세요.
호스트가 슬래시 명령어를 지원하는 경우, 동일한 워크플로를 다음과 같이 호출할 수 있습니다:
/wolfmarkdown docs/architecture.md
/wolfmarkdown verify docs/architecture.md
자연어 호출이 이식 가능한 인터페이스입니다. 슬래시 명령어 표시는 호스트마다 다릅니다.
작업
| 작업 | WolfMarkDown의 기능 |
|---|---|
| Compose | 소스 자료에서 실제 .md 파일을 생성하고, 채팅 전용 스캐폴딩을 제거하고, 형식을 지정하고, 검증하고, PASS 후에만 출판합니다. |
| Clean | 기존 Markdown 파일을 최소한의 의미론적 변경으로 수리하고, 검증 실패 시 원본을 복원합니다. |
| Verify | Markdown을 변경 없이 확인합니다. |
| Doctor | 런타임 종속성과 스킬 검색 경로를 설치 변경 없이 검사합니다. |
| Setup | 필요할 때만 런타임 종속성을 수리하고 공유 스킬 검색 경로를 구성합니다. |
일반적인 정리 대상에는 제목 계층 구조, 잘못된 목록, 깨진 GFM 테이블, 닫히지 않은 코드 펜스, 복사된 에이전트 설명, 대화에 의존하는 표현, 문서에 남아서는 안 되는 장식적 노이즈가 포함됩니다.
전후 비교
지저분한 에이전트 초안은 비교 내용을 하나의 블록으로 평평하게 만들 수 있습니다:
권장 사항 외부 지갑 흐름에는 relay_v2 사용.
비교 공급자 모드 위험 Privy 외부 승인 중간 CDP 내장 지갑 높음.
구현 참고 사항 relay_v2는 제출 후 getTransaction을 확인합니다.
에이전트가 구조를 명확히 한 후, WolfMarkDown은 다음과 같은 문서를 출판할 수 있습니다:
# 지갑 흐름 결정
## 권장 사항
외부 지갑 흐름에는 `relay_v2`를 사용하세요.
## 비교
| 공급자 | 모드 | 위험 |
| --- | --- | --- |
| Privy | 외부 승인 | 중간 |
| CDP | 내장 지갑 | 높음 |
## 구현 참고 사항
`relay_v2`는 제출 후 `getTransaction`을 확인합니다.
출력은 테이블과 제목을 복구하고, 기술 식별자를 보존하며, 소스에 없던 정보를 추가하지 않습니다. 이는 예시적인 구조적 예시입니다. 의미론적 판단은 여전히 에이전트 소유입니다.
예제
공개 예제는 WolfMarkDown이 실제 에이전트가 생성한 Markdown에서 의미를 발명하지 않고 구조를 복구하는 방법을 보여줍니다.
- 모바일 앱 마이그레이션 예제 — 채팅 래퍼 정리, 탭으로 구분된 테이블, 유니코드 글머리 기호, 보호된 환경 변수, 의도적으로 모호한 데이터베이스 메모를 포함한 완전한 전후 고정 예제입니다.
- 원시 입력 — 수리 전 AI 출력 원본입니다.
- 구조화된 출력 — 제목, GFM 테이블, 목록,
env코드 블록이 포함된 결과 Markdown입니다.
예제 README는 재현에 사용된 OpenCode 하네스, GLM-5.2 모델, 정확한 프롬프트를 기록합니다.
지원되는 에이전트 통합 상태
WolfMarkDown은 하나의 정식 구현을 가지고 있습니다. 다음 표는 저장소에서 테스트된 검색 경로와 전용 스모크 테스트가 필요한 호스트 수락 상태를 구분합니다.
| 호스트 | 통합 상태 | 검색 경로 |
|---|---|---|
| Codex | 저장소 검색 및 설치 프로그램 경로 테스트 완료 | 공유 .agents/skills |
| Cursor | 저장소 검색 및 설치 프로그램 경로 테스트 완료 | 공유 .agents/skills |
| Claude Code | 호환성 링크 경로 테스트 완료 | .claude/skills |
| OpenCode | 호스트 수락 대기 중 | 호스트에서 활성화 시 공유 .agents/skills |
| Gemini CLI | 호스트 수락 대기 중 | 호스트에서 활성화 시 공유 .agents/skills |
| GitHub Copilot | 호스트 수락 대기 중; 플러그인 수용은 역사적 증거 | 호스트에서 활성화 시 Agent Skills 또는 플러그인 지원 |
호스트 수락은 바이너리나 디렉터리의 존재로 유추되지 않습니다. 호스트 모델이 의미론적 품질을 결정합니다. WolfMarkDown은 워크플로와 결정론적 검사를 제공합니다.
작동 방식
사용자 의도
↓
에이전트 의미론적 판단
↓
소스 맵 및 의미론적 수리
↓
GFM 파싱 + 제목/테이블 검사
↓
펜스, 프론트매터 + 공백 검사
↓
Prettier 형식 검사
↓
markdownlint
↓
보호된 토큰 무결성(소스 스냅샷 포함) + 멱등성
↓
PASS → 유지 또는 출판 FAIL → 복원 또는 출판 금지
포맷팅 전에 에이전트는 평평한 의미 구조를 확인합니다. 문서가 유효한 Markdown이더라도 테이블, 제목, 목록, 관계를 잃어버렸다면 실패한 변환입니다.
의미론적 수리 경계
에이전트는 소스가 구조를 명확하게 할 때만 제목, 목록, 테이블, 단락, 형제 섹션을 재구성합니다. 헤더 없는 탭 실행이 자동으로 테이블이 되지 않고, 짧은 문장이 자동으로 제목이 되지 않으며, 고립된 레이블: 값 구문이 자동으로 목록 항목이 되지 않습니다. 문서가 긴 경우 에이전트는 소스 맵을 유지하고 전체 개요, 섹션 간 관계, 테이블 경계, 보호된 값을 출판 전에 조정합니다. 소스를 완전히 검토할 수 없는 경우 불확실성을 보존하고 추측하지 않고 한계를 보고합니다.
검증 및 품질 경계
WolfMarkDown PASS는 아티팩트가 적용 가능한 결정론적 검사를 통과했음을 의미합니다:
- Markdown 아티팩트가 형식 지정, 파싱, 린트, 펜스, 멱등성 검사를 통과했습니다;
- 에이전트가 소스에 근거한 구조적 결정을 내리고 보고했습니다;
- 보호된 기술 콘텐츠가 Clean 및 Compose 작업 또는
--integrity-from사용 시 변경되지 않은 소스 스냅샷에 대해 무결성이 확인된 경우에만 보존되었습니다; - 실패한 Clean 및 Compose 작업은 검증되지 않은 출판 결과를 남기지 않았습니다.
무결성 소스 없이 독립 실행형 Verify를 실행하면 무결성이 건너뛰기로 보고됩니다. PASS는 보호된 토큰이 보존되었음을 증명하지 않습니다.
보호된 세부 정보
변경되지 않은 소스 스냅샷을 사용할 수 있는 경우, 무결성 검사는 다음을 포함한 기술 콘텐츠를 보호합니다:
- URL, 인라인 코드, 펜스 코드;
- 공개 키, 서명, 해시, 버전, 식별자;
- 파일 시스템 경로 및 문맥상 환경 변수;
- 날짜, 백분율, 통화 값.
이는 Markdown 품질 증거이며, 콘텐츠 승인이 아닙니다. PASS는 사실적 정확성, 완전성, 최신성, 정책 준수 또는 출판 권한을 확립하지 않습니다. 사실 여부를 확인하지 않습니다.
결정론적 검사는 아티팩트 속성의 증거입니다. 의미론적 오라클이 아니며, 모든 명확한 소스 신호를 설명해야 하는 에이전트의 책임을 대체하지 않습니다.
v0.2.1 출시 증거
- 82/82 Node 테스트 통과.
- 실행 가능한 의미론적 속성 검사가 제목, GFM 테이블, 보호된 토큰, 모호한 테이블 보존을 다룹니다.
skills-ref validate ./wolfmarkdown통과.- 설치 프로그램, Doctor, 롤백, 대상 충돌, 무결성, 멱등성 검사가 계속 적용됩니다.
역사적 외부 플러그인 수용
v0.1.1 Agent Plugins 패키지는 GitHub Awesome Copilot의 자동화된 외부 플러그인 수용을 통과했습니다. 이는 v0.2.1의 호스트 수락 증거가 아니라 역사적 패키징 증거입니다.
아키텍처 세부 정보
WolfMarkDown/
├── plugin.json
├── .agents/
│ └── skills/
│ └── wolfmarkdown → ../../wolfmarkdown
├── skills/
│ └── wolfmarkdown → ../wolfmarkdown
└── wolfmarkdown/
├── SKILL.md
├── config/
├── lib/
├── references/
├── scripts/
└── tests/
에이전트 소유 결정
에이전트는 의도 라우팅, 소스 매핑, 의미론적 분류, 대화 정리, 제목/목록/테이블 복구, 모호성 처리, 구성을 소유합니다.
결정론적 증명
스크립트는 포맷팅, Markdown 린트, GFM 파싱, 펜스 균형, 프론트매터 검사, 보호된 토큰 무결성, 멱등성, 설치, Doctor 검사, 롤백, 속성 기반 의미론적 평가를 소유합니다. 소스 의미를 다시 쓰지 않습니다.
Prettier는 유일한 최종 프린터입니다.
머신 스킬 ID와 파일 시스템 디렉터리는 의도적으로 소문자 wolfmarkdown입니다. 제품 이름은 WolfMarkDown입니다.
의미론적 평가
평가 코퍼스는 깨지기 쉬운 전체 문서 스냅샷 대신 합성 문서와 구조적 속성을 사용합니다. 일반 검증기 이후 에이전트가 생성한 후보에 대해 케이스를 실행하세요:
node wolfmarkdown/scripts/evaluate-semantic.mjs \
--case ambiguous-structure-preservation \
source.md candidate.md
평가자는 예상되는 제목 및 테이블 수, 보호된 토큰 보존, 모호한 헤더 없는 실행을 테이블로 바꾸지 않는 것과 같은 안전 속성을 확인합니다. 후보를 유추하거나 수리하지 않습니다.
개발자 명령어
npm ci --prefix wolfmarkdown
npm test
npx --yes skills-ref validate ./wolfmarkdown
유용한 직접 명령어:
node wolfmarkdown/scripts/doctor.mjs
node wolfmarkdown/scripts/format-markdown.mjs path/to/file.md
node wolfmarkdown/scripts/verify-markdown.mjs path/to/file.md
node wolfmarkdown/scripts/evaluate-semantic.mjs --help
의미론적 케이스는 wolfmarkdown/tests/evals/에 있습니다. 교차 호스트 수락 입력은 wolfmarkdown/tests/acceptance/에 있습니다.
현재 경계
/wolfmarkdown setup은 스킬이 호스트에 의해 검색 가능해진 후에만 작동합니다.--mode는 지원되지 않습니다.- 벤더별 스킬 포크는 생성되지 않습니다.
- Windows에서는 적절한 검색 정션 생성을 위해 권한이 필요합니다.
- 의미론적 정리는 설계상 에이전트가 판단합니다.
- 검증기는 Markdown 아티팩트 속성을 증명합니다. 임의의 산문이나 출판 준비 상태를 인증하지 않습니다.
- 긴 문서 수리는 에이전트가 문서 원장을 유지하고 조정하는 데 달려 있습니다. 불완전한 소스 검토는 추측하지 않고 보고해야 합니다.
저장소 메타데이터
권장 GitHub 저장소 토픽:
ai-agents agent-skills markdown documentation claude-code codex cursor github-copilot
토픽은 GitHub 저장소 설정에서 구성해야 합니다. 이는 검색 가능성 메타데이터이지 호환성 증거가 아닙니다.
기여하기
WolfMarkDown이 더 잘 처리해야 할 Markdown 엣지 케이스를 찾으셨나요? 이슈를 열어주세요.
특히 재현 가능한 Markdown 실패, 무결성 엣지 케이스, 교차 플랫폼 설치 문제, 추가 호스트 수락 증거, 단일 구현 아키텍처를 유지하는 집중된 개선 사항에 대한 풀 리퀘스트가 유용합니다.
라이선스
WolfMarkDown은 MIT 라이선스에 따라 사용 가능합니다.