Skip to content

CLAUDE.md

Latest commit

 

History

History
99 lines (67 loc) · 2.98 KB

CLAUDE.md

File metadata and controls

99 lines (67 loc) · 2.98 KB
Raw

Spectra Instructions

This project uses Spectra for Spec-Driven Development(SDD). Specs live in openspec/specs/, change proposals in openspec/changes/.

Use /spectra:* skills when:

  • A discussion needs structure before coding → /spectra:discuss
  • User wants to plan, propose, or design a change → /spectra:propose
  • Tasks are ready to implement → /spectra:apply
  • There's an in-progress change to continue → /spectra:ingest
  • User asks about specs or how something works → /spectra:ask
  • Implementation is done → /spectra:archive

Workflow

discuss? → propose → apply ⇄ ingest → archive

  • discuss is optional — skip if requirements are clear
  • Requirements change mid-work? Plan mode → ingest → resume apply

Parked Changes

Changes can be parked（暫存）— temporarily moved out of openspec/changes/. Parked changes won't appear in spectra list but can be found with spectra list --parked. To restore: spectra unpark <name>. The /spectra:apply and /spectra:ingest skills handle parked changes automatically.

che-msg

即時通訊 MCP Server monorepo。

結構

目錄 說明 底層
che-telegram-bot-mcp Telegram Bot API Swift + MCP SDK
che-telegram-all-mcp Telegram 個人帳號 (MTProto/TDLib) Swift + TDLibKit

架構

兩個 MCP 都拆為三層，共用一個底層 library：

bot-mcp

Target 用途 依賴
TelegramBotAPI 純 Telegram HTTP client Foundation only
CheTelegramBotMCP MCP Server entry point TelegramBotAPI + MCP SDK
telegram-bot CLI 工具 TelegramBotAPI + ArgumentParser

all-mcp

Target 用途 依賴
TelegramAllLib TDLib wrapper（個人帳號） TDLibKit + TDLibFramework
CheTelegramAllMCP MCP Server entry point TelegramAllLib + MCP SDK
telegram-all CLI 工具 TelegramAllLib + ArgumentParser

開發

每個 MCP 都是獨立的 Swift Package，各自有 Package.swift。

# bot-mcp
cd che-telegram-bot-mcp && swift build -c release
swift build -c release --product telegram-bot

# all-mcp
cd che-telegram-all-mcp && swift build -c release
swift build -c release --product telegram-all

測試

# Unit tests（離線）
swift test --skip E2ETests

# E2E tests（需要真實 Telegram 認證）
export TELEGRAM_API_ID=... TELEGRAM_API_HASH=...
swift test --filter E2ETests

注意：TDLib receive loop 是 process-global，all-mcp 的 unit tests 和 E2E tests 必須分開跑。

all-mcp 認證流程（一次性）

telegram-all auth-phone +886912345678
telegram-all auth-code 12345
telegram-all auth-status   # 應顯示 "Authenticated ✓"

未來擴展

  • LINE MCP（目前 che-archive-lines 是純腳本自動化，待升級為 MCP）
  • Slack / Discord 等即時通訊整合
  • che-telegram-all-mcp 簡化：以讀取 local 對話記錄為主