Skip to main content

​
Linear

ShanoneのLinear連携は、エージェントにイシュー管理、プロジェクト・サイクル管理、イニシアチブ、ドキュメントのための45個のツールを提供します。

​
はじめに

1

OAuthで接続する

エージェントにLinear関連の作業を依頼(例: 「このバグのイシューを作成して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

ワークスペースへのアクセスを許可する

Shanoneに操作させたいワークスペースについて、LinearのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、linear_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはLinear向けに45個のツールを、以下のカテゴリに整理して提供しています。
linear_create_issue, linear_get_issue, linear_update_issue, linear_delete_issue, linear_archive_issue, linear_unarchive_issue, linear_list_issues, linear_search_issues, linear_get_my_issues, linear_add_label_to_issue, linear_add_issue_to_cycle, linear_add_issue_to_project
linear_create_comment, linear_list_comments, linear_delete_comment
linear_create_project, linear_get_project, linear_update_project, linear_list_projects, linear_create_project_update, linear_list_project_updates, linear_list_project_labels
linear_create_initiative, linear_get_initiative, linear_update_initiative, linear_list_initiatives, linear_create_initiative_update
linear_list_cycles, linear_create_milestone, linear_get_milestone, linear_update_milestone, linear_list_milestones
linear_create_document, linear_get_document, linear_update_document, linear_list_documents, linear_search_documentation
linear_get_team, linear_list_teams, linear_get_user, linear_list_users, linear_get_viewer, linear_create_label, linear_list_labels, linear_list_workflow_states

​
よくあるユースケース

バグトリアージ

他所で見つかったスタックトレースやバグ報告から直接イシューを作成する

スプリントレポート

サイクルのイシューを要約し、ステータス更新を投稿する

ツール間のフォローアップ

Notionの議事録やSlackのスレッドを、追跡可能なLinearイシューに変換する

ロードマップの可視化

イニシアチブやプロジェクトを問い合わせて「Q3の予定は?」に答える

​
トラブルシューティング

Linearのイシューには有効なteamIdが必要で、ワークフローによっては有効なstate IDも必要です。まずlinear_list_teamsとlinear_list_workflow_statesを呼び出して有効な値を取得するか、linear_create_issueのshanone_get_tool_schemaを確認してください。
その識別子をクエリとしてlinear_search_issuesを使うか、チームでフィルタしたlinear_list_issuesを使ってください——linear_get_issueはツールスキーマに特に記載がない限り、短い識別子ではなくLinear内部のイシューIDを想定しています。