コードを貼るだけで読みやすい日本語コメントを生成
Stenographyは、関数やクラスを貼り付けるだけでAIが処理内容を読み解き、自然言語の説明コメントを自動生成するコードドキュメント支援ツールです。OpenAI Developer AmbassadorのBram Adams氏が開発し、コードを保存せず通過させるpassthrough APIアーキテクチャを採用しているため、企業コードの取り扱いにも配慮されています。英語に加えて日本語コメントの生成にも対応しており、レガシーコードの読解、新規メンバーのオンボーディング、OSSへの貢献準備など、ドキュメント不足に悩むB2B開発チームに適しています。
主要機能
- 自動コメント生成：関数1個あたり数十秒で日本語/英語のdocstring相当の説明を生成。手作業で15-30分かかるドキュメント化が1分以内に短縮されます。
- エディタ統合：VS Code拡張やCLI、REST APIを提供。既存のCI/CDパイプラインやエディタワークフローに組み込め、コードレビューPR時の自動コメント補完にも応用可能です。
- 多言語対応：Python、JavaScript、TypeScript、Go、Rustなど主要言語に対応。出力言語も日本語と英語を選択でき、グローバル開発体制でも統一フォーマットで運用できます。
- passthrough設計：入力コードはサーバーに永続化されず処理後に破棄されるため、社内コードを扱う際のセキュリティ懸念を抑えられます。
編集部の検証メモ
公開されている料金プラン・APIドキュメント・他社ドキュメント生成ツール(Mintlify、Swimm、GitHub Copilot)を比較検討した結果、Stenographyは「単独のコメント生成」に特化している点で立ち位置が明確です。Copilotがコード補完中心、Swimmがリポジトリ単位のドキュメント自動化に強い一方、Stenographyは関数単位のスポット利用に低コストで使える設計が差別化ポイントです。想定ROIとして、レガシーコード200関数のドキュメント化を手作業(1関数20分)で行う場合は約66時間、Stenography活用で約3-5時間に圧縮可能と試算でき、エンジニア工数換算で20-30万円規模の削減効果が見込めます。
想定ユーザー
保守フェーズに入った中規模リポジトリを抱えるWeb・SaaS開発チーム、ドキュメント文化が育っていないスタートアップ、OSS貢献を強化したい個人開発者に向いています。一方、リポジトリ全体の体系的ドキュメントサイトを自動構築したいケースや、設計思想まで含めた長文ドキュメントを期待するケースでは、SwimmやMintlifyなど別カテゴリのツールが適しています。
