Docsalot

Docsalotとは？

Docsalotは、CLIとコーディングエージェント向けスキルを組み合わせて、ドキュメント作成のワークフローを自動化する開発者向けツールです。Claude CodeやCodexといったエージェントと連携し、自然言語のプロンプトでプロジェクトドキュメントの生成・更新・管理ができます。中心となる思想は「エージェントファースト」。CLIとスキルをインストールすれば、あとはコーディングエージェントがドキュメントの作成から公開まで一連のライフサイクルを担ってくれます。手動でのCLI操作は、トラブルシューティングや独自スクリプトを組むときなど、必要な場面だけ覚えればOKです。

Application scenarios

新規ドキュメントのセットアップ
エージェントに新しいドキュメント一式を作成させ、ローカルでプレビューを実行。
リモートへの公開
ドキュメントをリモートにプッシュし、チームやユーザー向けに公開。
既存ドキュメントの移行
指定パスにある既存ドキュメントをDocsalotの構成に変換し、ローカルでプレビュー。
コードからの自動生成
ソースコードの変更をエージェントに解析させ、関連ドキュメントを自動作成。
カスタムドメイン設定
ドキュメントを自前のドメインに向け、必要なDNSレコードを取得し、DNS反映後に検証。
ドキュメント再編成
現在のドキュメントを取得し、ナビゲーションを再構成してlayout.jsonを更新。
APIリファレンス生成
OpenAPI仕様からAPIリファレンスページを追加し、結果をプレビュー。
PRベースの更新
プルリクエストの変更内容に基づいてドキュメントを更新。
CI/CD自動化
docsフォルダのGitHub自動公開を設定し、承認済みバージョンを自動で公開。

Core Features

エージェントファーストの導入
`npm install -g docsalot-cli`でCLIをグローバルインストールし、`docsalot skills install`を実行するだけで、検出されたコーディングエージェント用のスキルがセットアップされます。
自然言語でのコマンド実行
エージェントが作成・取得・プレビュー・プッシュ・公開・移行などの適切なDocsalotコマンドを自動選択。CLIのコマンドを暗記する必要はありません。
対話型の認証処理
ブラウザログインや認証確認、ドキュメントIDの選択など、必要なときだけエージェントがユーザーに確認を求めます。
ローカルプレビュー
プッシュや公開前に、ローカル環境でドキュメントのプレビューを実行して変更内容を確認可能。
移行ワークフロー
エージェント主導の単一コマンドで、既存ドキュメントをDocsalotの構成に移行。
カスタムドメイン対応
独自ドメインを設定し、追加すべきDNSレコードを取得。準備ができたら検証まで実行。
OpenAPI連携
OpenAPI仕様からAPIリファレンスページを直接生成。
GitHub自動公開
docsフォルダの自動公開を設定し、承認済みバージョンを手動操作なしで公開。
手動CLI操作
細かい制御が必要なユーザー向けに、インストール・認証・作成・保守・更新・公開・トラブルシューティングのマニュアルページを用意。

対象ユーザー

Docsalotは、Claude CodeやCodexといったコーディングエージェントをすでに活用している開発者や技術チーム向けのツールです。ドキュメント作業をエージェントに任せたい個人開発者から、プロジェクト横断で一貫した自動ドキュメント運用を求めるチームまで幅広く対応します。CI/CDパイプラインをスクリプト化しているDevOpsエンジニアやテクニカルライターにとっても、手動CLIコマンドでの自動化は大きなメリットになるでしょう。要するに、プロジェクトドキュメントの保守に携わっていて、反復的な手作業を減らしたい人なら誰でも活用できます。

Docsalotの使い方

CLIをグローバルインストール：npm install -g docsalot-cli
インストール確認：docsalot --version
コーディングエージェント用スキルのインストール：docsalot skills install
エージェントに自然言語で指示。例：「docsalot cliを使って新しいドキュメント一式を作成してプレビューを実行して」や「docsalot cliでこのドキュメントをリモートにプッシュして公開して」
認証やブラウザログイン、ドキュメントIDが必要な場合は、適切なタイミングでエージェントがユーザーに確認を求めます。
より細かい制御が必要な場合は、マニュアルページを参照して正確なコマンドを確認したり、CI自動化のスクリプトを組んだり、トラブルシューティングを行います。

効果レビュー

Docsalotは、ドキュメント作成の負荷を開発者からコーディングエージェントへ移すという、実用的なアプローチが特徴です。エージェントファーストの設計により、新しいCLI構文を覚える必要はなく、やりたいことを自然言語で伝えるだけ。移行からOpenAPIリファレンス生成、カスタムドメイン設定まで、カバーするワークフローの幅は実務のニーズをほぼ網羅しています。対話型の認証モデルも合理的で、エージェントが重い処理を担いつつ、人間の入力が必要な場面ではきちんと引き継いでくれます。すでにClaude CodeやCodexを使っているチームなら、ドキュメントを最新に保つ手間を大幅に削減できるでしょう。唯一の注意点は、このツールの価値がエージェント駆動のワークフローへの慣れに依存していること。完全な手動制御を好む場合もCLIで対応できますが、本領はあくまでエージェント連携にあります。

Frequently Asked Questions

Docsalotとは何ですか？

Docsalotは、開発者がドキュメント作成のワークフローを自動化するためのCLIベースのツールです。ClaudeやCodexなどのコーディングエージェントと連携し、プロジェクトのドキュメントを効率的に生成・更新・管理できます。

Docsalotはコーディングエージェントとどう連携しますか？

Docsalotはスキルとして提供されており、ClaudeやCodexなどのコーディングエージェントに組み込むことができます。これにより、エージェントがワークフローの一環としてDocsalotのコマンドを呼び出し、ドキュメントの作成や更新を自動で行えるようになります。

Docsalotの主な機能は何ですか？

主な機能には、ドキュメントの自動生成、既存ドキュメントのシームレスな更新、プロジェクト全体のドキュメント管理、そして開発パイプラインへの統合を可能にするCLIベースの操作が含まれます。

Docsalotは特定のプログラミング言語やフレームワークに依存しますか？

Docsalotは言語非依存です。つまり、ツールがドキュメント構造を定義または生成できる限り、あらゆるプログラミング言語のプロジェクトで動作します。

DocsalotをCI/CDパイプラインで使えますか？

はい、使えます。DocsalotはCLIツールなので、CI/CDパイプラインに簡単に統合でき、コードがコミットされるたびにドキュメントを自動更新できます。

Docsalotの使い始め方は？

まず、npmまたはpipでDocsalot CLIをインストールし、プロジェクトに設定します。さらに、コーディングエージェントにDocsalotスキルを追加すれば、シームレスに統合できます。