Jira-AI Skill
The jira-ai skill provides comprehensive command-line access to Atlassian Jira and Confluence platforms, allowing agents to manage issues, projects, users, and documentation efficiently.
Installation
To install jira-ai, run:
npm install -g jira-ai
Authentication Setup
Before using jira-ai, you need to configure your Jira credentials:
- Create a
.env file with the following values:
```
JIRA_HOST=your-domain.atlassian.net
JIRA_USER_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
```
- Authenticate using the .env file:
```bash
jira-ai auth --from-file path/to/.env
```
Configuration
You can manage settings using the settings command:
jira-ai settings --help
Apply settings from a YAML file:
jira-ai settings --apply my-settings.yaml
Validate settings:
jira-ai settings --validate my-settings.yaml
Commands Overview
Top-Level Commands
| Command | Description |
|---|
| :--- | :--- |
jira-ai auth | Set up Jira authentication credentials |
jira-ai settings | View, validate, or apply configuration settings |
jira-ai about | Show information about the tool |
jira-ai help | Display help for commands |
Issue Management (issue)
| Command | Description |
|---|
| :--- | :--- |
jira-ai issue get | Retrieve comprehensive issue data |
jira-ai issue create | Create a new Jira issue |
jira-ai issue search | Execute a JQL search query |
jira-ai issue transition | Change the status of a Jira issue |
jira-ai issue update | Update a Jira issue's description |
jira-ai issue comment | Add a new comment to a Jira issue |
jira-ai issue stats | Calculate time-based metrics for issues |
jira-ai issue assign | Assign or reassign a Jira issue |
jira-ai issue label add | Add labels to a Jira issue |
jira-ai issue label remove | Remove labels from a Jira issue |
Project Management (project)
| Command | Description |
|---|
| :--- | :--- |
jira-ai project list | List all accessible Jira projects |
jira-ai project statuses | Fetch workflow statuses for a project |
jira-ai project types | List issue types available for a project |
User Management (user)
| Command | Description |
|---|
| :--- | :--- |
jira-ai user me | Show profile details for authenticated user |
jira-ai user search [project-key] | Search and list users |
jira-ai user worklog | Retrieve worklogs for a user |
Organization Management (org)
| Command | Description |
|---|
| :--- | :--- |
jira-ai org list | List all saved Jira organization profiles |
jira-ai org use | Switch the active Jira organization profile |
jira-ai org add | Add a new Jira organization profile |
jira-ai org remove | Delete credentials for an organization |
Confluence Commands (confl)
| Command | Description |
|---|
| :--- | :--- |
jira-ai confl get | Download Confluence page content |
jira-ai confl spaces | List all allowed Confluence spaces |
jira-ai confl pages | Display pages within a space |
jira-ai confl create [parent-page]</code></td><td>Create a new Confluence page</td></tr><tr><td><code>jira-ai confl comment <url></code></td><td>Add a comment to a Confluence page</td></tr><tr><td><code>jira-ai confl update <url></code></td><td>Update a Confluence page</td></tr></tbody></table><h2>Usage Examples</h2><h3>Search for issues assigned to the current user</h3><pre><code>jira-ai issue search "assignee = currentUser()"
</code></pre><h3>Get details of a specific issue</h3><pre><code>jira-ai issue get PROJ-123
</code></pre><h3>Create a new issue</h3><pre><code>jira-ai issue create --project "PROJ" --summary "New task" --issuetype "Story"
</code></pre><h3>Transition an issue to a new status</h3><pre><code>jira-ai issue transition PROJ-123 "In Progress"
</code></pre><h3>Add a comment to an issue</h3><pre><code>jira-ai issue comment PROJ-123 --file comment.md
</code></pre><h3>List all projects</h3><pre><code>jira-ai project list
</code></pre><h3>Get worklogs for a user</h3><pre><code>jira-ai user worklog john.doe@example.com 2w
</code></pre><h2>Configuration Options</h2><p>The jira-ai tool supports extensive configuration through settings files. You can define:</p><ul><li>Allowed Jira projects</li><li>Allowed commands</li><li>Allowed Confluence spaces</li><li>Default behaviors for various operations</li></ul><p>Example settings structure:</p><pre><code>defaults:
allowed-jira-projects:
- all # Allow all projects
allowed-commands:
- all # Allow all commands
allowed-confluence-spaces:
- all # Allow all Confluence spaces
organizations:
work:
allowed-jira-projects:
- PROJ # Allow specific project
- key: PM # Project-specific config
commands:
- issue.get # Only allow reading issues
filters:
participated:
was_assignee: true
allowed-commands:
- issue # All issue commands
- project.list # Only project list
- user.me # Only user me
allowed-confluence-spaces:
- DOCS
</code></pre><h2>Benefits</h2><ul><li><strong>Efficient API Usage</strong>: Minimizes the number of API calls needed to perform common operations</li><li><strong>Batch Operations</strong>: Process multiple items at once to reduce API usage</li><li><strong>Smart Filtering</strong>: Use JQL to retrieve only the specific data needed</li><li><strong>Local Processing</strong>: Handle operations locally before sending targeted requests to Jira</li><li><strong>Configuration-Based Access Control</strong>: Define allowed commands and projects to prevent unauthorized operations</li><li><strong>Specific Command Targeting</strong>: Get only the information needed, reducing payload sizes and API usage</li></ul><h2>Security Considerations</h2><ul><li>Store API tokens securely in environment files</li><li>Use configuration-based access controls to limit operations</li><li>Regularly rotate API tokens</li><li>Limit permissions to the minimum required for operations</li></ul></div>
</div>
</div>
<div id="tab-versions" class="detail-content">
<div class="detail-section">
<h2>版本历史</h2>
<p style="margin-bottom:12px;font-size:14px;color:#94a3b8;">共 1 个版本</p>
<ul class="version-list">
<li>
<div>
<span class="version-tag">v1.0.0</span>
<span style="font-size:11px;color:#5b6abf;margin-left:8px;background:#eef0ff;padding:1px 8px;border-radius:10px;">当前</span> </div>
<div style="font-size:12px;color:#94a3b8;">
2026-03-28 13:59 安全 安全 </div>
</li>
</ul>
</div>
</div>
<div id="tab-security" class="detail-content">
<div class="detail-section">
<h2>安全检测</h2>
<div class="sec-grid"> <div class="sec-card">
<h4>腾讯云安全 (Keen)</h4>
<div class="sec-status sec-safe">
安全，无风险 </div>
<a href="https://tix.qq.com/search/skill?keyword=7d2219b404e3e8d8b6346142c3eafffb" target="_blank">查看报告</a> </div>
<div class="sec-card">
<h4>腾讯云安全 (Sanbu)</h4>
<div class="sec-status sec-safe">
安全，无风险 </div>
<a href="https://static.cloudsec.tencent.com/html-report-v2/2026/05/25/391629_867715e8ac9aba0b7ae6394b10f6935e.html?q-sign-algorithm=sha1&q-ak=AKID8JMG1bzBC1dz96qNhssfFftujT1NCoFi&q-sign-time=1781282546%3B1812818546&q-key-time=1781282546%3B1812818546&q-header-list=host&q-url-param-list=&q-signature=aa17094b477783e9c8688110b061694ad284a4f4" target="_blank">查看报告</a> </div>
</div>
</div>
</div>
<!-- Recommended Skills -->
<div style="margin-top:24px;">
<h2 style="font-size:18px;font-weight:600;margin-bottom:16px;">🔗 相关推荐</h2>
<div class="rec-grid">
<div class="rec-card">
<span class="badge-cat" style="margin-bottom:8px;display:inline-block;">developer-tools</span>
<h3><a href="/s/gog">Gog</a></h3>
<div class="rec-owner">steipete</div> <div class="rec-desc">Google Workspace 命令行工具，支持 Gmail、日历、云端硬盘、通讯录、表格和文档。</div>
<div class="rec-stats">
<span style="color:#f39c12;">★ 921</span>
<span style="color:#5b6abf;">📥 185,766</span>
</div>
</div>
<div class="rec-card">
<span class="badge-cat" style="margin-bottom:8px;display:inline-block;">developer-tools</span>
<h3><a href="/s/codeconductor">CodeConductor.ai</a></h3>
<div class="rec-owner">larsonreever</div> <div class="rec-desc">AI驱动平台，提供快速全栈开发、智能体、工作流自动化及低代码AI集成的可扩展产品创建。</div>
<div class="rec-stats">
<span style="color:#f39c12;">★ 66</span>
<span style="color:#5b6abf;">📥 179,989</span>
</div>
</div>
<div class="rec-card">
<span class="badge-cat" style="margin-bottom:8px;display:inline-block;">developer-tools</span>
<h3><a href="/s/agent-browser-clawdbot">Agent Browser</a></h3>
<div class="rec-owner">matrixy</div> <div class="rec-desc">专为AI智能体优化的无头浏览器自动化CLI，支持无障碍树快照和基于引用的元素选择。</div>
<div class="rec-stats">
<span style="color:#f39c12;">★ 426</span>
<span style="color:#5b6abf;">📥 118,100</span>
</div>
</div>
</div>
</div>
</div>
<script>
document.addEventListener('DOMContentLoaded',function(){
document.querySelectorAll('.detail-tab').forEach(function(btn){
btn.addEventListener('click',function(e){
var tab = this.getAttribute('data-tab');
document.querySelectorAll('.detail-tab').forEach(function(b){b.classList.remove('active')});
document.querySelectorAll('.detail-content').forEach(function(c){c.classList.remove('active')});
this.classList.add('active');
var el = document.getElementById('tab-'+tab);
if(el) el.classList.add('active');
});
});
});
</script>
<div class="footer">
<p>Skill工具集 © 2026</p>
</div></body>
</html> |