本文へスキップ
SpecifyDocs

最初のステップ

クイックスタート

GitHubから最初の文書を作成し、設計図をレビューして改善内容をコーディングエージェントにつなげます。

GitHubリポジトリから最初のドキュメントを作り、設計図をレビューして改善内容を残しましょう。生成結果は実際の実装と照合して読みます。

準備するもの

  • Specifyアカウントとワークスペース
  • Specifyに読み取りを許可したGitHubリポジトリ
  • GitHubを接続するワークスペース管理者権限

利用できる機能とプランは公式料金ページをご確認ください。

最初のドキュメントを作る

  1. ワークスペースのホームを開く

    ログインして使用するワークスペースを選びます。サイドバーのホームを開きます。

    リポジトリからドキュメントを作るワークスペースのホーム
  2. リポジトリを選ぶ

    GitHubからドキュメントを作成を選びます。初めての場合はGitHubを接続からアクセスを許可するリポジトリを選びます。接続済みなら一覧が表示されます。

    接続済みGitHubリポジトリを選択する画面
  3. ドキュメント作成を開始する

    リポジトリを選び、ドキュメントを作成を押します。デフォルトブランチのコードを読む依頼がチャットで始まります。日本語UIでは日本語の文書を依頼します。

  4. 保存された結果を確認する

    チャットで進行状況を確認し、生成された文書を開きます。ソースパス、主要機能、制限事項をリポジトリと照合します。エラーや質問があれば同じチャットで続けます。

設計図と改善ドキュメントにつなげる

チャットで次のように依頼してみましょう。

このリポジトリの主要な構成要素と呼び出しフローをアーキテクチャキャンバスにしてください。文書のソースパスを根拠にし、追加確認が必要な接続は質問として残してください。

設計図で意図と異なる部分を見つけたら、根拠と期待する動作を改善ドキュメントに整理します。コーディングエージェントがMCPで読み、実際のコードを修正できます。

コード変更時に更新するには、文書とキャンバスをそれぞれリポジトリに接続してください。作成時にリポジトリを使うことと、自動更新の接続は別です。自動更新は接続されたコンテンツを直接編集するので、完了後に編集履歴を確認します。

次のステップ