mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-14 10:43:20 +08:00
6556f20af7
Port the current-source-safe command documentation subset from stale PR #1687.\n\nEach copied command page maps to an English source file unchanged since the stale PR base; fastapi-review remains deferred because #1687 did not include a matching zh-CN translation.
109 lines
2.8 KiB
Markdown
109 lines
2.8 KiB
Markdown
---
|
||
description: 检索Jira工单，分析需求，更新状态或添加评论。使用jira-integration技能和MCP或REST API。
|
||
---
|
||
|
||
# Jira 命令
|
||
|
||
直接从工作流中与 Jira 工单交互——获取工单、分析需求、添加评论以及变更状态。
|
||
|
||
## 用法
|
||
|
||
```
|
||
/jira get <TICKET-KEY> # 获取并分析工单
|
||
/jira comment <TICKET-KEY> # 添加进度评论
|
||
/jira transition <TICKET-KEY> # 更改工单状态
|
||
/jira search <JQL> # 使用JQL搜索问题
|
||
```
|
||
|
||
## 此命令的功能
|
||
|
||
1. **获取与分析** — 获取 Jira 工单并提取需求、验收标准、测试场景和依赖项
|
||
2. **评论** — 向工单添加结构化的进度更新
|
||
3. **状态变更** — 在工作流状态间移动工单（待办 → 进行中 → 已完成）
|
||
4. **搜索** — 使用 JQL 查询查找问题
|
||
|
||
## 工作原理
|
||
|
||
### `/jira get <TICKET-KEY>`
|
||
|
||
1. 从 Jira 获取工单（通过 MCP `jira_get_issue` 或 REST API）
|
||
2. 提取所有字段：摘要、描述、验收标准、优先级、标签、关联问题
|
||
3. 可选地获取评论以获取更多上下文
|
||
4. 生成结构化分析：
|
||
|
||
```
|
||
Ticket: PROJ-1234
|
||
Summary: [标题]
|
||
Status: [状态]
|
||
Priority: [优先级]
|
||
Type: [故事/缺陷/任务]
|
||
|
||
Requirements:
|
||
1. [提取的需求]
|
||
2. [提取的需求]
|
||
|
||
Acceptance Criteria:
|
||
- [ ] [工单中的验收标准]
|
||
|
||
Test Scenarios:
|
||
- Happy Path: [描述]
|
||
- Error Case: [描述]
|
||
- Edge Case: [描述]
|
||
|
||
Dependencies:
|
||
- [关联的问题、API、服务]
|
||
|
||
Recommended Next Steps:
|
||
- /plan 创建实施计划
|
||
- `tdd-workflow` 技能以测试驱动开发方式实现
|
||
```
|
||
|
||
### `/jira comment <TICKET-KEY>`
|
||
|
||
1. 总结当前会话进度（已构建、已测试、已提交的内容）
|
||
2. 格式化为结构化评论
|
||
3. 发布到 Jira 工单
|
||
|
||
### `/jira transition <TICKET-KEY>`
|
||
|
||
1. 获取工单的可用状态变更
|
||
2. 向用户显示选项
|
||
3. 执行所选的状态变更
|
||
|
||
### `/jira search <JQL>`
|
||
|
||
1. 对 Jira 执行 JQL 查询
|
||
2. 返回匹配问题的摘要表格
|
||
|
||
## 前提条件
|
||
|
||
此命令需要 Jira 凭据。请选择以下方式之一：
|
||
|
||
**选项 A — MCP 服务器（推荐）：**
|
||
将 `jira` 添加到您的 `mcpServers` 配置中（请参阅 `mcp-configs/mcp-servers.json` 获取模板）。
|
||
|
||
**选项 B — 环境变量：**
|
||
|
||
```bash
|
||
export JIRA_URL="https://yourorg.atlassian.net"
|
||
export JIRA_EMAIL="your.email@example.com"
|
||
export JIRA_API_TOKEN="your-api-token"
|
||
```
|
||
|
||
如果缺少凭据，请停止并引导用户进行设置。
|
||
|
||
## 与其他命令的集成
|
||
|
||
分析工单后：
|
||
|
||
* 使用 `/plan` 根据需求创建实施计划
|
||
* 使用 `tdd-workflow` 技能进行测试驱动开发实施
|
||
* 实施后使用 `/code-review`
|
||
* 使用 `/jira comment` 将进度发布回工单
|
||
* 工作完成后使用 `/jira transition` 移动工单
|
||
|
||
## 相关
|
||
|
||
* **技能：** `skills/jira-integration/`
|
||
* **MCP 配置：** `mcp-configs/mcp-servers.json` → `jira`
|