一個用於 Confluence 管理的 Claude 技能，幫助管理員自動查詢 Confluence 空間列表、使用者與群組資訊、管理空間權限，減少手動操作並提升管理效率。

• 查詢 Confluence 空間 - 列出所有空間的詳細資訊（名稱、Key、類型、狀態）
• 空間權限管理 - 查詢和管理空間層級的權限設定
• 使用者/群組資訊 - 列出多個空間的使用者和群組權限
• 分頁處理 - 自動處理游標分頁，確保取得完整資料
• Atlassian Cloud 整合 - 透過 MCP 與 Atlassian Cloud 認證整合

• 已連接 Atlassian 帳號（透過 MCP 或瀏覽器認證）
• 具有 read:space:confluence 權限
• 已安裝 Claude Desktop 應用程式

1. 找到技能檔案

   已打包的技能檔案為本專案中的 confluence-admin.skill。

2. 找到 Claude Desktop 技能目錄

   • macOS: ~/Library/Application Support/Claude/skills/
   • Windows: %APPDATA%\Claude\skills\
   • Linux: ~/.config/Claude/skills/

3. 複製技能檔案

   將 confluence-admin.skill 複製到技能目錄：

   # macOS
   cp confluence-admin.skill ~/Library/Application\ Support/Claude/skills/
   
   # Linux
   cp confluence-admin.skill ~/.config/Claude/skills/

   Windows 系統請使用檔案總管將檔案複製到 %APPDATA%\Claude\skills\

4. 重新啟動 Claude Desktop

   關閉並重新開啟 Claude Desktop 應用程式以載入新技能。

5. 驗證安裝

   當您提及以下關鍵字時，技能將會被啟動：

   • 「Confluence」
   • 「空間權限」
   • 「Confluence 使用者/群組」
   • 「空間管理」

如果您想從原始碼安裝或修改技能：

1. 複製此專案：

   git clone https://github.com/your-org/confluence-admin-skill.git

2. 技能原始碼位於 confluence-admin/ 目錄，結構如下：

   confluence-admin/
   ├── SKILL.md              # 技能定義與工作流程
   ├── references/
   │   └── api_reference.md  # Confluence REST API v2 參考文件
   ├── scripts/
   │   └── example.py        # 範例腳本
   └── assets/
       └── example_asset.txt
   

3. 建立新的 .skill 套件，將 confluence-admin/ 目錄壓縮：

   cd confluence-admin
   zip -r ../confluence-admin.skill .

1. 取得 Cloud ID

   使用 MCP 工具 getAccessibleAtlassianResources 取得您的 Atlassian Cloud ID。

2. 查詢所有空間

   詢問 Claude：「列出我組織中所有的 Confluence 空間」

3. 查詢空間權限

   詢問 Claude：「顯示 TEAM-A 空間的權限設定」

• 「列出所有 Confluence 空間」
• 「Engineering 空間有哪些權限？」
• 「顯示所有可以存取 HR 空間的使用者和群組」
• 「產生所有空間的權限報告」

本技能使用 Confluence REST API v2：

詳細 API 文件請參閱 confluence-admin/references/api_reference.md。

1. 不包含 App 權限 - API 不會返回 App 類型的權限（如 Chat Notifications、Microsoft Teams 等），這些需從 Confluence UI 查看。

2. 需要分頁處理 - API 預設每頁回傳 25 筆資料，本技能會自動處理 _links.next 分頁。

3. 群組 ID 對應 - 權限 API 只返回群組 ID，本技能會查詢 /wiki/rest/api/group 來對應群組名稱。

重新執行 getAccessibleAtlassianResources 取得最新的 Cloud ID。

確保完整分頁查詢，本技能會檢查所有 _links.next 直到沒有更多分頁。

本技能使用 /wiki/rest/api/group 建立群組 ID 與名稱的對應表。

confluence-admin-skill/
├── README.md                    # 本檔案
├── confluence-admin.skill       # 已打包的技能（可直接安裝）
└── confluence-admin/            # 技能原始碼
    ├── SKILL.md                 # 技能定義
    ├── references/
    │   └── api_reference.md     # API 文件
    ├── scripts/
    │   └── example.py
    └── assets/
        └── example_asset.txt

詳見 LICENSE 檔案。

歡迎貢獻！請開啟 Issue 或提交 Pull Request。