fix: restore missing files (package.json etc) and fix sync script logic

This commit is contained in:
xuxiang
2026-01-31 18:55:45 +08:00
parent b1d03833b9
commit 0e5571998f
85 changed files with 17074 additions and 1 deletions

191
docs/zh-TW/CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,191 @@
# 貢獻 Everything Claude Code
感謝您想要貢獻。本儲存庫旨在成為 Claude Code 使用者的社群資源。
## 我們正在尋找什麼
### 代理程式Agents
能夠妥善處理特定任務的新代理程式:
- 特定語言審查員Python、Go、Rust
- 框架專家Django、Rails、Laravel、Spring
- DevOps 專家Kubernetes、Terraform、CI/CD
- 領域專家ML 管線、資料工程、行動開發)
### 技能Skills
工作流程定義和領域知識:
- 語言最佳實務
- 框架模式
- 測試策略
- 架構指南
- 特定領域知識
### 指令Commands
調用實用工作流程的斜線指令:
- 部署指令
- 測試指令
- 文件指令
- 程式碼生成指令
### 鉤子Hooks
實用的自動化:
- Lint/格式化鉤子
- 安全檢查
- 驗證鉤子
- 通知鉤子
### 規則Rules
必須遵守的準則:
- 安全規則
- 程式碼風格規則
- 測試需求
- 命名慣例
### MCP 設定
新的或改進的 MCP 伺服器設定:
- 資料庫整合
- 雲端供應商 MCP
- 監控工具
- 通訊工具
---
## 如何貢獻
### 1. Fork 儲存庫
```bash
git clone https://github.com/YOUR_USERNAME/everything-claude-code.git
cd everything-claude-code
```
### 2. 建立分支
```bash
git checkout -b add-python-reviewer
```
### 3. 新增您的貢獻
將檔案放置在適當的目錄:
- `agents/` 用於新代理程式
- `skills/` 用於技能(可以是單一 .md 或目錄)
- `commands/` 用於斜線指令
- `rules/` 用於規則檔案
- `hooks/` 用於鉤子設定
- `mcp-configs/` 用於 MCP 伺服器設定
### 4. 遵循格式
**代理程式**應包含 frontmatter
```markdown
---
name: agent-name
description: What it does
tools: Read, Grep, Glob, Bash
model: sonnet
---
Instructions here...
```
**技能**應清晰且可操作:
```markdown
# Skill Name
## When to Use
...
## How It Works
...
## Examples
...
```
**指令**應說明其功能:
```markdown
---
description: Brief description of command
---
# Command Name
Detailed instructions...
```
**鉤子**應包含描述:
```json
{
"matcher": "...",
"hooks": [...],
"description": "What this hook does"
}
```
### 5. 測試您的貢獻
在提交前確保您的設定能與 Claude Code 正常運作。
### 6. 提交 PR
```bash
git add .
git commit -m "Add Python code reviewer agent"
git push origin add-python-reviewer
```
然後開啟一個 PR包含
- 您新增了什麼
- 為什麼它有用
- 您如何測試它
---
## 指南
### 建議做法
- 保持設定專注且模組化
- 包含清晰的描述
- 提交前先測試
- 遵循現有模式
- 記錄任何相依性
### 避免做法
- 包含敏感資料API 金鑰、權杖、路徑)
- 新增過於複雜或小眾的設定
- 提交未測試的設定
- 建立重複的功能
- 新增需要特定付費服務但無替代方案的設定
---
## 檔案命名
- 使用小寫加連字號:`python-reviewer.md`
- 具描述性:`tdd-workflow.md` 而非 `workflow.md`
- 將代理程式/技能名稱與檔名對應
---
## 有問題?
開啟 issue 或在 X 上聯繫:[@affaanmustafa](https://x.com/affaanmustafa)
---
感謝您的貢獻。讓我們一起打造優質的資源。