code-porter

# Code Porter (代码搬运师)

> 🚚 **核心理念**: 我是代码搬运师，喜欢搬运优秀的开源项目到自己的项目里。非必要，禁止重复造轮子。

## 🔴 第一原则：先搬运，再修改

**无论什么代码，都要先找开源方案！**

```
❌ 错误思路: "这是核心逻辑，我要自己写"
✅ 正确思路: "这是核心逻辑，更要找成熟方案，先搬运再改"

❌ 错误思路: "安全代码太重要了，必须自己实现"  
✅ 正确思路: "安全代码太重要了，自己写更危险，用久经考验的开源库"
```

**搬运优先级**: 成熟开源库 > Fork修改 > 参考实现 > 最后才自己写

## When to Use This Skill

使用此技能当你需要：
- 实现一个新功能或模块
- 选择技术方案或库
- 评估是否需要自己编写代码
- 寻找现有解决方案
- 集成第三方服务或 API

## Not For / Boundaries

此技能不适用于：
- 已有明确技术选型的项目（遵循现有架构）
- 纯学习目的的练习项目（刻意练习除外）

### ⚠️ 常见误区纠正

**误区**: "核心业务逻辑必须自己写"
**正解**: 核心业务逻辑也要**先搬运再修改**！
- 交易系统？先看 [ccxt](https://github.com/ccxt/ccxt)、[hummingbot](https://github.com/hummingbot/hummingbot)
- 风控引擎？先看 [riskfolio-lib](https://github.com/dcajasn/Riskfolio-Lib)
- 推荐系统？先看 [surprise](https://github.com/NicolasHug/Surprise)

**误区**: "安全代码必须自己实现"
**正解**: 安全代码**更要用成熟开源方案**！自己写反而更危险！
- 认证？用 [passport](https://github.com/jaredhanson/passport)、[next-auth](https://github.com/nextauthjs/next-auth)
- 加密？用 [crypto-js](https://github.com/brix/crypto-js)、[bcrypt](https://github.com/kelektiv/node.bcrypt.js)
- JWT？用 [jose](https://github.com/panva/jose)、[jsonwebtoken](https://github.com/auth0/node-jsonwebtoken)

---

## Quick Reference

### 🎯 搬运决策流程

```
需求 → 搜索开源方案 → 评估适配性 → 搬运/集成 → 适配调整
         ↓
    找不到合适的 → 最小化自己实现
```

### 📋 搬运前必问清单

| 问题 | 目的 |
|------|------|
| 1. 有没有现成的库/包？ | npm/pip/cargo 搜索 |
| 2. 有没有类似的开源项目？ | GitHub 搜索 |
| 3. 官方文档有没有推荐方案？ | 查阅官方文档 |
| 4. 社区有没有最佳实践？ | Stack Overflow / Reddit |
| 5. 这个轮子值得自己造吗？ | 成本/收益分析 |

### 🔍 搜索策略

```bash
# 1. 包管理器搜索
npm search <keyword>
pip search <keyword>  # 或 pip index versions <package>

# 2. GitHub 搜索
# 按 stars 排序: stars:>1000 <keyword>
# 按语言过滤: language:typescript <keyword>
# 按最近更新: pushed:>2024-01-01 <keyword>

# 3. Awesome 列表
# 搜索 "awesome-<domain>" 仓库
```

### ✅ 开源项目评估标准

| 指标 | 合格线 | 优秀线 |
|------|--------|--------|
| Stars | >100 | >1000 |
| 最近更新 | <6个月 | <1个月 |
| Issues 响应 | 有回复 | 24h内回复 |
| 文档质量 | 有 README | 有完整文档站 |
| 测试覆盖 | 有测试 | >80% 覆盖 |
| 许可证 | MIT/Apache | MIT |
| 依赖数量 |