Claude代码的Jira集成插件
一个Claude Code插件，通过两种专业技能提供全面的Jira集成。
插件结构
| 技能 | 目的 |
|---|---|
jira-communication | 通过Python CLI脚本执行API操作 |
jira-syntax | Wiki标记语法、模板、验证 |
每种技能都有自己的 SKILL.md 带有触发条件和使用说明。Claude Code根据上下文自动发现和激活技能。
🔌 技能兼容性
此插件中包含的技能如下 代理技能开放标准 最初由Anthropic开发，并发布用于跨平台使用。
支持的平台：
- ✅ 克劳德密码（人类学）
- ✅ 光标
- ✅ GitHub Copilot
- ✅ 其他技能兼容的AI代理
技能是可移植的程序知识包，适用于支持代理技能规范的任何AI代理。
特性
- 零MCP开销 -通过Bash调用的脚本，未加载工具描述
- 快速执行 -无Docker容器启动
- API全面覆盖 -支持所有常见的Jira操作
- Jira服务器/DC+云 -适用于两种部署类型
安装
市场（推荐）
添加 网络研究市场 一次，然后浏览并安装技能：
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplacenpx(技能s.sh)
使用任何 代理技能-兼容代理：
npx skills add https://github.com/netresearch/jira-skill --skill jira-communication
npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax下载发布
下载 最新版本 并提取到代理的技能目录中。
Git 克隆
git clone https://github.com/netresearch/jira-skill.git编写器（PHP项目）
composer require netresearch/jira-skill需要 netresearch/composer代理技能插件.
npm（节点项目）
npm install --save-dev \
@netresearch/agent-skill-coordinator \
github:netresearch/jira-skill需要 @网络研究/代理技能协调员，它发现了 node_modules 并将其注册到 AGENTS.md 通过a postinstall 钩子。对于pnpm，还可以列出协调员的安装后：
{
"pnpm": {
"onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
}
}快速开始
注： 从以下位置运行命令skills/jira-communication/，或为路径添加前缀skills/jira-communication/从repo根目录。
# Search issues
uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'"
# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123
# Add worklog
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Code review"
# Create issue
uv run scripts/workflow/jira-create.py issue PROJ "Fix bug" --type Bug --priority High可用脚本
核心操作（脚本/Core/）
| 脚本 | 命令 | 用法 |
|---|---|---|
jira-setup.py | （默认） | 交互式凭据设置 |
jira-validate.py | （默认） | 验证环境设置 |
jira-issue.py | 获取、更新 | 获取和更新问题 |
jira-search.py | 查询 | JQL搜索 |
jira-worklog.py | 添加、列出 | 时间跟踪 |
jira-attachment.py | 下载 | 下载问题附件 |
工作流操作（脚本/工作流/）
| 脚本 | 命令 | 用法 |
|---|---|---|
jira-create.py | issue | 创建新问题 |
jira-transition.py | list，do | 更改问题状态 |
jira-comment.py | 添加、列出 | 发布评论 |
jira-sprint.py | 列表、问题、当前 | Sprint运营 |
jira-board.py | 列表，问题 | 董事会操作 |
实用程序操作（脚本/实用程序/）
| 脚本 | 命令 | 用法 |
|---|---|---|
jira-fields.py | 搜索，列表 | 查找字段ID |
jira-user.py | 我，获取 | 用户信息 |
jira-link.py | 创建，列出类型 | 问题链接 |
常见选项
所有脚本支持：
--json-输出为JSON--quiet/-q-最小输出--env-file PATH-自定义环境文件--debug-显示详细错误--help-显示命令帮助
写入操作还支持：
--dry-run-预览更改而不执行
脚本使用示例
搜索和筛选
# Find open bugs in project
uv run scripts/core/jira-search.py query "project = PROJ AND type = Bug AND status != Done"
# Find my assigned issues
uv run scripts/core/jira-search.py query "assignee = currentUser()"
# Output as JSON for processing
uv run scripts/core/jira-search.py query "project = PROJ" --json --max-results 100问题管理
# Get issue details
uv run scripts/core/jira-issue.py get PROJ-123
# Update issue fields (dry-run first)
uv run scripts/core/jira-issue.py update PROJ-123 --labels "urgent,backend" --dry-run
# Create new issue
uv run scripts/workflow/jira-create.py issue PROJ "Implement feature X" --type Story --priority Medium时间跟踪
# Log time worked
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Implemented core logic"
# View worklogs
uv run scripts/core/jira-worklog.py list PROJ-123工作流转换
# List available transitions
uv run scripts/workflow/jira-transition.py list PROJ-123
# Transition issue (dry-run first)
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
# Execute transition
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress"评论
# Add comment
uv run scripts/workflow/jira-comment.py add PROJ-123 "Investigation complete - root cause identified"
# List recent comments
uv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5Sprint和董事会运营
# List boards for project
uv run scripts/workflow/jira-board.py list --project PROJ
# Get board issues
uv run scripts/workflow/jira-board.py issues 42
# List sprints
uv run scripts/workflow/jira-sprint.py list 42 --state active
# Get sprint issues
uv run scripts/workflow/jira-sprint.py issues 123
# Get current sprint
uv run scripts/workflow/jira-sprint.py current 42公用事业运营
# Search for custom fields
uv run scripts/utility/jira-fields.py search "story points"
# List all custom fields
uv run scripts/utility/jira-fields.py list --type custom
# Get current user info
uv run scripts/utility/jira-user.py me
# List available link types
uv run scripts/utility/jira-link.py list-types
# Create issue link
uv run scripts/utility/jira-link.py create PROJ-123 PROJ-456 --type "Blocks" --dry-run相关技能
- jira语法 -Jira wiki标记验证和模板（未更改）
故障排除
“未找到紫外线”
安装紫外线：
pip install uv“找不到环境文件”
创建 ~/.env.jira 凭你的证件。
“身份验证失败”
- 验证JIRA_URL是否正确
- 对于云：JIRA_USENAME是您的电子邮件
- 对于服务器/DC：改用JIRA_PERSONAL_TOKEN
- 如果已过期，请重新生成API令牌
运行脚本时出现导入错误
从技能目录运行脚本：
cd skills/jira-communication
uv run scripts/core/jira-issue.py get PROJ-123许可证
麻省理工学院
学分
由开发和维护 Netresearch DTT有限公司.
______________________________________________________________________
由...制作❤️ 开源by 网络研究