Jira

​

概要

​

主な機能

• JIRA_CREATE_ISSUE
  • Jiraプロジェクトにイシュー（タスク・ストーリー・バグ・サブタスク）を作成します。
• JIRA_GET_ISSUE
  • イシューキー（例: PROJ-123）またはIDで単一イシューを取得します。
• JIRA_SEARCH_ISSUES
  • JQLクエリでイシューを検索します。拡張された/search/jqlエンドポイントを使用し、nextPageTokenによるページネーションに対応しています。
• JIRA_UPDATE_ISSUE
  • 既存イシューのフィールド（サマリー・説明・担当者・優先度・ラベル）を更新します。
• JIRA_TRANSITION_ISSUE
  • イシューのステータスを変更します（例: To Do → In Progress → Done）。オプションでコメントを付与できます。
• JIRA_ADD_COMMENT
  • イシューにコメントを追加します。プレーンテキストを入力すると自動的にAtlassian Document Format（ADF）に変換されます。
• JIRA_LIST_PROJECTS
  • アクセス可能なプロジェクトの一覧を取得してプロジェクトキーを確認します。

​

認証

​

例: イシューの作成と検索

- id: create_issue
  tool: JIRA_CREATE_ISSUE
  config:
    - name: base_url
      value: "https://your-domain.atlassian.net"
    - name: email
      value: "you@example.com"
    - name: api_token
      secret: "YOUR_JIRA_SECRET"
  input:
    - name: project_key
      value: "PROJ"
    - name: summary
      value: "ログインバグの修正"
    - name: issue_type
      value: "Bug"
- id: search_issues
  tool: JIRA_SEARCH_ISSUES
  config:
    - name: base_url
      value: "https://your-domain.atlassian.net"
    - name: email
      value: "you@example.com"
    - name: api_token
      secret: "YOUR_JIRA_SECRET"
  input:
    - name: jql
      value: "project = PROJ AND status = 'In Progress'"

​

備考

• ADF変換: 説明やコメントのリッチテキストフィールドにはプレーンテキストを入力できます。ツールが各行をAtlassian Document Formatの段落に自動変換します。
• 担当者の指定: JiraはユーザーをメールアドレスではなくアカウントID（accountId）で識別します。ユーザーのプロフィールURLに表示されるアカウントIDを指定してください。
• 少なくとも1回の副作用: JIRA_CREATE_ISSUEとJIRA_ADD_COMMENTは、ワーカーが再起動した場合に重複が発生する可能性があります。完全に1度だけの実行が必要な場合は、後続の処理で重複を排除してください。
• タイムアウト: すべてのリクエストはAbortSignal.timeoutによって30秒のタイムアウトが設定されています。