mirror of
https://github.com/tiennm99/ccs.git
synced 2026-08-06 10:20:52 +00:00
docs: restructure README files with parallel workflow messaging and user path guidance
This commit is contained in:
+105
-15
@@ -161,34 +161,124 @@ ccs glmt "推論ステップ付き複雑なアルゴリズムのデバッグ"
|
||||
|
||||
## 開発者の日常的な課題
|
||||
|
||||
<div align="center">
|
||||
|
||||
### **切り替えを停止。調整を開始。**
|
||||
|
||||
**セッション制限がフロー状態を殺すべきではありません。**
|
||||
</div>
|
||||
|
||||
開発者は日々多くのサブスクリプションシナリオに直面します:
|
||||
実装に深く集中しています。コンテキストが読み込まれました。解決策が結晶化しています。<br>
|
||||
その後: 🔴 _"使用制限に達しました。"_
|
||||
|
||||
1. **アカウント分離** - 会社のClaudeアカウント vs 個人Claude → 業務と個人のコンテキストを手動で切り替える必要
|
||||
2. **レート制限** - Claudeがプロジェクト途中で停止 → 手動で`~/.claude/settings.json`を編集
|
||||
3. **コスト管理** - 2-3つのProサブスクリプション(月$20) vs Claude Maxの5倍コスト(月$100)→ Pro階層が実用的な上限
|
||||
4. **モデル選択** - タスクごとに異なるモデルの強みを活用 → 手動切り替え
|
||||
**モチベーションが失われました。コンテキストが失われました。生産性が崩壊しました。**
|
||||
|
||||
**手動コンテキスト切り替えはワークフローを中断します。CCSがシームレスに管理します。**
|
||||
## **解決策:並列ワークフロー**
|
||||
|
||||
<br>
|
||||
<details>
|
||||
<summary><strong>❌ 古い方法:</strong> 制限に達した時に切り替える(反応的)</summary>
|
||||
|
||||
### 現在のワークフロー:
|
||||
- **14時:** 機能開発、ゾーン状態
|
||||
- **15時:** 🔴 使用制限に達した
|
||||
- **15:05:** 作業停止、`~/.claude/settings.json`を編集
|
||||
- **15:15:** アカウント切り替え、コンテキストが失われる
|
||||
- **15:30:** フロー状態に戻ろうと試みる
|
||||
- **16時:** ついに生産性が回復
|
||||
|
||||
- **結果:** 1時間失われ、モチベーションが破壊され、不満が蓄積
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>✨ 新しい方法:</strong> 最初から並列で実行(主導的) - <strong>推奨</strong></summary>
|
||||
|
||||
### 新しいワークフロー:
|
||||
- **14時:** **ターミナル1:** `ccs "APIアーキテクチャを計画"` → 戦略的思考(Claude Pro)
|
||||
- **14時:** **ターミナル2:** `ccs glm "エンドポイントを実装"` → コード実行(GLM)
|
||||
- **15時:** まだ開発継続、割れなし
|
||||
- **16時:** フロー状態達成、生産性急上昇
|
||||
- **17時:** 機能が完了、コンテキスト維持
|
||||
|
||||
- **結果:** ダウムタイムなし、継続的生産性、不満減少
|
||||
|
||||
### 💰 **価値提案:**
|
||||
- **設定:** 既存のClaude Pro + GLM Lite(費用対効果の高い追加)
|
||||
- **価値:** 1時間/日 × 20労働日 = 20時間/月を回収
|
||||
- **ROI:** 開発時間は設定コスト以上の価値がある
|
||||
- **現実:** オーバーヘッドより速く出荷
|
||||
|
||||
</details>
|
||||
|
||||
## あなたの道を選択
|
||||
|
||||
<details>
|
||||
<summary><strong>予算重視:</strong> GLMのみ</summary>
|
||||
|
||||
- **最適:** 費用意識の高い開発、基本的なコード生成
|
||||
- **使用法:** 費用効果の高いAI支援のために`ccs glm`を直接使用
|
||||
- **現実:** Claudeアクセスなし、多くのコーディングタスクに対応可能
|
||||
- **設定:** GLM APIキーのみ、非常に手頃
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>✨ 日々の開発に推奨:</strong> 1 Claude Pro + 1 GLM Lite</summary>
|
||||
|
||||
- **最適:** 日々のコードデリバリー、真剣な開発作業
|
||||
- **使用法:** `ccs`で計画 + `ccs glm`で実行(並列ワークフロー)
|
||||
- **現実:** ほとんどの開発者にとって能力と費用の完璧なバランス
|
||||
- **価値:** セッション制限に達せず、継続的生産性
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>パワーユーザー:</strong> 複数のClaude Pro + GLM Pro</summary>
|
||||
|
||||
- **最適:** 重い作業量、並行プロジェクト、ソロ開発
|
||||
- **解放:** セッション・週次制限を決して枯渇させない
|
||||
- **ワークフロー:** 3+以上のターミナルで専門タスクを同時実行
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>プライバシー重視:</strong> 仕事/個人の分離</summary>
|
||||
|
||||
- **必要時:** 仕事と個人AIコンテキストの厳格な分離
|
||||
- **設定:** `ccs auth create work` + `ccs auth create personal`
|
||||
- **注意:** 高度な機能 - ほとんどのユーザーには不要
|
||||
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## 手動切り替えではなくCCSを使う理由は?
|
||||
|
||||
<div align="center">
|
||||
|
||||
| 機能 | 利益 |
|
||||
|:--------|:--------|
|
||||
| **アカウント分離** | 業務と個人を分離 |
|
||||
| **コスト最適化** | 2-3つのProアカウント vs Max 5倍コスト |
|
||||
| **即座の切り替え** | 1コマンド、ファイル編集不要 |
|
||||
| **ゼロダウンタイム** | ワークフロー中断なし |
|
||||
| **レート制限管理** | 制限時にアカウント切り替え |
|
||||
| **クロスプラットフォーム** | macOS、Linux、Windows |
|
||||
**CCSは「午後3時に制限に達したら切り替える」ことではありません。**
|
||||
|
||||
## **それは最初から並列で実行することです。**
|
||||
|
||||
</div>
|
||||
|
||||
### コアな違い
|
||||
|
||||
| **手動切り替え** | **CCSオーケストレーション** |
|
||||
|:---|:---|
|
||||
| 🔴 制限達成 → 作業停止 → 設定ファイル編集 → 再起動 | ✅ 最初から異なるモデルで複数ターミナルを実行 |
|
||||
| 😰 コンテキストロスとフロー状態中断 | 😌 コンテキスト維持での継続的生産性 |
|
||||
| 📝 逐次的タスク処理 | ⚡ 並列ワークフロー(計画 + 実行を同時に) |
|
||||
| 🛠️ ブロックされた時の反応的問題解決 | 🎯 ブロックを防ぐ主導的ワークフロー設計 |
|
||||
|
||||
### CCSが提供するもの
|
||||
|
||||
- **ゼロコンテキスト切り替え:** 割れずにフロー状態を維持
|
||||
- **並列生産性:** 1ターミナルで戦略計画、もう1つでコード実行
|
||||
- **即座アカウント管理:** 1コマンド切り替え、設定ファイル編集不要
|
||||
- **仕事と生活の分離:** ログアウトせずにコンテキストを分離
|
||||
- **クロスプラットフォーム一貫性:** macOS、Linux、Windowsで同じスムーズな体験
|
||||
|
||||
<br>
|
||||
|
||||
## アーキテクチャ
|
||||
|
||||
@@ -157,34 +157,126 @@ ccs glmt "Debug complex algorithm with reasoning steps"
|
||||
|
||||
## The Daily Developer Pain Point
|
||||
|
||||
<div align="center">
|
||||
|
||||
### **STOP Switching. START Orchestrating.**
|
||||
|
||||
**Session limits shouldn't kill your flow state.**
|
||||
</div>
|
||||
|
||||
Developers face multiple subscription scenarios daily:
|
||||
You're deep in implementation. Context loaded. Solution crystallizing.<br>
|
||||
Then: 🔴 _"You've reached your usage limit."_
|
||||
|
||||
1. **Account Separation** - Company Claude account vs personal Claude → you must manually switch contexts to keep work and personal separate
|
||||
2. **Rate Limits Hit** - Claude stops mid-project → you manually edit `~/.claude/settings.json`
|
||||
3. **Cost Management** - 2-3 Pro subscriptions ($20/month each) vs Claude Max at 5x cost ($100/month) → Pro tier is the practical ceiling for most developers
|
||||
4. **Model Choice** - Different tasks benefit from different model strengths → manual switching
|
||||
**Momentum gone. Context lost. Productivity crater.**
|
||||
|
||||
**Manual context switching breaks your workflow. CCS manages it seamlessly.**
|
||||
## **The Solution: Parallel Workflows**
|
||||
|
||||
<br>
|
||||
<details>
|
||||
<summary><strong>❌ OLD WAY:</strong> Switch When You Hit Limits (Reactive)</summary>
|
||||
|
||||
### Your Current Workflow:
|
||||
- **2pm:** Building features, in the zone
|
||||
- **3pm:** 🔴 Usage limit hit
|
||||
- **3:05pm:** Stop work, edit `~/.claude/settings.json`
|
||||
- **3:15pm:** Switch accounts, lose context
|
||||
- **3:30pm:** Try to get back in flow state
|
||||
- **4pm:** Finally productive again
|
||||
|
||||
- **Result:** 1 hour lost, momentum destroyed, frustration builds
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>✨ NEW WAY:</strong> Run Parallel From Start (Proactive) - <strong>RECOMMENDED</strong></summary>
|
||||
|
||||
### Your New Workflow:
|
||||
- **2pm:** **Terminal 1:** `ccs "Plan the API architecture"` → Strategic thinking (Claude Pro)
|
||||
- **2pm:** **Terminal 2:** `ccs glm "Implement the endpoints"` → Code execution (GLM)
|
||||
- **3pm:** Still shipping, no interruptions
|
||||
- **4pm:** Flow state achieved, productivity spiking
|
||||
- **5pm:** Features shipped, context maintained
|
||||
|
||||
- **Result:** Zero downtime, continuous productivity, less frustration
|
||||
|
||||
### 💰 **The Value Proposition:**
|
||||
- **Setup:** Your existing Claude Pro + GLM Lite (cost-effective add-on)
|
||||
- **Value:** Save 1 hour/day × 20 workdays = 20 hours/month recovered
|
||||
- **ROI:** Your development time is worth more than the setup cost
|
||||
- **Reality:** Shipping faster than the overhead
|
||||
|
||||
</details>
|
||||
|
||||
## Choose Your Path
|
||||
|
||||
<details>
|
||||
<summary><strong>Budget-Focused:</strong> GLM Only</summary>
|
||||
|
||||
- **Best for:** Cost-conscious development, basic code generation
|
||||
- **Usage:** Just use `ccs glm` directly for cost-effective AI assistance
|
||||
- **Reality:** No Claude access, but capable for many coding tasks
|
||||
- **Setup:** GLM API key only, very affordable
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>✨ Recommended for Daily Development:</strong> 1 Claude Pro + 1 GLM Lite</summary>
|
||||
|
||||
- **Best for:** Daily code delivery, serious development work
|
||||
- **Usage:** `ccs` for planning + `ccs glm` for execution (parallel workflow)
|
||||
- **Reality:** Perfect balance of capability and cost for most developers
|
||||
- **Value:** Never hit session limits, continuous productivity
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>Power User:</strong> Multiple Claude Pro + GLM Pro</summary>
|
||||
|
||||
- **Best for:** Heavy workloads, concurrent projects, solo dev
|
||||
- **Unlocks:** Never drain session or weekly limits
|
||||
- **Workflow:** 3+ terminals running specialized tasks simultaneously
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>Privacy-Focused:</strong> Work/Personal Isolation</summary>
|
||||
|
||||
- **When needed:** Strict separation of work and personal AI contexts
|
||||
- **Setup:** `ccs auth create work` + `ccs auth create personal`
|
||||
- **Note:** Advanced feature - most users don't need this
|
||||
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## Why CCS Instead of Manual Switching?
|
||||
|
||||
<div align="center">
|
||||
|
||||
| Feature | Benefit |
|
||||
|:--------|:--------|
|
||||
| **Account Isolation** | Keep work separate from personal |
|
||||
| **Cost Optimization** | 2-3 Pro accounts vs Max at 5x cost |
|
||||
| **Instant Switching** | One command, no file editing |
|
||||
| **Zero Downtime** | Never interrupt workflow |
|
||||
| **Rate Limit Management** | Switch accounts when limits hit |
|
||||
| **Cross-Platform** | macOS, Linux, Windows |
|
||||
**CCS isn't about "switching when you hit limits at 3pm."**
|
||||
|
||||
## **It's about running in parallel from the start.**
|
||||
|
||||
</div>
|
||||
|
||||
### The Core Difference
|
||||
|
||||
| **Manual Switching** | **CCS Orchestration** |
|
||||
|:---|:---|
|
||||
| 🔴 Hit limits → Stop work → Edit config files → Restart | ✅ Multiple terminals running different models from the start |
|
||||
| 😰 Context loss and flow state interruption | 😌 Continuous productivity with preserved context |
|
||||
| 📝 Sequential task handling | ⚡ Parallel workflows (planning + execution simultaneously) |
|
||||
| 🛠️ Reactive problem solving when blocked | 🎯 Proactive workflow design prevents blocks |
|
||||
|
||||
### What CCS Gives You
|
||||
|
||||
- **Zero Context Switching**: Keep your flow state without interruption
|
||||
- **Parallel Productivity**: Strategic planning in one terminal, code execution in another
|
||||
- **Instant Account Management**: One command switches, no config file editing
|
||||
- **Work-Life Separation**: Isolate contexts without logging out
|
||||
- **Cross-Platform Consistency**: Same smooth experience on macOS, Linux, Windows
|
||||
|
||||
**Manual context switching breaks workflow. CCS orchestrates seamlessly.**
|
||||
|
||||
<br>
|
||||
|
||||
## Architecture
|
||||
@@ -322,8 +414,6 @@ ccs --help # Show all commands and options
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
<summary><h3>Tool Support (v3.5) - EXPERIMENTAL</h3></summary>
|
||||
|
||||
|
||||
+106
-16
@@ -161,34 +161,124 @@ ccs glmt "Debug complex algorithm with reasoning steps"
|
||||
|
||||
## The Daily Developer Pain Point
|
||||
|
||||
**Session limits shouldn't kill your flow state.**
|
||||
<div align="center">
|
||||
|
||||
Developers face multiple subscription scenarios daily:
|
||||
### **DỪNG việc chuyển đổi. BẮT ĐẦU điều phối.**
|
||||
|
||||
1. **Account Separation** - Company Claude account vs personal Claude → you must manually switch contexts to keep work and personal separate
|
||||
2. **Rate Limits Hit** - Claude stops mid-project → you manually edit `~/.claude/settings.json`
|
||||
3. **Cost Management** - 2-3 Pro subscriptions ($20/month each) vs Claude Max at 5x cost ($100/month) → Pro tier is the practical ceiling for most developers
|
||||
4. **Model Choice** - Different tasks benefit from different model strengths → manual switching
|
||||
**Giới hạn phiên không nên phá hỏng trạng thái dòng chảy của bạn.**
|
||||
</div>
|
||||
|
||||
**Manual context switching breaks your workflow. CCS manages it seamlessly.**
|
||||
Bạn đang sâu trong triển khai. Ngữ cảnh đã tải. Giải pháp đang kết tinh.<br>
|
||||
Sau đó: 🔴 _"Bạn đã đạt đến giới hạn sử dụng."_
|
||||
|
||||
<br>
|
||||
**Động lực mất đi. Ngữ cảnh mất. Năng suất sụp đổ.**
|
||||
|
||||
## **Giải pháp: Quy trình công việc song song**
|
||||
|
||||
<details>
|
||||
<summary><strong>❌ CÁCH CŨ:</strong> Chuyển đổi khi bạn đạt đến giới hạn (Phản ứng)</summary>
|
||||
|
||||
### Quy trình làm việc hiện tại của bạn:
|
||||
- **2pm:** Xây dựng tính năng, trong vùng
|
||||
- **3pm:** 🔴 Đạt giới hạn sử dụng
|
||||
- **3:05pm:** Dừng công việc, chỉnh sửa `~/.claude/settings.json`
|
||||
- **3:15pm:** Chuyển tài khoản, mất ngữ cảnh
|
||||
- **3:30pm:** Cố gắng quay lại trạng thái dòng chảy
|
||||
- **4pm:** Cuối cùng cũng năng suất trở lại
|
||||
|
||||
- **Kết quả:** Mất 1 giờ, động lực bị phá hủy, sự thất vọng tăng lên
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>✨ CÁCH MỚI:</strong> Chạy song song ngay từ đầu (Chủ động) - <strong>ĐƯỢC KHUYÊN NGHỊ</strong></summary>
|
||||
|
||||
### Quy trình làm việc mới của bạn:
|
||||
- **2pm:** **Terminal 1:** `ccs "Lập kế hoạch kiến trúc API"` → Tư duy chiến lược (Claude Pro)
|
||||
- **2pm:** **Terminal 2:** `ccs glm "Triển khai các điểm cuối API"` → Thực thi mã (GLM)
|
||||
- **3pm:** Vẫn đang giao hàng, không có gián đoạn
|
||||
- **4pm:** Đạt trạng thái dòng chảy, năng suất tăng vọt
|
||||
- **5pm:** Tính năng đã giao hàng, ngữ cảnh được duy trì
|
||||
|
||||
- **Kết quả:** Không có thời gian chết, năng suất liên tục, ít thất vọng hơn
|
||||
|
||||
### 💰 **Giá trị đề xuất:**
|
||||
- **Thiết lập:** Claude Pro hiện tại của bạn + GLM Lite (add-on hiệu quả về chi phí)
|
||||
- **Giá trị:** Tiết kiệm 1 giờ/ngày × 20 ngày làm việc = 20 giờ/tháng được phục hồi
|
||||
- **ROI:** Thời gian phát triển của bạn có giá trị hơn chi phí thiết lập
|
||||
- **Thực tế:** Giao hàng nhanh hơn chi phí vận hành
|
||||
|
||||
</details>
|
||||
|
||||
## Chọn con đường của bạn
|
||||
|
||||
<details>
|
||||
<summary><strong>Tập trung vào ngân sách:</strong> Chỉ GLM</summary>
|
||||
|
||||
- **Tốt nhất cho:** Phát triển tiết kiệm chi phí, tạo mã cơ bản
|
||||
- **Sử dụng:** Chỉ sử dụng `ccs glm` trực tiếp để được trợ giúp AI hiệu quả về chi phí
|
||||
- **Thực tế:** Không có quyền truy cập Claude, nhưng có khả năng cho nhiều nhiệm vụ mã hóa
|
||||
- **Thiết lập:** Chỉ cần API key GLM, rất phải chăng
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<summary><strong>✨ Được khuyên nghị cho phát triển hàng ngày:</strong> 1 Claude Pro + 1 GLM Lite</summary>
|
||||
|
||||
- **Tốt nhất cho:** Giao hàng mã hàng ngày, công việc phát triển nghiêm túc
|
||||
- **Sử dụng:** `ccs` để lập kế hoạch + `ccs glm` để thực thi (quy trình công việc song song)
|
||||
- **Thực tế:** Cân bằng hoàn hảo giữa khả năng và chi phí cho hầu hết các nhà phát triển
|
||||
- **Giá trị:** Không bao giờ đạt đến giới hạn phiên, năng suất liên tục
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>Power User:</strong> Nhiều Claude Pro + GLM Pro</summary>
|
||||
|
||||
- **Tốt nhất cho:** Nhiều công việc, dự án đồng thời, solo dev
|
||||
- **Mở khóa:** Không bao giờ cạn kiệt giới hạn phiên hoặc hàng tuần
|
||||
- **Quy trình làm việc:** 3+ terminal chạy các nhiệm vụ chuyên biệt đồng thời
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><strong>Tập trung vào quyền riêng tư:</strong> Cách ly Công việc/Cá nhân</summary>
|
||||
|
||||
- **Khi cần:** Cách ly nghiêm ngặt ngữ cảnh AI công việc và cá nhân
|
||||
- **Thiết lập:** `ccs auth create work` + `ccs auth create personal`
|
||||
- **Lưu ý:** Tính năng nâng cao - hầu hết người dùng không cần điều này
|
||||
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## Why CCS Instead of Manual Switching?
|
||||
|
||||
<div align="center">
|
||||
|
||||
| Feature | Benefit |
|
||||
|:--------|:--------|
|
||||
| **Account Isolation** | Keep work separate from personal |
|
||||
| **Cost Optimization** | 2-3 Pro accounts vs Max at 5x cost |
|
||||
| **Instant Switching** | One command, no file editing |
|
||||
| **Zero Downtime** | Never interrupt workflow |
|
||||
| **Rate Limit Management** | Switch accounts when limits hit |
|
||||
| **Cross-Platform** | macOS, Linux, Windows |
|
||||
**CCS không phải về "chuyển đổi khi bạn đạt đến giới hạn lúc 3pm."**
|
||||
|
||||
## **Nó về việc chạy song song ngay từ đầu.**
|
||||
|
||||
</div>
|
||||
|
||||
### Sự khác biệt cốt lõi
|
||||
|
||||
| **Chuyển đổi thủ công** | **Điều phối CCS** |
|
||||
|:---|:---|
|
||||
| 🔴 Đạt giới hạn → Dừng công việc → Chỉnh sửa tệp cấu hình → Khởi động lại | ✅ Nhiều terminal chạy các mô hình khác nhau ngay từ đầu |
|
||||
| 😰 Mất ngữ cảnh và gián đoạn trạng thái dòng chảy | 😌 Năng suất liên tục với ngữ cảnh được bảo toàn |
|
||||
| 📝 Xử lý nhiệm vụ tuần tự | ⚡ Quy trình công việc song song (lập kế hoạch + thực thi đồng thời) |
|
||||
| 🛠️ Giải quyết vấn đề phản ứng khi bị chặn | 🎯 Thiết kế quy trình công việc chủ động ngăn chặn chặn |
|
||||
|
||||
### CCS mang lại cho bạn
|
||||
|
||||
- **Không chuyển đổi ngữ cảnh:** Duy trì trạng thái dòng chảy của bạn mà không bị gián đoạn
|
||||
- **Năng suất song song:** Lập kế hoạch chiến lược trong một terminal, thực thi mã trong terminal khác
|
||||
- **Quản lý tài khoản tức thì:** Một lệnh chuyển đổi, không cần chỉnh sửa tệp cấu hình
|
||||
- **Cách ly công việc-cuộc sống:** Cách ly ngữ cảnh mà không cần đăng xuất
|
||||
- **Tính nhất quán đa nền tảng:** Trải nghiệm mượt mà tương tự trên macOS, Linux, Windows
|
||||
|
||||
<br>
|
||||
|
||||
## Architecture
|
||||
|
||||
Reference in New Issue
Block a user