abertanha/md-to-wiki-docs-skills

md-to-wiki — 씬 라우터 (2단계)

마크다운 스펙 문서를 문서화 사이트로 변환합니다.

트리거: "build wiki", "generate docs", "publish specs", "make a site", "wiki from markdown", "draw diagram", "flow chart", "architecture diagram", "state diagram", "sequence diagram"

단계 라우터

사용자 요청을 분석하여 어떤 경로를 취할지 결정합니다.

lower=$(echo "$1" | tr '[:upper:]' '[:lower:]')
case "$lower" in
  *"not sure"*|*"help"*|*"recommend"*)     ROUTE="onboarding" ;;
  *"html"*|*"site"*|*"mkdocs"*|*"material"*)  ROUTE="mkdocs" ;;
  *"swagger"*|*"openapi"*|*"api"*)          ROUTE="swagger" ;;
  *"github wiki"*|*"wiki tab"*)             ROUTE="github-wiki" ;;
  *"dokuwiki"*|*"doku"*)                    ROUTE="dokuwiki" ;;
  *"pdf"*|*"print"*|*"book"*)               ROUTE="pdf" ;;
  *"reference"*|*"issue"*|*"pr"*|*"pull"*)  ROUTE="references" ;;
  *"deploy"*|*"publish"*|*"go live"*)       ROUTE="deploy" ;;
  *)                                          ROUTE="onboarding" ;;
esac

그런 다음 적절한 에이전트를 실행합니다.

경로	에이전트	설명
onboarding	agents/onboarding.md	사용자 인터뷰, OS 감지, SKILL_DIR 설정
mkdocs	agents/format-mkdocs.md	MkDocs Material 사이트 생성
swagger	agents/format-swagger.md	OpenAPI 3.0 + Swagger UI 생성
github-wiki	agents/format-github-wiki.md	GitHub Wiki에 게시
dokuwiki	agents/format-dokuwiki.md	DokuWiki 형식으로 변환
pdf	agents/format-pdf.md	Pandoc을 통해 PDF 생성
references	agents/references.md	GitHub 이슈/PR 참조로 문서 보강
deploy	agents/deploy.md	생성된 문서를 호스팅에 배포

실행 흐름

1. 온보딩 → 질문: 프로젝트 이름, 소스 디렉토리, 대상 청중(개발자/이해관계자/일반), 원하는 형식. OS를 한 번 감지하고 SKILL_DIR, SCRIPT_EXT, SCRIPT_RUNNER를 저장합니다.
2. 형식 생성 → 적절한 형식 에이전트를 로드합니다. scripts/의 동반 스크립트를 $SCRIPT_RUNNER와 함께 사용합니다.
3. 참조 → 사용자가 이슈/PR 참조를 원하는 경우 references.md를 로드합니다.
4. 배포 → 생성 후 deploy.md를 로드하여 호스팅을 제공합니다.

전역 변수 (온보딩 중 한 번 설정)

• SKILL_DIR — 이 스킬 폴더의 확인된 경로
• SCRIPT_EXT — .sh 또는 .ps1
• SCRIPT_RUNNER — "" 또는 "powershell -File"
• OS_TYPE — unix 또는 windows
• PROJECT_NAME — 사용자로부터
• SOURCES — 스펙 파일 경로
• AUDIENCE — developer, stakeholder, 또는 general

동반 스크립트

모두 .sh와 .ps1에서 동일한 위치 인수를 허용합니다.

스크립트	용도
discover-sources	디렉토리에서 스펙/프로젝트/코드베이스/퀵 파일 검색
generate-mkdocs	전체 mkdocs.yml + 페이지 구조 생성
generate-index	대상 청중에 맞는 랜딩 페이지 구축
to-dokuwiki	마크다운 → DokuWiki 구문 변환
to-pdf	연결 + pandoc을 통해 PDF 변환
fetch-issues	GitHub 이슈/PR 메타데이터 캐싱

다중 디렉토리 입력

실행 전 여러 소스 디렉토리를 merged-specs/로 병합합니다.

mkdir -p merged-specs && cp -r .specs/* docs/* merged-specs/

공유

md-to-wiki/를 동료의 .config/opencode/skills/ 또는 .opencode/skills/에 복사합니다. 종속성은 형식에 따라 다릅니다.