ctxd 是做什麼的?
將工作網址轉換成 LLM 可用的 Markdown 格式。命令列工具可匯出 GitHub PR、Slack 討論串、Confluence 頁面與 Jira 議題。內含 Claude Code 及 Codex 技能。
功能
- 從 GitHub PR 與 Issue 擷取內容
- 匯出 Slack 討論串(需具有權限的 Token)
- 轉換 Confluence 頁面為結構化 Markdown
- 將 Jira 議題轉換為 LLM 可用的格式
- 支援 Claude Code 與 Codex 的整合技能
安裝
透過 npm 安裝:
npm install -g ctxd
或者從原始碼建置:
git clone https://github.com/CheerChen/ctxd.git
cd ctxd
npm install
npm run build
使用方式
基本用法:
ctxd <URL>
範例:
ctxd https://github.com/使用者/專案/pull/123
ctxd https://your-domain.slack.com/archives/C12345/p1234567890
ctxd https://your-domain.atlassian.net/wiki/spaces/SPACE/pages/123456
ctxd https://your-domain.atlassian.net/browse/PROJ-123
環境變數
設定必要的 API Token 與認證資訊:
GITHUB_TOKEN:GitHub 個人存取權杖SLACK_TOKEN:Slack Bot Token(需 channels:history 與 channels:read 權限)CONFLUENCE_EMAIL與CONFLUENCE_API_TOKEN:Confluence 認證JIRA_EMAIL與JIRA_API_TOKEN:Jira 認證
Claude Code 與 Codex 整合
此儲存庫包含一個 skills/ctxd.md 檔案,可作為 Claude Code 或 Codex 的技能使用。要啟用此功能,請將技能檔案放置在適當的目錄中:
- Claude Code:
~/.claude/skills/ctxd.md - Codex:按照 Codex 的技能設定指南操作
當技能啟用後,AI 助手將能夠根據需求自動呼叫 ctxd 來擷取工作內容。
授權條款
MIT