ordito-create-page
Ordito の 書き込みスキル(作成スキル, 仕様 §7.1)。新規 IR ドキュメント(ページ)を1つ作る(§3.2)。
いつ使うか / 使わないか
- 使う: ユーザーが「新しいページを追加する」ことに同意した後。まだ存在しない
doc(論理パス)を作る。 - 使わない: 既存ページの本文を直す(
ordito-update-block)/既存ページにブロックを足す(ordito-add-block)/ナビだけ並べ替える(ordito-edit-collection)/HTML を作り直す(ordito-generate)。 - このスキルは 確認しない。「このページを作りますか?」の y/n は呼び出すAIエージェントが尋ね、yes のときだけ呼ぶ。
- このスキルは 生成しない(§5.4)。
入力(JSON; stdin か --input <file>)
{
"doc": "guides/getting-started",
"title": "はじめに",
"blocks": [
{ "type": "heading", "level": 1, "text": "はじめに" },
{ "type": "paragraph", "text": "このページは…" }
],
"meta": { "order": 1, "tags": ["guide"] },
"nav": { "under": ["ガイド"], "order": 1 }
}
doc(必須): 新しいページの論理パス id。indexは予約で不可(§3.6)。既存 id と重複ならエラー。title(必須):meta.title。blocks(任意): 初期ブロック配列(語彙10種, §3.3)。idを省いたブロックは自動採番(b1,b2…)。meta(任意):order/tags/sourcesなどの追加メタ。title/updated_at/generated_atは本スキルが設定する(上書き)。nav(任意): 指定すると 同時にナビへ掲載する。under(グループ名の配列)配下に{ doc }を追加。order/label任意。省略時は**下書き(孤立ページ)**として作成(§3.7: 既定で生成対象外)。ir_dir/collection(任意): 省略時はordito.config.jsonから解決。dry_run(任意): true で書き込まずプレビューのみ。
出力(JSON)
{ ok, doc, created, file, in_nav, updated_at, generated:false, note }
in_nav:false のときは下書き。公開には ordito-edit-collection でナビ追加 → ordito-generate。
実行
echo '{"doc":"guides/getting-started","title":"はじめに","nav":{"under":["ガイド"]}}' \
| node "${CLAUDE_SKILL_DIR}/create-page.js"