Weekly Check-in System

一個智能化的個人生產力追蹤系統，結合 Claude Code 開發框架與 Tauri 桌面應用程式，提供完整的每日/每週檢查、思維分析和個人化簡報功能。

系統架構

本專案包含兩個主要部分：

1. Claude Code 開發框架 - 基於 AI 的開發工作流和智能命令系統
2. Weekly Check-in 桌面應用 - 基於 Tauri 2.x 的跨平台桌面應用程式

weekly-checkin-system/
├── .claude/                    # Claude Code 開發框架
│   ├── commands/               # 斜線命令定義
│   ├── skills/                 # 專業技能模組
│   ├── agents/                 # 子代理人定義
│   ├── rules/                  # 工作流規則
│   └── hooks/                  # 事件鉤子
├── weekly-checkin/             # Tauri 桌面應用程式
│   ├── src/                    # 前端 (HTML/CSS/JS)
│   └── src-tauri/              # 後端 (Rust)
├── specs/                      # 功能規格文件
├── memory/                     # 專案記憶 (constitution.md)
└── metrics/                    # 指標歷史記錄

功能特色

桌面應用功能

功能	說明	優先級
每日打卡	自由格式文字輸入，自動解析心情、精力、完成事項	P1
週報告生成	自動彙總每日數據，與上週比較趨勢	P1
系統托盤	常駐系統托盤，隨時可用	P1
思維傾倒	自由書寫，AI 分析提取洞察和模式	P2
每日簡報	基於興趣的個人化新聞摘要	P2
電子報研究	分析競爭對手電子報，獲取內容靈感	P3
AI 分析整合	OpenAI API 整合，深度分析功能	P3

Claude Code 斜線命令

命令	功能
/weekly-checkin	智能每週檢查，根據專案脈絡動態追蹤指標
/daily-checkin	每日反思檢查，追蹤心情、能量和成就
/daily-brief	個人化晨間新聞簡報
/brain-dump-analysis	從自由書寫中提取洞察和思維模式
/newsletter-research	分析電子報內容並生成草稿
/prd-generator	互動式 PRD 生成器
/task-orchestrator	專案任務協調與監控

技術堆疊

桌面應用

• 前端: HTML5 + CSS3 + ES6 (Vanilla JavaScript)
• 後端: Rust 1.75+ + Tauri 2.x
• 資料儲存: 本地 Markdown 檔案（無資料庫）
• AI 整合: OpenAI API (可選)

主要 Rust 依賴

tauri = "2"              # 跨平台桌面框架
serde = "1"              # 序列化/反序列化
tokio = "1"              # 非同步執行時
chrono = "0.4"           # 日期時間處理
regex = "1"              # 正則表達式解析
reqwest = "0.11"         # HTTP 客戶端
tracing = "0.1"          # 日誌記錄

Claude Code 框架

• 開發生命週期: 16 個 Loop 機制覆蓋完整 SDLC
• 代理人系統: 專業化子代理人處理特定任務
• 規則引擎: 可配置的工作流規則和品質關卡
• 上下文恢復: 自動保存和恢復開發狀態

快速開始

系統需求

• 作業系統: Windows 10+, macOS 10.15+, Linux (GTK 3.24+)
• Rust: 1.75+
• Node.js: 18+
• npm: 9+

安裝步驟

# 1. 複製專案
git clone <repository-url>
cd "for weekly checkin(task)"

# 2. 進入應用程式目錄
cd weekly-checkin

# 3. 安裝依賴
npm install

# 4. 開發模式執行
npm run tauri dev

# 5. 建置發行版本
npm run tauri build

Linux 額外依賴

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev

# Fedora
sudo dnf install webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel

使用說明

每日打卡

在應用程式中輸入自由格式文字：

今天心情 8 分，精力 7 分。

完成的事項：
- 完成專案規格
- 修復 3 個 bug
- 團隊會議

明天計畫：
- 開始實作新功能

感謝：團隊的支持！

系統會自動解析並提取：

• 心情評分 (8/10)
• 精力評分 (7/10)
• 完成事項列表
• 明日計畫
• 感謝項目

週報告

點擊「週報告」後系統會：

1. 彙總當週所有每日打卡
2. 計算平均心情和精力
3. 統計完成事項數量
4. 與上週數據比較顯示趨勢變化

AI 功能設定

1. 前往「設定」頁面
2. 輸入 OpenAI API Key
3. 點擊「儲存」

設定完成後可使用：

• 思維傾倒 AI 分析
• 每日簡報生成
• 電子報內容分析

資料儲存

所有資料以 Markdown 格式儲存在本地，完全保護隱私：

~/.weekly-checkin/          # macOS/Linux
%APPDATA%\weekly-checkin\   # Windows
├── journal/daily/          # 每日打卡 (YYYY-MM-DD.md)
├── metrics/                # 週報告和指標歷史
├── braindumps/             # 思維傾倒
├── briefs/                 # 每日簡報
├── newsletter/             # 電子報研究
└── settings.yaml           # 應用程式設定

開發框架

GitHub Spec Kit 整合

本專案使用 GitHub Spec Kit 資料結構：

specs/{feature_name}/
├── spec.md          # 功能規格（使用者故事、需求）
├── plan.md          # 實施計畫（技術堆疊、架構）
├── tasks.md         # 任務清單
├── data-model.md    # 資料模型
└── contracts/       # API 合約

開發生命週期 (16 Loop)

Phase 0: 需求與設計

• Requirements Loop
• Design Review Loop
• Spec Validation Loop

Phase 1: 實作（每個任務）

• Code Loop
• Code Simplify Loop
• Build & Lint Loop
• Unit Test Loop
• Code Review Loop
• Integration Test Loop
• Quality Gate Loop
• Commit Loop

Phase 2: 驗證與部署

• E2E Verification Loop
• Security Scan Loop
• Deploy Staging Loop
• Smoke Test Loop
• Deploy Production Loop

品質配置

專案使用 .claude-config.yaml 配置品質標準：

defaults:
  coverage_threshold: 80
  max_iterations:
    unit_test_loop: 5
    build_lint_loop: 5

專案結構詳解

前端 (weekly-checkin/src/)

src/
├── index.html      # 主頁面
├── main.js         # 入口點
├── css/            # 樣式檔案
└── js/             # 功能模組
    ├── daily.js    # 每日打卡
    ├── weekly.js   # 週報告
    └── ...

後端 (weekly-checkin/src-tauri/src/)

src/
├── lib.rs          # 主要入口
├── commands/       # Tauri 命令 (IPC 介面)
├── models/         # 資料模型
├── services/       # 業務邏輯
└── utils/          # 工具函式

Claude 框架 (.claude/)

.claude/
├── commands/       # 斜線命令定義
├── skills/         # 專業技能模組
├── agents/         # 子代理人定義
├── rules/          # 工作流規則
│   ├── workflow-orchestration.md
│   ├── loop-controller.md
│   └── tech/       # 技術規範
└── hooks/          # 事件鉤子

成功指標

指標	目標值
每日打卡完成時間	< 2 分鐘
應用程式啟動時間	< 3 秒
閒置時記憶體使用	< 50 MB
閒置時 CPU 使用	< 2%
週報告生成時間	< 5 秒
安裝檔案大小	< 30 MB

授權

MIT License

貢獻

歡迎提交 Issue 和 Pull Request！

在提交程式碼之前，請確保：

1. 通過所有單元測試
2. 程式碼覆蓋率 >= 80%
3. 通過 Lint 檢查
4. 程式碼審查通過