/ 目錄 / 演練場 / CCPM (Claude Code Project Mgmt)
● 社群 automazeio ⚡ 即開即用

CCPM (Claude Code Project Mgmt)

作者 automazeio · automazeio/ccpm

以 GitHub Issues + Git worktree 作為 Claude Code 的專案管理層——每個 Issue 成為一個分支,每個 Agent 獨立工作,零互相干擾。

CCPM(Claude Code Project Management)將 GitHub Issues 視為 AI 程式碼 Agent 的工作單元。每個 Issue 獲得自己的 Git worktree(分支 + 獨立 checkout),讓多個 Claude 工作階段可以並行工作而不互相干擾。Skill 提供指令來從提示建立 Issue、認領 Issue、以 PR 形式發布,以及清理善後。專為同時開著多個 Claude 分頁的獨立開發者而生。

為什麼要用

核心特性

即時演示

實際使用效果

就緒

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ccpm-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "ccpm-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/automazeio/ccpm",
          "~/.claude/skills/ccpm"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add ccpm-skill -- git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: CCPM (Claude Code Project Mgmt)

同時在 3 個不同 Issue 上執行 3 個 Claude 工作階段

👤 獨立創業者、獨立開發者 ⏱ ~60 min intermediate

何時使用: 你有 5 個小 Issue;依序做太慢,但切換分支又會打亂狀態。

前置條件
  • gh CLI 已驗證gh auth login——用 gh repo view 確認
  • 已安裝 Skill — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm
步驟
  1. 挑選 Issue
    Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ 已複製
    → 3 個附有粗略估算且彼此無相依關係的 Issue
  2. 開始工作
    Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ 已複製
    → 3 個 worktree 建立於 ../wt-42 等位置;每個工作階段知道自己負責哪個 Issue
  3. 發布
    (In each session) When done — /ship — push branch and open PR linked to the issue.✓ 已複製
    → PR 已建立並連結到 Issue,CI 開始執行

結果: 三個 Issue 在一天內完成,無分支切換之苦。

注意事項
  • Issue 觸及相同的檔案——合併衝突 — Skill 會在選定的 Issue 有檔案重疊時發出警告;並行時選擇不重疊的
搭配使用: github

將臨時的想法轉化為正式定義範圍的 Issue

👤 任何靈感泛濫的人 ⏱ ~5 min beginner

何時使用: 你一直在對話中輸入「哦對了,我們還應該……」。將它們捕捉為正式 Issue。

步驟
  1. 擷取
    Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ 已複製
    → 在 GitHub 上建立格式完整的 Issue
  2. 連結
    Link to related issues if any.✓ 已複製
    → 連結已新增

結果: 想法變成後續可以分類的 Issue。

注意事項
  • Issue 變得過於冗長 — Skill 強制 Issue 內文 200 字上限
搭配使用: github

放棄已開始的 Issue,不留下腐爛的分支

👤 任何嘗試了某事後改變主意的人 ⏱ ~2 min beginner

何時使用: 進行 30 分鐘後你意識到方向錯了;想要乾淨地退出。

步驟
  1. 放棄
    /abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ 已複製
    → Worktree 已移除、分支已刪除、Issue 已關閉並附說明

結果: 版本庫中不再有孤立分支縈繞。

注意事項
  • 你其實想保留部分工作成果 — Skill 在刪除前將 patch 儲存到 /tmp/ccpm-stashes——可恢復約 7 天
搭配使用: github

組合

與其他 MCP 搭配,撬動十倍槓桿

ccpm-skill + github

確保 CCPM 與 GitHub MCP 的 Issue 狀態一致

Sync issue state after every /ship to ensure project boards reflect.✓ 已複製
ccpm-skill + memorix-mcp

跨 worktree 傳遞上下文

When starting an issue, recall any memorix entries tagged with this issue's component.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list filters 尋找工作 0
start issue_number 開始處理某個 Issue 0
ship issue_number? 完成;準備提交 PR 0
abandon issue_number, reason 乾淨地退出 0

成本與限制

運行它的成本

API 配額
受限於 GitHub API 限制(驗證後 5000 次/小時)
每次呼叫 Token 數
輕量——大多數操作是 git + gh CLI
費用
免費
提示
不要過度建立 Issue——Skill 鼓勵捕捉想法,但不是每個微想法都要建立

安全

權限、密鑰、影響範圍

最小權限: repo (for issue + PR write)
憑證儲存: 透過 gh auth 提供
資料出站: GitHub API
切勿授予: admin:org

故障排查

常見錯誤與修復

git worktree add 失敗:已被使用

先前的 worktree 仍然存在;用 git worktree prune 清理

驗證: `git worktree list`
gh PR create 錯誤「no commits between」

/ship 前至少在 worktree 分支上做一個 commit

兩個工作階段認領了同一個 Issue

Skill 為每個 Issue 寫入鎖定檔案——第二次 start 會失敗並顯示明確訊息

替代方案

CCPM (Claude Code Project Mgmt) 對比其他方案

替代方案何時用它替代權衡
Linear MCP你使用 Linear 而非 GitHub IssuesCCPM 僅支援 GitHub;Linear MCP 是其自身的生態系
純 `git worktree` + 核查清單你一次只執行一個 Agent手動操作;CCPM 自動化了整個生命週期

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills