mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-20 07:43:07 +08:00
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.
This commit is contained in:
committed by
Affaan Mustafa
parent
922e058e68
commit
6556f20af7
108
docs/zh-CN/commands/jira.md
Normal file
108
docs/zh-CN/commands/jira.md
Normal file
@@ -0,0 +1,108 @@
|
||||
---
|
||||
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`
|
||||
Reference in New Issue
Block a user