mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-05-14 02:10:07 +08:00

Affaan Mustafa 6556f20af7 docs: salvage zh-CN command translations

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.

2026-05-11 14:05:38 -04:00

2.8 KiB

Raw Blame History

description

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搜索问题

此命令的功能

获取与分析 — 获取 Jira 工单并提取需求、验收标准、测试场景和依赖项
评论 — 向工单添加结构化的进度更新
状态变更 — 在工作流状态间移动工单（待办 → 进行中 → 已完成）
搜索 — 使用 JQL 查询查找问题

工作原理

`/jira get <TICKET-KEY>`

从 Jira 获取工单（通过 MCP jira_get_issue 或 REST API）
提取所有字段：摘要、描述、验收标准、优先级、标签、关联问题
可选地获取评论以获取更多上下文
生成结构化分析：

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>`

总结当前会话进度（已构建、已测试、已提交的内容）
格式化为结构化评论
发布到 Jira 工单

`/jira transition <TICKET-KEY>`

获取工单的可用状态变更
向用户显示选项
执行所选的状态变更

`/jira search <JQL>`

对 Jira 执行 JQL 查询
返回匹配问题的摘要表格

前提条件

此命令需要 Jira 凭据。请选择以下方式之一：

选项 A — MCP 服务器（推荐）： 将 jira 添加到您的 mcpServers 配置中（请参阅 mcp-configs/mcp-servers.json 获取模板）。

选项 B — 环境变量：

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 移动工单

2.8 KiB Raw Blame History Unescape Escape