mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-30 13:43:26 +08:00
Revert "feat(ecc): prune plugin 43→12 items, promote 7 rules to .claude/rules/ (#245)"
This reverts commit 1bd68ff534.
This commit is contained in:
Affaan Mustafa
477
docs/zh-TW/README.md
Normal file
477
docs/zh-TW/README.md
Normal file
@@ -0,0 +1,477 @@
|
||||
# Everything Claude Code
|
||||
|
||||
[](https://github.com/affaan-m/everything-claude-code/stargazers)
|
||||
[](LICENSE)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
**🌐 Language / 语言 / 語言**
|
||||
|
||||
[**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](README.md) | [日本語](../../docs/ja-JP/README.md)
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
**來自 Anthropic 黑客松冠軍的完整 Claude Code 設定集合。**
|
||||
|
||||
經過 10 個月以上密集日常使用、打造真實產品所淬煉出的生產就緒代理程式、技能、鉤子、指令、規則和 MCP 設定。
|
||||
|
||||
---
|
||||
|
||||
## 指南
|
||||
|
||||
本儲存庫僅包含原始程式碼。指南會解釋所有內容。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%">
|
||||
<a href="https://x.com/affaanmustafa/status/2012378465664745795">
|
||||
<img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="Everything Claude Code 簡明指南" />
|
||||
</a>
|
||||
</td>
|
||||
<td width="50%">
|
||||
<a href="https://x.com/affaanmustafa/status/2014040193557471352">
|
||||
<img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="Everything Claude Code 完整指南" />
|
||||
</a>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><b>簡明指南</b><br/>設定、基礎、理念。<b>請先閱讀此指南。</b></td>
|
||||
<td align="center"><b>完整指南</b><br/>權杖最佳化、記憶持久化、評估、平行處理。</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
| 主題 | 學習內容 |
|
||||
|------|----------|
|
||||
| 權杖最佳化 | 模型選擇、系統提示精簡、背景程序 |
|
||||
| 記憶持久化 | 自動跨工作階段儲存/載入上下文的鉤子 |
|
||||
| 持續學習 | 從工作階段自動擷取模式並轉化為可重用技能 |
|
||||
| 驗證迴圈 | 檢查點 vs 持續評估、評分器類型、pass@k 指標 |
|
||||
| 平行處理 | Git worktrees、串聯方法、何時擴展實例 |
|
||||
| 子代理程式協調 | 上下文問題、漸進式檢索模式 |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速開始
|
||||
|
||||
在 2 分鐘內快速上手：
|
||||
|
||||
### 第一步：安裝外掛程式
|
||||
|
||||
```bash
|
||||
# 新增市集
|
||||
/plugin marketplace add affaan-m/everything-claude-code
|
||||
|
||||
# 安裝外掛程式
|
||||
/plugin install everything-claude-code@everything-claude-code
|
||||
```
|
||||
|
||||
### 第二步：安裝規則（必需）
|
||||
|
||||
> ⚠️ **重要提示：** Claude Code 外掛程式無法自動分發 `rules`，需要手動安裝：
|
||||
|
||||
```bash
|
||||
# 首先複製儲存庫
|
||||
git clone https://github.com/affaan-m/everything-claude-code.git
|
||||
|
||||
# 複製規則（應用於所有專案）
|
||||
cp -r everything-claude-code/rules/* ~/.claude/rules/
|
||||
```
|
||||
|
||||
### 第三步：開始使用
|
||||
|
||||
```bash
|
||||
# 嘗試一個指令
|
||||
/plan "新增使用者認證"
|
||||
|
||||
# 查看可用指令
|
||||
/plugin list everything-claude-code@everything-claude-code
|
||||
```
|
||||
|
||||
✨ **完成！** 您現在使用 15+ 代理程式、30+ 技能和 20+ 指令。
|
||||
|
||||
---
|
||||
|
||||
## 🌐 跨平台支援
|
||||
|
||||
此外掛程式現已完整支援 **Windows、macOS 和 Linux**。所有鉤子和腳本已使用 Node.js 重寫以獲得最佳相容性。
|
||||
|
||||
### 套件管理器偵測
|
||||
|
||||
外掛程式會自動偵測您偏好的套件管理器（npm、pnpm、yarn 或 bun），優先順序如下：
|
||||
|
||||
1. **環境變數**：`CLAUDE_PACKAGE_MANAGER`
|
||||
2. **專案設定**：`.claude/package-manager.json`
|
||||
3. **package.json**：`packageManager` 欄位
|
||||
4. **鎖定檔案**：從 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 偵測
|
||||
5. **全域設定**：`~/.claude/package-manager.json`
|
||||
6. **備援方案**：第一個可用的套件管理器
|
||||
|
||||
設定您偏好的套件管理器：
|
||||
|
||||
```bash
|
||||
# 透過環境變數
|
||||
export CLAUDE_PACKAGE_MANAGER=pnpm
|
||||
|
||||
# 透過全域設定
|
||||
node scripts/setup-package-manager.js --global pnpm
|
||||
|
||||
# 透過專案設定
|
||||
node scripts/setup-package-manager.js --project bun
|
||||
|
||||
# 偵測目前設定
|
||||
node scripts/setup-package-manager.js --detect
|
||||
```
|
||||
|
||||
或在 Claude Code 中使用 `/setup-pm` 指令。
|
||||
|
||||
---
|
||||
|
||||
## 📦 內容概覽
|
||||
|
||||
本儲存庫是一個 **Claude Code 外掛程式** - 可直接安裝或手動複製元件。
|
||||
|
||||
```
|
||||
everything-claude-code/
|
||||
|-- .claude-plugin/ # 外掛程式和市集清單
|
||||
| |-- plugin.json # 外掛程式中繼資料和元件路徑
|
||||
| |-- marketplace.json # 用於 /plugin marketplace add 的市集目錄
|
||||
|
|
||||
|-- agents/ # 用於委派任務的專門子代理程式
|
||||
| |-- planner.md # 功能實作規劃
|
||||
| |-- architect.md # 系統設計決策
|
||||
| |-- tdd-guide.md # 測試驅動開發
|
||||
| |-- code-reviewer.md # 品質與安全審查
|
||||
| |-- security-reviewer.md # 弱點分析
|
||||
| |-- build-error-resolver.md
|
||||
| |-- e2e-runner.md # Playwright E2E 測試
|
||||
| |-- refactor-cleaner.md # 無用程式碼清理
|
||||
| |-- doc-updater.md # 文件同步
|
||||
| |-- go-reviewer.md # Go 程式碼審查（新增）
|
||||
| |-- go-build-resolver.md # Go 建置錯誤解決（新增）
|
||||
|
|
||||
|-- skills/ # 工作流程定義和領域知識
|
||||
| |-- coding-standards/ # 程式語言最佳實務
|
||||
| |-- backend-patterns/ # API、資料庫、快取模式
|
||||
| |-- frontend-patterns/ # React、Next.js 模式
|
||||
| |-- continuous-learning/ # 從工作階段自動擷取模式（完整指南）
|
||||
| |-- continuous-learning-v2/ # 基於本能的學習與信心評分
|
||||
| |-- iterative-retrieval/ # 子代理程式的漸進式上下文精煉
|
||||
| |-- strategic-compact/ # 手動壓縮建議（完整指南）
|
||||
| |-- tdd-workflow/ # TDD 方法論
|
||||
| |-- security-review/ # 安全性檢查清單
|
||||
| |-- eval-harness/ # 驗證迴圈評估（完整指南）
|
||||
| |-- verification-loop/ # 持續驗證（完整指南）
|
||||
| |-- golang-patterns/ # Go 慣用語法和最佳實務（新增）
|
||||
| |-- golang-testing/ # Go 測試模式、TDD、基準測試（新增）
|
||||
|
|
||||
|-- commands/ # 快速執行的斜線指令
|
||||
| |-- tdd.md # /tdd - 測試驅動開發
|
||||
| |-- plan.md # /plan - 實作規劃
|
||||
| |-- e2e.md # /e2e - E2E 測試生成
|
||||
| |-- code-review.md # /code-review - 品質審查
|
||||
| |-- build-fix.md # /build-fix - 修復建置錯誤
|
||||
| |-- refactor-clean.md # /refactor-clean - 移除無用程式碼
|
||||
| |-- learn.md # /learn - 工作階段中擷取模式（完整指南）
|
||||
| |-- checkpoint.md # /checkpoint - 儲存驗證狀態（完整指南）
|
||||
| |-- verify.md # /verify - 執行驗證迴圈（完整指南）
|
||||
| |-- setup-pm.md # /setup-pm - 設定套件管理器
|
||||
| |-- go-review.md # /go-review - Go 程式碼審查（新增）
|
||||
| |-- go-test.md # /go-test - Go TDD 工作流程（新增）
|
||||
| |-- go-build.md # /go-build - 修復 Go 建置錯誤（新增）
|
||||
|
|
||||
|-- rules/ # 必須遵守的準則（複製到 ~/.claude/rules/）
|
||||
| |-- security.md # 強制性安全檢查
|
||||
| |-- coding-style.md # 不可變性、檔案組織
|
||||
| |-- testing.md # TDD、80% 覆蓋率要求
|
||||
| |-- git-workflow.md # 提交格式、PR 流程
|
||||
| |-- agents.md # 何時委派給子代理程式
|
||||
| |-- performance.md # 模型選擇、上下文管理
|
||||
|
|
||||
|-- hooks/ # 基於觸發器的自動化
|
||||
| |-- hooks.json # 所有鉤子設定（PreToolUse、PostToolUse、Stop 等）
|
||||
| |-- memory-persistence/ # 工作階段生命週期鉤子（完整指南）
|
||||
| |-- strategic-compact/ # 壓縮建議（完整指南）
|
||||
|
|
||||
|-- scripts/ # 跨平台 Node.js 腳本（新增）
|
||||
| |-- lib/ # 共用工具
|
||||
| | |-- utils.js # 跨平台檔案/路徑/系統工具
|
||||
| | |-- package-manager.js # 套件管理器偵測與選擇
|
||||
| |-- hooks/ # 鉤子實作
|
||||
| | |-- session-start.js # 工作階段開始時載入上下文
|
||||
| | |-- session-end.js # 工作階段結束時儲存狀態
|
||||
| | |-- pre-compact.js # 壓縮前狀態儲存
|
||||
| | |-- suggest-compact.js # 策略性壓縮建議
|
||||
| | |-- evaluate-session.js # 從工作階段擷取模式
|
||||
| |-- setup-package-manager.js # 互動式套件管理器設定
|
||||
|
|
||||
|-- tests/ # 測試套件（新增）
|
||||
| |-- lib/ # 函式庫測試
|
||||
| |-- hooks/ # 鉤子測試
|
||||
| |-- run-all.js # 執行所有測試
|
||||
|
|
||||
|-- contexts/ # 動態系統提示注入上下文（完整指南）
|
||||
| |-- dev.md # 開發模式上下文
|
||||
| |-- review.md # 程式碼審查模式上下文
|
||||
| |-- research.md # 研究/探索模式上下文
|
||||
|
|
||||
|-- examples/ # 範例設定和工作階段
|
||||
| |-- CLAUDE.md # 專案層級設定範例
|
||||
| |-- user-CLAUDE.md # 使用者層級設定範例
|
||||
|
|
||||
|-- mcp-configs/ # MCP 伺服器設定
|
||||
| |-- mcp-servers.json # GitHub、Supabase、Vercel、Railway 等
|
||||
|
|
||||
|-- marketplace.json # 自託管市集設定（用於 /plugin marketplace add）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 生態系統工具
|
||||
|
||||
### ecc.tools - 技能建立器
|
||||
|
||||
從您的儲存庫自動生成 Claude Code 技能。
|
||||
|
||||
[安裝 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)
|
||||
|
||||
分析您的儲存庫並建立：
|
||||
- **SKILL.md 檔案** - 可直接用於 Claude Code 的技能
|
||||
- **本能集合** - 用於 continuous-learning-v2
|
||||
- **模式擷取** - 從您的提交歷史學習
|
||||
|
||||
```bash
|
||||
# 安裝 GitHub App 後，技能會出現在：
|
||||
~/.claude/skills/generated/
|
||||
```
|
||||
|
||||
與 `continuous-learning-v2` 技能無縫整合以繼承本能。
|
||||
|
||||
---
|
||||
|
||||
## 📥 安裝
|
||||
|
||||
### 選項 1：以外掛程式安裝（建議）
|
||||
|
||||
使用本儲存庫最簡單的方式 - 安裝為 Claude Code 外掛程式：
|
||||
|
||||
```bash
|
||||
# 將此儲存庫新增為市集
|
||||
/plugin marketplace add affaan-m/everything-claude-code
|
||||
|
||||
# 安裝外掛程式
|
||||
/plugin install everything-claude-code@everything-claude-code
|
||||
```
|
||||
|
||||
或直接新增到您的 `~/.claude/settings.json`：
|
||||
|
||||
```json
|
||||
{
|
||||
"extraKnownMarketplaces": {
|
||||
"everything-claude-code": {
|
||||
"source": {
|
||||
"source": "github",
|
||||
"repo": "affaan-m/everything-claude-code"
|
||||
}
|
||||
}
|
||||
},
|
||||
"enabledPlugins": {
|
||||
"everything-claude-code@everything-claude-code": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
這會讓您立即存取所有指令、代理程式、技能和鉤子。
|
||||
|
||||
---
|
||||
|
||||
### 🔧 選項 2：手動安裝
|
||||
|
||||
如果您偏好手動控制安裝內容：
|
||||
|
||||
```bash
|
||||
# 複製儲存庫
|
||||
git clone https://github.com/affaan-m/everything-claude-code.git
|
||||
|
||||
# 將代理程式複製到您的 Claude 設定
|
||||
cp everything-claude-code/agents/*.md ~/.claude/agents/
|
||||
|
||||
# 複製規則
|
||||
cp everything-claude-code/rules/*.md ~/.claude/rules/
|
||||
|
||||
# 複製指令
|
||||
cp everything-claude-code/commands/*.md ~/.claude/commands/
|
||||
|
||||
# 複製技能
|
||||
cp -r everything-claude-code/skills/* ~/.claude/skills/
|
||||
```
|
||||
|
||||
#### 將鉤子新增到 settings.json
|
||||
|
||||
將 `hooks/hooks.json` 中的鉤子複製到您的 `~/.claude/settings.json`。
|
||||
|
||||
#### 設定 MCP
|
||||
|
||||
將 `mcp-configs/mcp-servers.json` 中所需的 MCP 伺服器複製到您的 `~/.claude.json`。
|
||||
|
||||
**重要：** 將 `YOUR_*_HERE` 佔位符替換為您實際的 API 金鑰。
|
||||
|
||||
---
|
||||
|
||||
## 🎯 核心概念
|
||||
|
||||
### 代理程式（Agents）
|
||||
|
||||
子代理程式以有限範圍處理委派的任務。範例：
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: code-reviewer
|
||||
description: Reviews code for quality, security, and maintainability
|
||||
tools: ["Read", "Grep", "Glob", "Bash"]
|
||||
model: opus
|
||||
---
|
||||
|
||||
You are a senior code reviewer...
|
||||
```
|
||||
|
||||
### 技能（Skills）
|
||||
|
||||
技能是由指令或代理程式調用的工作流程定義：
|
||||
|
||||
```markdown
|
||||
# TDD Workflow
|
||||
|
||||
1. Define interfaces first
|
||||
2. Write failing tests (RED)
|
||||
3. Implement minimal code (GREEN)
|
||||
4. Refactor (IMPROVE)
|
||||
5. Verify 80%+ coverage
|
||||
```
|
||||
|
||||
### 鉤子（Hooks）
|
||||
|
||||
鉤子在工具事件時觸發。範例 - 警告 console.log：
|
||||
|
||||
```json
|
||||
{
|
||||
"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
|
||||
"hooks": [{
|
||||
"type": "command",
|
||||
"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
### 規則（Rules）
|
||||
|
||||
規則是必須遵守的準則。保持模組化：
|
||||
|
||||
```
|
||||
~/.claude/rules/
|
||||
security.md # 禁止寫死密鑰
|
||||
coding-style.md # 不可變性、檔案限制
|
||||
testing.md # TDD、覆蓋率要求
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 執行測試
|
||||
|
||||
外掛程式包含完整的測試套件：
|
||||
|
||||
```bash
|
||||
# 執行所有測試
|
||||
node tests/run-all.js
|
||||
|
||||
# 執行個別測試檔案
|
||||
node tests/lib/utils.test.js
|
||||
node tests/lib/package-manager.test.js
|
||||
node tests/hooks/hooks.test.js
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🤝 貢獻
|
||||
|
||||
**歡迎並鼓勵貢獻。**
|
||||
|
||||
本儲存庫旨在成為社群資源。如果您有：
|
||||
- 實用的代理程式或技能
|
||||
- 巧妙的鉤子
|
||||
- 更好的 MCP 設定
|
||||
- 改進的規則
|
||||
|
||||
請貢獻！詳見 [CONTRIBUTING.md](CONTRIBUTING.md) 的指南。
|
||||
|
||||
### 貢獻想法
|
||||
|
||||
- 特定語言的技能（Python、Rust 模式）- Go 現已包含！
|
||||
- 特定框架的設定（Django、Rails、Laravel）
|
||||
- DevOps 代理程式（Kubernetes、Terraform、AWS）
|
||||
- 測試策略（不同框架）
|
||||
- 特定領域知識（ML、資料工程、行動開發）
|
||||
|
||||
---
|
||||
|
||||
## 📖 背景
|
||||
|
||||
我從實驗性推出就開始使用 Claude Code。2025 年 9 月與 [@DRodriguezFX](https://x.com/DRodriguezFX) 一起使用 Claude Code 打造 [zenith.chat](https://zenith.chat)，贏得了 Anthropic x Forum Ventures 黑客松。
|
||||
|
||||
這些設定已在多個生產應用程式中經過實戰測試。
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 重要注意事項
|
||||
|
||||
### 上下文視窗管理
|
||||
|
||||
**關鍵：** 不要同時啟用所有 MCP。啟用過多工具會讓您的 200k 上下文視窗縮減至 70k。
|
||||
|
||||
經驗法則：
|
||||
- 設定 20-30 個 MCP
|
||||
- 每個專案啟用少於 10 個
|
||||
- 啟用的工具少於 80 個
|
||||
|
||||
在專案設定中使用 `disabledMcpServers` 來停用未使用的 MCP。
|
||||
|
||||
### 自訂
|
||||
|
||||
這些設定適合我的工作流程。您應該：
|
||||
1. 從您認同的部分開始
|
||||
2. 根據您的技術堆疊修改
|
||||
3. 移除不需要的部分
|
||||
4. 添加您自己的模式
|
||||
|
||||
---
|
||||
|
||||
## 🌟 Star 歷史
|
||||
|
||||
[](https://star-history.com/#affaan-m/everything-claude-code&Date)
|
||||
|
||||
---
|
||||
|
||||
## 🔗 連結
|
||||
|
||||
- **簡明指南（從這裡開始）：** [Everything Claude Code 簡明指南](https://x.com/affaanmustafa/status/2012378465664745795)
|
||||
- **完整指南（進階）：** [Everything Claude Code 完整指南](https://x.com/affaanmustafa/status/2014040193557471352)
|
||||
- **追蹤：** [@affaanmustafa](https://x.com/affaanmustafa)
|
||||
- **zenith.chat：** [zenith.chat](https://zenith.chat)
|
||||
- **技能目錄：** [awesome-agent-skills](https://github.com/JackyST0/awesome-agent-skills)
|
||||
|
||||
---
|
||||
|
||||
## 📄 授權
|
||||
|
||||
MIT - 自由使用、依需求修改、如可能請回饋貢獻。
|
||||
|
||||
---
|
||||
|
||||
**如果有幫助請為本儲存庫加星。閱讀兩份指南。打造偉大的作品。**
|
||||
Reference in New Issue
Block a user