名称： jira-ai
版本： 1.0.0
描述： 用于与 Atlassian Jira 和 Confluence 交互的命令行工具
主页： https://github.com/festoinc/jira-ai
元数据： {"moltbot":{"emoji":"🎫","category":"productivity","api_base":"https://github.com/festoinc/jira-ai"}}

Jira-AI 技能

jira-ai 技能提供了对 Atlassian Jira 和 Confluence 平台的全面命令行访问，使代理能够高效地管理问题、项目、用户和文档。

安装

要安装 jira-ai，请运行：

npm install -g jira-ai

身份验证设置

在使用 jira-ai 之前，需要配置您的 Jira 凭据：

1. 创建一个包含以下值的 .env 文件：
   JIRA_HOST=your-domain.atlassian.net JIRA_USER_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token

2. 使用 .env 文件进行身份验证：
   bash jira-ai auth --from-file path/to/.env

配置

您可以使用 settings 命令管理设置：

jira-ai settings --help

从 YAML 文件应用设置：

jira-ai settings --apply my-settings.yaml

验证设置：

jira-ai settings --validate my-settings.yaml

命令概览

顶层命令

问题管理 (issue)

项目管理 (project)

用户管理 (user)

组织管理 (org)

Confluence 命令 (confl)

使用示例

搜索分配给当前用户的问题

jira-ai issue search "assignee = currentUser()"

获取特定问题的详情

jira-ai issue get PROJ-123

创建新问题

jira-ai issue create --project "PROJ" --summary "新任务" --issuetype "Story"

将问题过渡到新状态

jira-ai issue transition PROJ-123 "进行中"

向问题添加评论

jira-ai issue comment PROJ-123 --file comment.md

列出所有项目

jira-ai project list

获取用户的工作日志

jira-ai user worklog john.doe@example.com 2w

配置选项

jira-ai 工具支持通过设置文件进行广泛配置。您可以定义：

• 允许的 Jira 项目
• 允许的命令
• 允许的 Confluence 空间
• 各种操作的默认行为

示例设置结构：

defaults:
  allowed-jira-projects:
    - all                     # 允许所有项目
  allowed-commands:
    - all                     # 允许所有命令
  allowed-confluence-spaces:
    - all                     # 允许所有 Confluence 空间

organizations:
  work:
    allowed-jira-projects:
      - PROJ                  # 允许特定项目
      - key: PM               # 项目特定配置
        commands:
          - issue.get         # 仅允许读取问题
        filters:
          participated:
            was_assignee: true
    allowed-commands:
      - issue                 # 所有 issue 命令
      - project.list          # 仅 project.list 命令
      - user.me               # 仅 user.me 命令
    allowed-confluence-spaces:
      - DOCS

优势

• 高效的 API 使用：最小化执行常见操作所需的 API 调用次数。
• 批量操作：一次处理多个项目以减少 API 使用。
• 智能筛选：使用 JQL 仅检索所需的具体数据。
• 本地处理：在向 Jira 发送针对性请求之前，先在本地处理操作。
• 基于配置的访问控制：定义允许的命令和项目，防止未经授权的操作。
• 特定命令定位：仅获取所需信息，减少负载大小和 API 使用。

安全注意事项

• 将 API 令牌安全地存储在环境文件中。
• 使用基于配置的访问控制来限制操作。
• 定期轮换 API 令牌。
• 将权限限制在操作所需的最低限度。