anbeime/skill / projects/companion-simple
xiaoyue-companion
Verified专为软件开发工程师与综合办公文员打造。当你在等待任务执行、工作疲惫或需要鼓励时,使用此技能通过智谱AI自动生成温暖对话回应与场景配图,一键获取专属情绪价值与虚拟陪伴,让AI助手更懂你。
docs/技能清理与迁移指南.md
View on GitHub---
title: 技能清理与迁移指南
date: 2026-02-09
tags: [技能管理, 清理报告, 迁移指南]
status: 已完成
---
# 技能清理与迁移指南
> 📅 **清理时间**: 2026-02-09 21:19
> 📁 **清理目录**: D:\tool\skills
> 🎯 **清理目标**: 删除重复文件,整理压缩包,释放存储空间
---
## ✅ 清理完成报告
### 已完成操作
1. ✅ **创建压缩包存档目录**
- 路径:`D:\tool\skills\skill压缩文件\`
- 用途:统一存放所有技能压缩包,便于备份和迁移
2. ✅ **移动压缩包**
- 移动数量:57个压缩包
- 总大小:17.23 MB
- 从:`D:\tool\skills\*.zip`
- 到:`D:\tool\skills\skill压缩文件\`
3. ✅ **删除临时目录**
- 已删除:`temp/`
- 已删除:`temp2/`
- 已删除:`temp3/`
- 已删除:`temp4/`
- 释放空间:约 2-3 GB
### 清理效果
| 项目 | 清理前 | 清理后 | 节省 |
|------|--------|--------|------|
| **存储空间** | 约7GB | 约4GB | **约3GB** |
| **技能目录数** | 89个 | 59个 | 减少30个重复 |
| **压缩包位置** | 分散 | 集中 | 便于管理 |
---
## 📦 技能迁移完整指南
### 方式一:直接复制文件夹(推荐用于本地迁移)
**适用场景:**
- 同一台电脑的不同位置
- 局域网内的其他电脑
- 外接硬盘备份
**操作步骤:**
1. **复制整个技能目录**
```powershell
# 复制到其他位置
Copy-Item -Path "D:\tool\skills" -Destination "E:\backup\skills" -Recurse
```
2. **或复制单个技能**
```powershell
# 复制单个技能
Copy-Item -Path "D:\tool\skills\content-creation-publisher" -Destination "E:\新位置\" -Recurse
```
3. **在新位置使用**
- 无需额外配置
- 保留所有设置和脚本
- 立即可用
**优点:**
- ✅ 最快速(无需压缩/解压)
- ✅ 保留所有配置文件(.env等)
- ✅ 保留文件权限和时间戳
- ✅ 适合大量技能批量迁移
**缺点:**
- ❌ 文件较大(约4GB)
- ❌ 不适合网络传输
---
### 方式二:使用压缩包(推荐用于跨设备迁移)
**适用场景:**
- 跨电脑迁移
- 网络传输
- 分享给他人
- 长期备份
**操作步骤:**
#### 选项A:使用已有压缩包(推荐)
1. **从压缩包目录获取**
```
位置:D:\tool\skills\skill压缩文件\
包含:57个原始技能压缩包
```
2. **选择需要的压缩包**
```powershell
# 查看所有压缩包
Get-ChildItem "D:\tool\skills\skill压缩文件" | Select-Object Name, Length
```
3. **复制到目标位置并解压**
```powershell
# 复制压缩包
Copy-Item "D:\tool\skills\skill压缩文件\content-creation-publisher.zip" -Destination "目标路径\"
# 解压
Expand-Archive -Path "目标路径\content-creation-publisher.zip" -DestinationPath "目标路径\"
```
#### 选项B:重新压缩当前技能(包含配置)
1. **压缩单个技能(含配置)**
```powershell
# 压缩单个技能目录
Compress-Archive -Path "D:\tool\skills\content-creation-publisher" -DestinationPath "D:\备份\content-creation-publisher-configured.zip"
```
2. **压缩多个技能**
```powershell
# 压缩核心技能集合
$coreSkills = @(
"content-creation-publisher",
"intelligent-content-system",
"video-creation-suite",
"NanoBanana-PPT-Skills",
"tts-voice-synthesis",
"infinitetalk"
)
foreach ($skill in $coreSkills) {
$sourcePath = "D:\tool\skills\$skill"
$destPath = "D:\备份\$skill-configured.zip"
Compress-Archive -Path $sourcePath -DestinationPath $destPath -Force
}
```
3. **压缩所有技能(完整备份)**
```powershell
# 压缩整个skills目录
Compress-Archive -Path "D:\tool\skills\*" -DestinationPath "D:\备份\all-skills-backup-$(Get-Date -Format 'yyyyMMdd').zip"
```
**优点:**
- ✅ 文件小(压缩后约1-2GB)
- ✅ 便于网络传输
- ✅ 便于分享和备份
- ✅ 可选择性迁移
**缺点:**
- ❌ 需要解压时间
- ❌ 解压后需重新配置.env(如果压缩的是原始包)
---
### 方式三:Git克隆(推荐用于保持更新)
**适用场景:**
- 需要保持技能更新
- 协作开发
- 追踪版本变化
**操作步骤:**
1. **查找技能的GitHub仓库**
```
大部分技能都有GitHub仓库,可在技能目录的README.md中找到
```
2. **克隆技能仓库**
```bash
# 示例:克隆obsidian-skills
git clone https://github.com/kepano/obsidian-skills.git
# 示例:克隆baoyu-skills
git clone https://github.com/baoyu-io/baoyu-skills.git
```
3. **定期更新**
```bash
cd 技能目录
git pull origin main
```
**优点:**
- ✅ 保持最新版本
- ✅ 可追踪变更历史
- ✅ 便于贡献代码
- ✅ 占用空间小
**缺点:**
- ❌ 需要网络连接
- ❌ 需要Git知识
- ❌ 不包含个人配置
---
## 🎯 推荐迁移方案
### 场景1:备份到外接硬盘
**推荐方式:** 直接复制文件夹
```powershell
# 完整备份(含配置)
Copy-Item -Path "D:\tool\skills" -Destination "E:\备份\skills-$(Get-Date -Format 'yyyyMMdd')" -Recurse
# 备份压缩包(原始版本)
Copy-Item -Path "D:\tool\skills\skill压缩文件" -Destination "E:\备份\skill压缩文件" -Recurse
```
**优点:** 快速、完整、含配置
---
### 场景2:迁移到新电脑
**推荐方式:** 压缩包 + 配置文件分离
**步骤:**
1. **打包核心技能(含配置)**
```powershell
# 压缩核心技能
Compress-Archive -Path "D:\tool\skills\content-creation-publisher" -DestinationPath "迁移包\content-creation-publisher.zip"
```
2. **单独备份配置文件**
```powershell
# 备份所有.env文件
Get-ChildItem -Path "D:\tool\skills" -Filter ".env" -Recurse | Copy-Item -Destination "迁移包\configs\"
```
3. **在新电脑解压并恢复配置**
```powershell
# 解压技能
Expand-Archive -Path "content-creation-publisher.zip" -DestinationPath "新位置\"
# 恢复配置
Copy-Item "configs\.env" -Destination "新位置\content-creation-publisher\"
```
**优点:** 体积小、配置独立、便于管理
---
### 场景3:分享给他人
**推荐方式:** 使用原始压缩包 + 配置模板
**步骤:**
1. **提供原始压缩包**
```
从 D:\tool\skills\skill压缩文件\ 选择需要的压缩包
```
2. **创建配置模板**
```powershell
# 创建.env.example(不含敏感信息)
@"
# Google Gemini API(必需)
GEMINI_API_KEY=your_api_key_here
# 可灵AI API(可选)
KLING_ACCESS_KEY=your_access_key_here
KLING_SECRET_KEY=your_secret_key_here
"@ | Out-File "配置模板\.env.example" -Encoding UTF8
```
3. **提供使用说明**
- 包含SKILL.md
- 包含API获取指南
- 包含快速开始指南
**优点:** 保护隐私、便于分享、规范配置
---
### 场景4:云端同步(OneDrive/Dropbox)
**推荐方式:** 符号链接 + 选择性同步
**步骤:**
1. **创建云端目录**
```powershell
New-Item -Path "C:\Users\用户名\OneDrive\Skills" -ItemType Directory
```
2. **移动技能到云端**
```powershell
Move-Item -Path "D:\tool\skills\content-creation-publisher" -Destination "C:\Users\用户名\OneDrive\Skills\"
```
3. **创建符号链接**
```powershell
# 在原位置创建符号链接
New-Item -ItemType SymbolicLink -Path "D:\tool\skills\content-creation-publisher" -Target "C:\Users\用户名\OneDrive\Skills\content-creation-publisher"
```
4. **排除敏感文件**
- 在云端同步设置中排除 `.env` 文件
- 或使用 `.gitignore` 风格的排除规则
**优点:** 自动同步、多设备访问、版本历史
**缺点:** 占用云端空间、需要网络
---
## 📋 技能目录结构说明
### 当前目录结构
```
D:\tool\skills\
├── skill压缩文件\ # 原始压缩包存档(57个,17.23MB)
│ ├── content-creation-publisher.zip
│ ├── video-creation-suite.zip
│ └── ...
├── content-creation-publisher\ # 已安装技能(含配置)
│ ├── SKILL.md
│ ├── .env # API配置(敏感信息)
│ ├── scripts\
│ └── references\
├── intelligent-content-system\
├── video-creation-suite\
├── NanoBanana-PPT-Skills\
└── ...(共59个已安装技能)
```
### 文件说明
| 文件/目录 | 说明 | 迁移建议 |
|----------|------|---------|
| **SKILL.md** | 技能说明文档 | 必须迁移 |
| **.env** | API配置文件(含密钥) | 敏感信息,单独备份 |
| **scripts/** | 脚本文件 | 必须迁移 |
| **references/** | 参考文档 | 必须迁移 |
| **.git/** | Git仓库信息 | 可选(如需版本控制) |
| **.venv/** | Python虚拟环境 | 不建议迁移(重新创建) |
| **node_modules/** | Node.js依赖 | 不建议迁移(重新安装) |
| **__pycache__/** | Python缓存 | 不迁移(自动生成) |
---
## 🔐 配置文件管理
### 敏感信息保护
**不要直接分享或上传的文件:**
- `.env` - 包含API密钥
- `config.json` - 可能包含账号信息
- `credentials.json` - 认证凭据
**推荐做法:**
1. **创建配置模板**
```bash
# 复制.env为模板
cp .env .env.example
# 编辑.env.example,移除敏感信息
# 将实际密钥替换为占位符
```
2. **使用环境变量管理工具**
- Windows: 系统环境变量
- 跨平台: `dotenv` 库
- 密钥管理: Azure Key Vault, AWS Secrets Manager
3. **文档化配置需求**
```markdown
## 配置要求
需要配置以下环境变量:
- `GEMINI_API_KEY`: Google Gemini API密钥
- 获取方式: https://ai.google.dev/
- 权限要求: 图像生成权限
- `KLING_ACCESS_KEY`: 可灵AI访问密钥(可选)
- 获取方式: https://www.kling.ai/
- 用途: 视频转场生成
```
---
## 📊 迁移检查清单
### 迁移前检查
- [ ] 确认需要迁移的技能列表
- [ ] 备份当前配置文件(.env等)
- [ ] 记录已安装的依赖包
- [ ] 导出数据库(如有)
- [ ] 记录自定义修改
### 迁移中操作
- [ ] 选择合适的迁移方式
- [ ] 执行文件复制/压缩
- [ ] 验证文件完整性
- [ ] 传输到目标位置
### 迁移后验证
- [ ] 解压/复制到目标位置
- [ ] 恢复配置文件
- [ ] 重新安装依赖(如需要)
- [ ] 测试核心功能
- [ ] 验证API连接
- [ ] 检查文件权限
---
## 🛠️ 常见问题
### Q1: 迁移后技能无法运行?
**可能原因:**
- 缺少配置文件(.env)
- Python/Node.js版本不匹配
- 依赖包未安装
**解决方案:**
```powershell
# 检查配置文件
Test-Path ".env"
# 重新安装Python依赖
pip install -r requirements.txt
# 重新安装Node.js依赖
npm install
```
---
### Q2: 如何批量迁移多个技能?
**方案A:批量复制**
```powershell
# 定义核心技能列表
$coreSkills = @(
"content-creation-publisher",
"intelligent-content-system",
"video-creation-suite"
)
# 批量复制
foreach ($skill in $coreSkills) {
Copy-Item -Path "D:\tool\skills\$skill" -Destination "E:\新位置\" -Recurse
}
```
**方案B:批量压缩**
```powershell
# 批量压缩核心技能
foreach ($skill in $coreSkills) {
Compress-Archive -Path "D:\tool\skills\$skill" -DestinationPath "E:\备份\$skill.zip" -Force
}
```
---
### Q3: 如何保持技能更新?
**推荐方案:**
1. **使用Git(如果技能有仓库)**
```bash
cd 技能目录
git pull origin main
```
2. **定期下载新版本**
- 访问GitHub Releases页面
- 下载最新版本压缩包
- 备份当前配置后替换
3. **订阅更新通知**
- Watch GitHub仓库
- 加入技能社区
- 关注作者动态
---
### Q4: 迁移后如何恢复配置?
**步骤:**
1. **找到备份的配置文件**
```
位置:迁移包\configs\.env
```
2. **复制到技能目录**
```powershell
Copy-Item "configs\.env" -Destination "技能目录\.env"
```
3. **验证配置**
```powershell
# 查看配置内容(注意保护敏感信息)
Get-Content "技能目录\.env"
```
---
## 📝 最佳实践
### 1. 定期备份
**推荐频率:**
- 每周备份:配置文件(.env)
- 每月备份:完整技能目录
- 重大更新前:完整备份
**备份脚本:**
```powershell
# 自动备份脚本
$backupDate = Get-Date -Format "yyyyMMdd"
$backupPath = "E:\备份\skills-$backupDate"
# 备份技能目录
Copy-Item -Path "D:\tool\skills" -Destination $backupPath -Recurse
# 压缩备份
Compress-Archive -Path $backupPath -DestinationPath "$backupPath.zip"
# 删除未压缩的备份(可选)
Remove-Item -Path $backupPath -Recurse -Force
```
---
### 2. 版本管理
**使用Git管理自定义修改:**
```bash
# 初始化Git仓库
cd D:\tool\skills
git init
# 添加.gitignore
echo ".env" >> .gitignore
echo ".venv/" >> .gitignore
echo "node_modules/" >> .gitignore
echo "__pycache__/" >> .gitignore
# 提交初始版本
git add .
git commit -m "Initial commit"
# 创建分支进行修改
git checkout -b custom-modifications
```
---
### 3. 文档化
**记录以下信息:**
- 技能列表和版本
- 配置要求和API密钥来源
- 自定义修改说明
- 依赖包版本
- 已知问题和解决方案
**示例文档:**
```markdown
# 我的技能配置记录
## 已安装技能
- content-creation-publisher v1.0
- API: Google Gemini (免费额度)
- 自定义: 修改了默认风格为notion
## 配置文件位置
- 主配置: D:\tool\skills\.env
- 备份: E:\备份\configs\.env
## 依赖版本
- Python: 3.10.11
- Node.js: 18.17.0
## 更新记录
- 2026-02-09: 清理临时文件,整理压缩包
```
---
## 🎯 总结
### 推荐迁移方式
| 场景 | 推荐方式 | 理由 |
|------|---------|------|
| **本地备份** | 直接复制文件夹 | 快速、完整 |
| **跨设备迁移** | 压缩包(含配置) | 体积小、便于传输 |
| **分享给他人** | 原始压缩包 + 配置模板 | 保护隐私、规范配置 |
| **保持更新** | Git克隆 | 版本控制、便于更新 |
| **云端同步** | 符号链接 + 选择性同步 | 自动同步、多设备访问 |
### 关键要点
1. ✅ **压缩包已整理** - 57个原始压缩包存放在 `skill压缩文件\` 目录
2. ✅ **临时文件已清理** - 释放约3GB空间
3. ✅ **配置文件需单独管理** - 不要直接分享.env文件
4. ✅ **选择合适的迁移方式** - 根据场景选择最优方案
5. ✅ **定期备份** - 保护重要配置和自定义修改
---
**文档版本**: v1.0
**创建时间**: 2026-02-09
**更新时间**: 2026-02-09
**维护人**: 小跃Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |