okf-seedling との連携

知識を育てる okf-seedling と、それを正確に仕立てる quarto-dsh の組み合わせ

概要

okf-seedling は、あなたのドキュメントを OKF（Open Knowledge Format）準拠の知識バンドル として育て、エージェントにも人間にも読める形で公開する Quarto テンプレートツールです。「知識は作るものではなく育てるもの」を掲げ、.qmd を単一の source of truth にして、人間用 HTML と機械用 OKF バンドルの二系統を出力します。

quarto-dsh は、その Quarto プロジェクトの 編集・レンダリングを「正確に・自動で」支えるハーネス です。この2つは補完関係にあります。

なぜ組み合わせると良いのか

okf-seedling の営み	quarto-dsh の役割
`.qmd` を source of truth にして執筆	`quarto-dsh scan` で記法を検査
OKF 準拠の品質を守る（validate-okf）	`quarto-dsh lint` で `_quarto.yml` を実在キーで検証
人間用 HTML と OKF バンドルを二系統出力	`quarto-dsh render` でレンダリングを自動化
GitHub Pages / Cloudflare Pages へ公開	`quarto-dsh ci` でデプロイ設定を生成
エージェント・RAG に知識を受け渡し	`quarto-dsh chat` で LLM エージェントが編集・検証を遂行

1. 執筆時の記法チェック

okf-seedling の概念バンドル（concepts/*.qmd）は、concepts/ ディレクトリと tools/okf-types.json にレジストリが置かれています。本文を書いたら quarto-dsh scan で callout 型・チャンクオプション・相互参照・Div の開閉を検査できます。

quarto-dsh scan concepts/playbook.qmd

2. 設定の正確性を保証

okf-seedling は _quarto.yml で二系統出力の設定を行います。誤ったキーが混入するとビルドに悩まされますが、quarto-dsh lint が実在キーだけを検証して誤記を即座に指摘します。

quarto-dsh lint

3. レンダリングとデプロイの自動化

ローカル: quarto-dsh render で _site/（人間用 HTML）と okf/（機械用バンドル）をまとめて生成
CI: quarto-dsh ci で GitHub Actions のデプロイ設定を生成し、push のたびに自動公開

4. LLM エージェントによる支援

quarto-dsh chat は DeepSeek エージェントが lint / scan / render を組み合わせてタスクを遂行します。okf-seedling の概念を書き足す際の下書き・検証・修正を依頼できます。

export DEEPSEEK_API_KEY=sk-...
quarto-dsh chat "concepts/api-endpoint.qmd を scan で検査して、問題を修正して"

ワークフロー例

1. quarto use template watanabe3tipapa/okf-seedling   # 育苗箱を用意
2. concepts/ に概念を執筆                             # 人間にも読める .qmd
3. quarto-dsh lint                                    # _quarto.yml を実在キーで検証
4. quarto-dsh scan concepts/*.qmd                     # 記法を検査
5. quarto-dsh render                                  # HTML + OKF バンドルを出力
6. quarto-dsh ci --dir .                              # GH Actions デプロイ設定
7. push → 自動公開 + validate-okf で準拠確認

まとめ

okf-seedling は「知識を育てる」箱 — 構造化・検証・二系統出力を担う
quarto-dsh は「知識を正確に仕立てる」ハーネス — 記法・設定の検証と自動化を担う
両方とも Quarto の .qmd を中心に据え、人間とエージェントの両方に読める知識 を育て・守る点で理念が一致しています

概要