技能刷新
- 作者仓库星标 435
- 作者仓库 nvim
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @benbrastmckie · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 1 步:解析参数
从命令输入中提取标志: `--dry-run`:预览模式 `--force`:跳过确认,使用 8 小时默认值
第 2 步:运行进程清理
执行进程清理脚本:存储进程清理输出以供显示。
第 3 步:清理孤立的飞行后标记
从specs目录中清除所有孤立的飞行后协调文件。这些文件通常应在飞行后完成后由技能清理,但如果进程中断,则可能会留下这些文件。
步骤 4:清理过时的备份文件
扫描并删除 `.opencode/` 中已弃用的备份机制遗留的任何 `.backup` 文件:
第 5 步:运行目录调查
显示当前目录状态(尚未清理): 这显示: 当前 ~/.opencode/ 目录大小 按目录细分 可回收的空间
第6步:根据模式执行
试运行模式 如果设置了`--dry-run`:显示预览后退出。强制模式 如果设置了`--force`:
# Refresh Skill (Direct Execution)
Direct execution skill for managing OpenCode resources. Performs two operations:
1. **Process cleanup**: Identify and terminate orphaned OpenCode processes
2. **Directory cleanup**: Clean up accumulated files in ~/.opencode/
This skill executes inline without spawning a subagent.
## Execution
### Step 1: Parse Arguments
Extract flags from command input:
- `--dry-run`: Preview mode
- `--force`: Skip confirmation, use 8-hour default
```bash
# Parse from command input
dry_run=false
force=false
if [[ "$*" == *"--dry-run"* ]]; then
dry_run=true
fi
if [[ "$*" == *"--force"* ]]; then
force=true
fi
```
### Step 2: Run Process Cleanup
Execute process cleanup script:
```bash
.opencode/scripts/claude-refresh.sh $( [ "$force" = true ] && echo "--force" )
```
Store process cleanup output for display.
### Step 3: Clean Orphaned Postflight Markers
Clean any orphaned postflight coordination files from the specs directory. These files should normally be cleaned up by skills after postflight completes, but may be left behind if a process is interrupted.
```bash
echo ""
echo "=== Cleaning Orphaned Postflight Markers ==="
echo ""
# Find orphaned postflight markers (older than 1 hour)
orphaned_pending=$(find specs -maxdepth 3 -name ".postflight-pending" -mmin +60 -type f 2>/dev/null)
orphaned_guard=$(find specs -maxdepth 3 -name ".postflight-loop-guard" -mmin +60 -type f 2>/dev/null)
# Also check for legacy global markers
legacy_pending=""
legacy_guard=""
if [ -f "specs/.postflight-pending" ]; then
legacy_pending="specs/.postflight-pending"
fi
if [ -f "specs/.postflight-loop-guard" ]; then
legacy_guard="specs/.postflight-loop-guard"
fi
if [ -n "$orphaned_pending" ] || [ -n "$orphaned_guard" ] || [ -n "$legacy_pending" ] || [ -n "$legacy_guard" ]; then
if [ "$dry_run" = true ]; then
echo "Would delete the following orphaned markers:"
[ -n "$orphaned_pending" ] && echo "$orphaned_pending"
[ -n "$orphaned_guard" ] && echo "$orphaned_guard"
[ -n "$legacy_pending" ] && echo "$legacy_pending"
[ -n "$legacy_guard" ] && echo "$legacy_guard"
else
# Delete orphaned task-scoped markers
find specs -maxdepth 3 -name ".postflight-pending" -mmin +60 -delete 2>/dev/null
find specs -maxdepth 3 -name ".postflight-loop-guard" -mmin +60 -delete 2>/dev/null
# Delete legacy global markers
rm -f specs/.postflight-pending 2>/dev/null
rm -f specs/.postflight-loop-guard 2>/dev/null
echo "Cleaned orphaned postflight markers."
fi
else
echo "No orphaned postflight markers found."
fi
```
### Step 4: Clean Stale Backup Files
Scan for and remove any `.backup` files left over from the deprecated backup mechanism in `.opencode/`:
```bash
echo ""
echo "=== Cleaning Stale Backup Files ==="
echo ""
# Find .backup files in .opencode/ directory
backup_files=$(find .opencode/ -name "*.backup" -type f 2>/dev/null)
if [ -n "$backup_files" ]; then
backup_count=$(echo "$backup_files" | wc -l)
if [ "$dry_run" = true ]; then
echo "Would delete $backup_count .backup file(s):"
echo "$backup_files"
else
echo "$backup_files" | xargs rm -f
echo "Deleted $backup_count stale .backup file(s)."
fi
else
echo "No stale .backup files found."
fi
```
### Step 5: Run Directory Survey
Show current directory status without cleaning yet:
```bash
.opencode/scripts/claude-cleanup.sh
```
This displays:
- Current ~/.opencode/ directory size
- Breakdown by directory
- Space that can be reclaimed
### Step 6: Execute Based on Mode
#### Dry-Run Mode
If `--dry-run` is set:
```bash
echo ""
echo "=== DRY RUN MODE ==="
echo "Showing 8-hour cleanup preview..."
echo ""
.opencode/scripts/claude-cleanup.sh --dry-run --age 8
```
Exit after showing preview.
#### Force Mode
If `--force` is set:
```bash
echo ""
echo "=== EXECUTING CLEANUP (8-hour default) ==="
echo ""
.opencode/scripts/claude-cleanup.sh --force --age 8
```
Show results and exit.
#### Interactive Mode (Default)
If neither flag is set:
1. Check if cleanup candidates exist (claude-cleanup.sh exits with code 1 if candidates found)
2. If no candidates, display message and exit:
```
No cleanup candidates found within default thresholds.
All files are either protected or recently modified.
```
3. If candidates exist, prompt user for age selection:
```json
{
"question": "Select cleanup age threshold:",
"header": "Age Threshold",
"multiSelect": false,
"options": [
{
"label": "8 hours (default)",
"description": "Remove files older than 8 hours - aggressive cleanup"
},
{
"label": "2 days",
"description": "Remove files older than 2 days - conservative cleanup"
},
{
"label": "Clean slate",
"description": "Remove everything except safety margin (1 hour)"
}
]
}
```
4. Map user selection to age parameter:
- "8 hours (default)" → `--age 8`
- "2 days" → `--age 48`
- "Clean slate" → `--age 0`
5. Execute cleanup with selected age:
```bash
case "$selection" in
"8 hours (default)")
.opencode/scripts/claude-cleanup.sh --force --age 8
;;
"2 days")
.opencode/scripts/claude-cleanup.sh --force --age 48
;;
"Clean slate")
.opencode/scripts/claude-cleanup.sh --force --age 0
;;
esac
```
6. Display cleanup results
---
## Example Execution Flows
### Interactive Flow
```bash
# User runs: /refresh
# Output:
OpenCode Refresh
===================
No orphaned processes found.
All 3 Claude processes are active sessions.
---
OpenCode Directory Cleanup
=============================
Target: ~/.opencode/
Current total size: 7.3 GB
Scanning directories...
Directory Total Cleanable Files
---------- ------- ---------- -----
projects/ 7.0 GB 6.5 GB 980
debug/ 151.0 MB 140.0 MB 650
...
TOTAL 7.3 GB 6.7 GB 5577
Space that can be reclaimed: 6.7 GB
# Prompt appears:
[Age Threshold]
Select cleanup age threshold:
1. 8 hours (default) - Remove files older than 8 hours
2. 2 days - Remove files older than 2 days
3. Clean slate - Remove everything except safety margin
# User selects option 1
# Cleanup executes:
Cleanup Complete
================
Deleted: 5577 files
Failed: 0 files
Space reclaimed: 6.7 GB
New total size: 600.0 MB
```
### Dry-Run Flow
```bash
# User runs: /refresh --dry-run
# Shows survey, then:
=== DRY RUN MODE ===
Showing 8-hour cleanup preview...
Would delete: 5577 files
Would reclaim: 6.7 GB
Dry Run Summary
===============
No changes made.
```
### Force Flow
```bash
# User runs: /refresh --force
# Shows survey, then immediately:
=== EXECUTING CLEANUP (8-hour default) ===
Cleanup Complete
================
Deleted: 5577 files
Space reclaimed: 6.7 GB
```
---
## Safety Measures
### Protected Files (Never Deleted)
- `sessions-index.json` (in each project directory)
- `settings.json`
- `.credentials.json`
- `history.jsonl`
### Safety Margin
Files modified within the last hour are **never deleted**, regardless of age threshold.
### Process Safety
- Only targets orphaned processes (TTY = "?")
- Never kills active sessions
- Excludes current process tree
---
## Error Handling
### Scripts Not Found
If scripts don't exist:
```
Error: Cleanup scripts not found at .opencode/scripts/
Please ensure claude-refresh.sh and claude-cleanup.sh are installed.
```
### Permission Denied
If kill/delete fails due to permissions:
```
Warning: Some operations failed due to insufficient permissions.
Failed files: 5
Successfully deleted: 5572 files
```
### No ~/.opencode/ Directory
If directory doesn't exist:
```
Error: ~/.opencode/ directory not found.
Nothing to clean up.
```
章节与文件索引
按说明文件中的顺序排列。
第 1 步:解析参数
第 2 步:运行进程清理
第 3 步:清理孤立的飞行后标记
步骤 4:清理过时的备份文件
第 5 步:运行目录调查
文件/命令 -> --dry-run · --force · .backup · .opencode/ · --age 8 · --age 48 · --age 0 · sessions-index.json
内容校验值 -> 12dd161cacc3
当前原文的自动摘译,尚未人工审校。
步骤 4:清理过时的备份文件
扫描并删除
.opencode/中已弃用的备份机制遗留的所有.backup文件: