ドキュメント生成の自動化

ソースコードを保守されるドキュメントに変えます。OpenCode はモジュールを読み、公開 API を抽出し、ドキュメントサイトにそのまま置けるリファレンス文書を書きます。

このレシピを使う場面

ソースを指定する

ドキュメント化するモジュールと出力先を OpenCode に伝えます。

src/services/ のすべてのエクスポート関数を文書化してください。それぞれについて、シグネチャ、パラメータ、戻り型、1 行の例を含むセクションを書き、docs/reference/services.mdx に出力してください。
書式を設定する

frontmatter と構造を指定し、出力がドキュメントシステムに合うようにします。
```
---
title: Services Reference
description: API reference for the services module.
---
```
正確性を確認する

OpenCode は真でない挙動を推論することがあります——各説明をコードと照合し、特にエッジケースを検証します。
ビルドに組み込む

生成ページをサイドバー/ドキュメントパイプラインに追加し、公開されるようにします。
更新を予定する

大きな変更後に同じプロンプトを再実行し、ドキュメントを同期させます。

src/services/ のすべてのエクスポートシンボルを読み、Markdown リファレンスを生成してください。それぞれにシグネチャ、パラメータ説明、戻り型、具体例を含めてください。挙動をでっち上げないでください——不明な場合は「要確認」と記載してください。