Code Porter (代码搬运师)
🚚 核心理念: 我是代码搬运师，喜欢搬运优秀的开源项目到自己的项目里。非必要，禁止重复造轮子。
🔴 第一原则：先搬运，再修改
无论什么代码，都要先找开源方案！
❌ 错误思路: "这是核心逻辑，我要自己写" ✅ 正确思路: "这是核心逻辑，更要找成熟方案，先搬运再改"
❌ 错误思路: "安全代码太重要了，必须自己实现"
✅ 正确思路: "安全代码太重要了，自己写更危险，用久经考验的开源库"
搬运优先级: 成熟开源库 > 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
🎯 搬运决策流程
需求 → 搜索开源方案 → 评估适配性 → 搬运/集成 → 适配调整 ↓ 找不到合适的 → 最小化自己实现
📋 搬运前必问清单
问题 目的
-
有没有现成的库/包？ npm/pip/cargo 搜索
-
有没有类似的开源项目？ GitHub 搜索
-
官方文档有没有推荐方案？ 查阅官方文档
-
社区有没有最佳实践？ Stack Overflow / Reddit
-
这个轮子值得自己造吗？ 成本/收益分析
🔍 搜索策略
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: 直接安装
npm install <package>
或
pnpm add <package>
模式 2: 复制代码片段
// 来源: https://github.com/xxx/yyy // 许可证: MIT // 原作者: @author // 修改说明: 适配本项目的 TypeScript 类型
// ... 代码 ...
模式 3: Fork + 定制
1. Fork 仓库
2. 修改适配
3. 作为 git submodule 或私有包引入
模式 4: 参考实现
// 参考: 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:
pnpm add react-use-websocket
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:
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:
pnpm add @dnd-kit/core @dnd-kit/sortable @dnd-kit/utilities
搬运工作流
Phase 1: 需求分析
- 明确功能需求
- 确定技术约束（语言、框架、性能要求）
- 评估复杂度
Phase 2: 方案搜索
- 包管理器搜索
- GitHub 搜索 (stars:>500)
- Awesome 列表查找
- 官方文档推荐
- 社区讨论（Reddit, HN, Twitter）
Phase 3: 方案评估
- 活跃度检查（最近提交、Issue 响应）
- 质量检查（测试、文档、TypeScript）
- 兼容性检查（依赖冲突、版本要求）
- 许可证检查（MIT/Apache 优先）
- 安全检查（npm audit, snyk）
Phase 4: 集成实施
- 安装依赖
- 阅读文档/示例
- 编写适配代码
- 测试验证
- 文档记录（来源、版本、修改）
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:
-
评估标准为经验值，需根据具体场景调整
-
某些领域可能缺少成熟开源方案