🔧 阿川の電商水電行
自動化從GitHub的PR創建到Backlog上的審核請求之間的交流。
前言
我所在的團隊使用Backlog來管理開發票據。
在開發流程中，針對開發票據創建GitHub的拉取請求，並將其連結附加到Backlog的票據上，以進行開發流程的審核等。
作為AI編碼工具，我們主要使用Claude Code，並希望以接近團隊的開發流程的方式來構建自動化的機制，因此這次我們建立了這個機制。
所建立的內容
當將Backlog的票據編號傳遞給Claude Code時，系統會自動從實作到Backlog側的審核請求評論全部完成。
※在Backlog側的設置中運用名為“審核請求”的里程碑
機制（概要）
在專案下運行的Claude Code中設置以下內容並運行：
- Backlog MCP的設定
- 在本地安裝GitHub CLI
- 創建Claude Code操作Backlog所需的自訂斜線命令
如需更詳細了解Backlog MCP，可以參考以下文章。
使用方法
假設Backlog中有相關內容的票據。
啟動Claude Code，並在自作的斜線命令的參數中指定Backlog的票據編號來執行：
─────────────────────────────────────────────────────────────────────────────────────────────────────────
> /backlog_task_run SAMPLE-0001
─────────────────────────────────────────────────────────────────────────────────────────────────────────
/backlog_task_run 根據Backlog的票據推進開發 (project)~ 幾分鐘後 ~
將執行從PR創建到Backlog的票據信息更新。
✅ 實作已完成。
拉取請求
https://github.com/xxxxx/project_x/pull/1
分支：feature/add_user_api
已向Backlog票據提交了審核請求的評論。
─────────────────────────────────────────────────────────────────────────────────────────────────────────
>
─────────────────────────────────────────────────────────────────────────────────────────────────────────自動創建拉取請求
Claude Code會自動讀取Backlog票據的內容，修正源代碼後，按照團隊運行的分支命名和提交格式等規則自動創建PR。
更新Backlog側的信息及自動評論
系統將自動添加評論和更改里程碑。
在拉取請求或Backlog的評論中，我們設置了生成時明確表明為AI創建的內容。
機制（詳細）
專案中的Claude Code架構
project_xxx/
├── .claude/
│ ├── agents/
│ ├── commands/
│ │ └── backlog_task_run.md # 在這裡創建用於執行Backlog任務的命令文件
│ ├── skills/
│ ├── output-styles/
│ └── settings.json
├── src/ # 專案的源代碼
├── .mcp.json # MCP的設定MCP的設定
需要對Backlog MCP進行設置。
通過指定在Backlog個人設置中獲取的API鍵設定BACKLOG_API_KEY以進行連接。
將以下內容添加到.mcp.json中。
{
"mcpServers": {
"backlog": {
"type": "stdio",
"command": "docker",
"args": [
"run","--pull","always","-i","--rm","-e",
"BACKLOG_DOMAIN": "${BACKLOG_DOMAIN}",
"BACKLOG_API_KEY": "${BACKLOG_API_KEY}",
"ghcr.io/nulab/backlog-mcp-server"
],
"env": {}
}
}
}執行/mcp命令，若顯示connected則表示連接成功。
※ 提示: Cmd+Escape 於你的IDE中啟動Claude
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ 管理 MCP 伺服器 │
│ │
│ ❯ 1. backlog ✔ connected · 按Enter查看詳細資訊 │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Esc 以退出請參考以下內容以獲得Backlog MCP的詳細設置資訊。
自訂斜線命令的內容
創建一個以Backlog票據編號為參數的斜線命令。
※部分內容已簡化
創建.claude/commands/backlog_task_run.md後，寫入以下內容。
---
allowed_tools: Bash(npm:*), Read(*.md), Fetch(*)
description: "根據Backlog的票據推進開發"
---
## Backlog任務的執行命令
根據Backlog的票據進行開發
## 工作流程
1. 參閱{$ARGUMENTS}的票據，確認內容
2. 根據票據內容，檢查專案的源代碼並進行基本設計
3. 使用TodoWrite工具制定任務計劃
4. 考慮分支名稱，從主分支切出。命名範例如下。
- 開發相關: `feature/{Backlog的課題鍵編號}_{名稱}`
- 修復相關: `fix/{Backlog的課題鍵編號}_{名稱}`
5. 開發完成後，使用`/review`命令進行自我審核
6. 若審核無誤，則生成提交
7. 將創建的分支推送並創建PR，PR應以`draft`狀態創建
- `git push origin [分支名稱]`
8. 撰寫PR的正文
- 一定要在PR開頭明確說明該內容由AI生成，人類應該進行適當的審查
9. 向Backlog票據報告進度
- 添加包含PR鏈接的評論
- 將里程碑更改為「審核請求」
## 創建PR後的Backlog更新步驟
### 添加評論使用mcpbacklogadd_issue_comment發表以下內容：
- 開頭明確表示為AI生成的評論
- 請求審核
- PR的鏈接
更改里程碑
使用mcp__backlog__update_issue設定以下內容：
- milestoneId: [xxxxx] (審核請求)完成設置後，即可在Claude Code中的斜線命令中使用。
─────────────────────────────────────────────────────────────────────────────────────────────────────────
> /backlog_task_run
─────────────────────────────────────────────────────────────────────────────────────────────────────────
/backlog_task_run 根據Backlog的票據推進開發 (project)其他・注意事項
- Claude Code側的GitHub和Backlog操作權限設定較寬鬆。存在誤操作的風險，因此在使用時請多加注意。※在我操作的情況下，並沒有出現意外的行為。
- 關於實作的精度，對於小規模任務而言其表現良好。不過，若任務過大或Backlog票據的信息較少，則實作精度可能會下降，因此建議適度利用。
最後
隨著Claude Code與Backlog MCP的整合，我介紹了只需傳遞票據編號便可自動化從實作到審核請求的機制。
這一機制的優點在於能夠輕鬆處理小型任務，同時將Backlog的更新自動化，讓人感覺就像增強了團隊的成員一樣。
建議首先從小型任務開始嘗試。生成的代碼一定要由人員確認，並遵循團隊內的規則進行運用。
KIYO學習正積極利用生成AI提升服務質量。
若對組織或產品有興趣，請查看以下內容。
關於KIYO學習股份有限公司
我公司的願景是『提供世界上最「容易學習、容易理解、持之以恆」的學習方式』。我們的目標是透過創造與發展創新的教育服務，成為在線教育領域的第一名，並在全球拓展。
產品
- スタディング：「學習容易、容易理解、持續學習」的在線資格考試課程
- スタディングキャリア：支援資格獲得者的求職和職業發展的轉職服務
- AirCourse：提供隨意觀看的視頻培訓的e-learning系統（LMS）
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
