Linear & Trello task sync & management CLI with TOON format
npm install team-toon-tack繁體中文 | English
為 Claude Code 最佳化的任務工作流 — 支援 Linear 和 Trello,比 MCP 節省大量 token。
- 節省 Token — 本地 cycle 快取避免重複 API 呼叫,比 MCP 省下大量 token
- 多來源支援 — 支援 Linear 和 Trello
- 智慧任務挑選 — /work-on next 自動選擇最高優先級的未指派工作
- 多團隊支援 — 跨多個團隊/看板同步與過濾 issue
- 彈性同步模式 — 選擇 remote(即時同步)或 local(離線優先,稍後用 --update 同步)
- 完成模式 — 四種任務完成模式(Linear):簡單、嚴格審查、上下游嚴格、上下游非嚴格
- QA 團隊支援 — 完成開發任務時自動將 QA 團隊的 parent issue 更新為「Testing」(Linear)
- 附件下載 — 自動下載圖片和檔案到本地 .ttt/output/,供 AI 視覺分析
- 阻塞狀態 — 等待外部依賴時可設定任務為 blocked
- Claude Code Plugin — 安裝 plugin 即可使用 /ttt:* 指令和自動啟用的技能
- Cycle 歷史保存 — 本地 .toon 檔案保留 cycle 資料,方便 AI 檢閱
``bash
npm install -g team-toon-tack
cd your-project
ttt init
`
初始化時會提示選擇任務來源(Linear 或 Trello),然後設定:
Linear:
- 開發團隊:你的開發團隊(單選)
- 開發團隊測試狀態:開發團隊的 testing/review 狀態(可選)
- QA 團隊:跨團隊 parent issue 更新,各自設定 testing 狀態(可選)
- 完成模式:任務完成時的處理方式(見下方說明)
- 狀態來源:remote(即時更新 Linear)或 local(離線工作,用 ttt sync --update 同步)
Trello:
- 看板:要同步的 Trello 看板
- 使用者:你的 Trello 使用者名稱
- 狀態映射:將 Trello 列表映射到 Todo(支援多個列表)/In Progress/Done
- 標籤過濾:可選的卡片過濾標籤
| 模式 | 行為 |
|------|------|
| simple | 任務標記為 Done,parent 也標記為 Done。未設定 QA 團隊時的預設值。 |strict_review
| | 任務標記到開發團隊的 testing 狀態,parent 標記到 QA 團隊的 testing 狀態。 |upstream_strict
| | 任務標記為 Done,parent 移動到 Testing。若無 parent,fallback 到開發團隊的 testing 狀態。設定 QA 團隊時的預設值。 |upstream_not_strict
| | 任務標記為 Done,parent 移動到 Testing。若無 parent 不做 fallback。 |
> 注意:Trello 因不支援 parent issue,一律使用簡單完成模式。
``
/plugin marketplace add wayne930242/team-toon-tack
/plugin install team-toon-tack@wayne930242
在 Claude Code 中(安裝 plugin 後):
``
/ttt:sync # 取得當前 cycle 所有 issue/card
/ttt:work-on next # 挑選最高優先級任務並開始工作
/ttt:done # 完成任務,附上 AI 生成的摘要
或直接使用 CLI:
`bash`
ttt sync
ttt work-on next
ttt done -m "完成任務"
---
在當前目錄初始化配置。
`bash`
ttt init # 互動模式(選擇來源)
ttt init --source=linear # 初始化 Linear
ttt init --source=trello # 初始化 Trello
ttt init --user alice@example.com # 預選使用者
ttt init --label Frontend # 設定預設標籤
ttt init --force # 覆蓋現有配置
從 Linear/Trello 同步當前 cycle 的 issue。
`bash`
ttt sync # 同步 Todo/In Progress 狀態的 issue(較快)
ttt sync --all # 同步所有狀態的 issue
ttt sync MP-123 # 只同步特定 issue
ttt sync --update # 將本地狀態推送到遠端(local 模式用)
開始處理任務。
`bash`
ttt work-on # 互動選擇
ttt work-on MP-123 # 指定 issue
ttt work-on next # 自動選擇最高優先級
標記任務完成。
`bash`
ttt done # 若只有一個進行中,自動選擇
ttt done MP-123 # 指定 issue
ttt done -m "修復了錯誤" # 附上完成說明
ttt done MP-123 --from-remote # 從遠端取得(略過本地資料檢查)
當 issue 存在於遠端但未同步到本地資料時,使用 --from-remote(或 -r)。
顯示或修改任務狀態。
`bash`
ttt status # 顯示當前進行中的任務
ttt status MP-123 # 顯示特定 issue 狀態
ttt status MP-123 --set +1 # 移動到下一狀態
ttt status MP-123 --set done # 標記為完成
ttt status MP-123 --set blocked # 設為阻塞(等待外部依賴)
顯示 issue 詳情或搜尋 issue。
`bash`
ttt show # 顯示本地 cycle 資料中的所有 issue
ttt show MP-123 # 顯示特定 issue(從本地資料)
ttt show MP-123 --remote # 從遠端取得特定 issue
ttt show --label frontend # 依標籤過濾
ttt show --status "In Progress" --user me # 我進行中的 issue
ttt show --priority 1 # 顯示緊急 issue
ttt show --export # 輸出為 markdown 格式
配置設定。
`bash`
ttt config # 顯示當前配置
ttt config status # 配置狀態映射
ttt config filters # 配置標籤/使用者過濾
ttt config teams # 配置多團隊選擇
``
your-project/
└── .ttt/
├── config.toon # 團隊配置(建議 gitignore)
├── local.toon # 個人設定(gitignore)
├── cycle.toon # 當前 cycle 資料(自動產生)
└── output/ # 下載的附件(圖片、檔案)
| 變數 | 說明 |
|------|------|
| LINEAR_API_KEY | Linear 必填。你的 Linear API 金鑰 |TRELLO_API_KEY
| | Trello 必填。你的 Trello API 金鑰 |TRELLO_TOKEN
| | Trello 必填。你的 Trello 授權 token |TOON_DIR
| | 配置目錄(預設:.ttt) |
1. 從 https://trello.com/power-ups/admin 取得 API 金鑰
2. 在 ttt init 時會顯示授權網址,前往取得 tokenTRELLO_API_KEY
3. 在環境變數中設定 和 TRELLO_TOKEN
| 概念 | Linear | Trello |
|------|--------|--------|
| 容器 | Team | Board(看板)|
| 任務 | Issue | Card(卡片)|
| 狀態 | Workflow State | List(列表)|
| 標籤 | Label | Label |
| 週期 | Cycle | -(不支援)|
| 上層 | Parent Issue | -(不支援)|
安裝 plugin 以整合 Claude Code:
``
/plugin marketplace add wayne930242/team-toon-tack
/plugin install team-toon-tack@wayne930242
| 指令 | 說明 |
|------|------|
| /ttt:sync | 同步 issue 到本地 |/ttt:work-on
| | 開始處理任務 |/ttt:done
| | 標記當前任務完成 |/ttt:status
| | 顯示或修改任務狀態 |/ttt:show
| | 顯示 issue 詳情或搜尋 issue |
Plugin 包含 linear-task-manager` 技能,在處理任務時會自動啟用,提供工作流程指導和最佳實踐。
MIT