Code Porter (代码搬运师)

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

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

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

code

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

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

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

When to Use This Skill

使用此技能当你需要：

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

Not For / Boundaries

此技能不适用于：

•已有明确技术选型的项目（遵循现有架构）
•纯学习目的的练习项目（刻意练习除外）

⚠️ 常见误区纠正

误区: "核心业务逻辑必须自己写" 正解: 核心业务逻辑也要先搬运再修改！

•交易系统？先看 ccxt、hummingbot
•风控引擎？先看 riskfolio-lib
•推荐系统？先看 surprise

误区: "安全代码必须自己实现" 正解: 安全代码更要用成熟开源方案！自己写反而更危险！

•认证？用 passport、next-auth
•加密？用 crypto-js、bcrypt
•JWT？用 jose、jsonwebtoken

Quick Reference

🎯 搬运决策流程

code

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

📋 搬运前必问清单

问题	目的
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
依赖数量	<20	<5

🚫 禁止造轮子清单

以下场景必须使用现有方案：

领域	推荐方案
HTTP 请求	axios, fetch, ky
状态管理	zustand, jotai, redux-toolkit
表单验证	zod, yup, joi
日期处理	date-fns, dayjs
UI 组件	shadcn/ui, radix-ui, headless-ui
图表	recharts, chart.js, echarts
动画	framer-motion, react-spring
数据库 ORM	drizzle, prisma, typeorm
API 客户端	openapi-typescript, trpc
测试	vitest, jest, playwright
构建工具	vite, esbuild, turbopack
代码格式化	prettier, eslint
认证授权	next-auth, passport, lucia
加密哈希	bcrypt, argon2, crypto-js
JWT 处理	jose, jsonwebtoken
交易系统	ccxt, hummingbot
风控引擎	riskfolio-lib, pyfolio
量化分析	qlib, backtrader, zipline

🔧 搬运集成模式

模式 1: 直接安装

bash

npm install <package>
# 或
pnpm add <package>

模式 2: 复制代码片段

typescript

// 来源: https://github.com/xxx/yyy
// 许可证: MIT
// 原作者: @author
// 修改说明: 适配本项目的 TypeScript 类型

// ... 代码 ...

模式 3: Fork + 定制

bash

# 1. Fork 仓库
# 2. 修改适配
# 3. 作为 git submodule 或私有包引入

模式 4: 参考实现

typescript

// 参考: https://github.com/xxx/yyy/blob/main/src/utils.ts
// 基于原实现重写，适配本项目架构

Examples

Example 1: 需要实现 WebSocket 实时通信

Input: "我需要在 React 项目中实现 WebSocket 实时通信"

Steps:

•搜索现有方案: npm search websocket react
•发现候选: socket.io-client, @tanstack/react-query + WebSocket, use-websocket
•
评估 use-websocket:
- •Stars: 1.8k ✅
- •最近更新: 2024 ✅
- •TypeScript 支持: 完整 ✅
- •文档: 清晰 ✅
•决策: 使用 use-websocket

Expected Output:

bash

pnpm add react-use-websocket

typescript

import useWebSocket from 'react-use-websocket';

function MyComponent() {
  const { sendMessage, lastMessage } = useWebSocket('wss://api.example.com');
  // ...
}

Example 2: 需要实现 Markdown 渲染

Input: "需要在页面中渲染 Markdown 内容，支持代码高亮"

Steps:

•搜索: npm search markdown react
•候选: react-markdown, marked, markdown-it
•
评估 react-markdown:
- •Stars: 12k+ ✅
- •生态: 支持 remark/rehype 插件 ✅
- •代码高亮: 配合 react-syntax-highlighter ✅
•决策: 使用 react-markdown + react-syntax-highlighter

Expected Output:

bash

pnpm add react-markdown react-syntax-highlighter @types/react-syntax-highlighter

Example 3: 需要实现拖拽排序

Input: "列表需要支持拖拽排序功能"

Steps:

•搜索: npm search drag drop react
•候选: @dnd-kit/core, react-beautiful-dnd, react-dnd
•
评估 @dnd-kit:
- •Stars: 11k+ ✅
- •维护: 活跃 ✅
- •性能: 优秀 ✅
- •无障碍: 支持 ✅
•决策: 使用 @dnd-kit

Expected Output:

bash

pnpm add @dnd-kit/core @dnd-kit/sortable @dnd-kit/utilities

搬运工作流

Phase 1: 需求分析

code

1. 明确功能需求
2. 确定技术约束（语言、框架、性能要求）
3. 评估复杂度

Phase 2: 方案搜索

code

1. 包管理器搜索
2. GitHub 搜索 (stars:>500)
3. Awesome 列表查找
4. 官方文档推荐
5. 社区讨论（Reddit, HN, Twitter）

Phase 3: 方案评估

code

1. 活跃度检查（最近提交、Issue 响应）
2. 质量检查（测试、文档、TypeScript）
3. 兼容性检查（依赖冲突、版本要求）
4. 许可证检查（MIT/Apache 优先）
5. 安全检查（npm audit, snyk）

Phase 4: 集成实施

code

1. 安装依赖
2. 阅读文档/示例
3. 编写适配代码
4. 测试验证
5. 文档记录（来源、版本、修改）

References

•references/index.md: 导航索引
•references/awesome-lists.md: 常用 Awesome 列表汇总
•references/license-guide.md: 开源许可证选择指南

Maintenance

•Sources: vibe-coding-cn 方法论, 开源社区最佳实践
•Last Updated: 2025-12-30
•
Known Limits:
- •评估标准为经验值，需根据具体场景调整
- •某些领域可能缺少成熟开源方案