w-api-docs について
w-api-docsは、APIドキュメントを保守するための開発スキルです。生成済みファイルではなく元となるスキーマやルートを変更し、生成処理と利用者向けドキュメントの更新を進めます。
主な機能
- 01情報源とジェネレーターの特定
- 02生成物ではなくスキーマやルートを編集
- 03生成処理の実行と差分の確認
- 04動作変更に応じた利用者向け文書の更新
活用シーン
- 01ルート変更後のAPIドキュメント改訂
- 02ソースからのOpenAPI生成物の再生成
- 03生成結果とリポジトリの差異確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/w-api-docsを入力して読み込まれたか確認します。
詳細
API ドキュメントは、信頼できる唯一の情報源（TypeBox／Fastify のルート、またはリポジトリで説明されている生成ツール）から更新してください。生成済みの OpenAPI、クライアント、SQL を直接編集しないでください。
- API ドキュメントの MDX と生成ツールの README を読みます。正となるソースと、
package.jsonに記載されている生成スクリプトを特定します。 - 生成済みの成果物ではなく、正となるスキーマまたはルートを変更します。
- ドキュメントに記載された生成コマンドを実行します。リポジトリに差分チェック用のスクリプトがある場合は、それも確認します。
- 動作が変わった場合に限り、利用者向けの MDX を更新します。認証、レート制限、バージョニングに関するポリシーを創作しないでください。
- ドキュメント：動作またはコマンドが変わった場合は
/w-docs。
コメント
Markdown 対応