md-to-wiki — シンルーター(フェーズ2)
Markdown仕様書をドキュメントサイトに変換します。
トリガー: "wikiを構築", "ドキュメントを生成", "仕様を公開", "サイトを作成", "MarkdownからWiki", "図を描画", "フローチャート", "アーキテクチャ図", "状態図", "シーケンス図"
フェーズルーター
ユーザーのリクエストを解析し、どのパスを取るかを決定します。
lower=$(echo "$1" | tr '[:upper:]' '[:lower:]')
case "$lower" in
*"分からない"*|*"ヘルプ"*|*"おすすめ"*) ROUTE="onboarding" ;;
*"html"*|*"サイト"*|*"mkdocs"*|*"material"*) ROUTE="mkdocs" ;;
*"swagger"*|*"openapi"*|*"api"*) ROUTE="swagger" ;;
*"github wiki"*|*"wikiタブ"*) ROUTE="github-wiki" ;;
*"dokuwiki"*|*"doku"*) ROUTE="dokuwiki" ;;
*"pdf"*|*"印刷"*|*"本"*) ROUTE="pdf" ;;
*"参照"*|*"issue"*|*"pr"*|*"プル"*) ROUTE="references" ;;
*"デプロイ"*|*"公開"*|*"公開する"*) 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 Issue/PR参照でドキュメントを充実 |
deploy | agents/deploy.md | 生成したドキュメントをホスティングにデプロイ |
実行フロー
- オンボーディング → 質問を行う: プロジェクト名、ソースディレクトリ、想定読者(開発者/ステークホルダー/一般)、希望する形式。OSを一度検出し、
SKILL_DIR、SCRIPT_EXT、SCRIPT_RUNNERを保存。 - フォーマット生成 → 適切なフォーマットエージェントを読み込む。
scripts/内の付属スクリプトを$SCRIPT_RUNNERで使用。 - 参照 → ユーザーがIssue/PR参照を希望する場合、references.mdを読み込む。
- デプロイ → 生成後、deploy.mdを読み込んでホスティングを提供。
グローバル変数(オンボーディング中に一度設定)
SKILL_DIR— このスキルフォルダへの解決済みパスSCRIPT_EXT—.shまたは.ps1SCRIPT_RUNNER—""または"powershell -File"OS_TYPE—unixまたはwindowsPROJECT_NAME— ユーザーから取得SOURCES— 仕様ファイルへのパスAUDIENCE—developer、stakeholder、generalのいずれか
付属スクリプト
すべて.shと.ps1で位置引数を同一に受け付けます。
| スクリプト | 目的 |
|---|---|
discover-sources | ディレクトリをスキャンしてspec/project/codebase/quickファイルを検出 |
generate-mkdocs | 完全なmkdocs.yml + ページ構造を作成 |
generate-index | 想定読者に適したランディングページを構築 |
to-dokuwiki | MarkdownをDokuWiki構文に変換 |
to-pdf | 結合し、pandoc経由でPDFに変換 |
fetch-issues | GitHub Issue/PRメタデータをキャッシュ |
複数ディレクトリ入力
実行前に複数のソースディレクトリをmerged-specs/にマージします。
mkdir -p merged-specs && cp -r .specs/* docs/* merged-specs/
共有方法
md-to-wiki/を同僚の.config/opencode/skills/または.opencode/skills/にコピーします。依存関係はフォーマットによって異なります。