sbh
GitHub用于磁盘压力诊断与恢复的专家技能。通过SBH工具检查状态,按不可逆性排序执行释放球囊、清理文件或紧急删除等操作,严格遵循证据优先和显式授权原则,防止误删或无效操作。
Trigger Scenarios
Install
npx skills add boshu2/agentops --skill sbh -g -y
SKILL.md
Frontmatter
{
"name": "sbh",
"description": "Inspect disk pressure with SBH and perform an authorized recovery action. Use when: storage diagnosis or SBH recovery is requested; inspection does not authorize deletion."
}
SBH — storage pressure specialist
SBH exposes disk-pressure status, ballast, scanning, and recovery commands. This
skill gathers evidence and performs at most the explicit action authorized by the
caller. Its authorized actions can delete files and change host storage
configuration, so no mutation runs without explicit caller authority. The command
surface below is anchored to sbh 0.4.27; re-verify against sbh --version on
another host before relying on an exact flag.
Evidence-first recovery works because disk pressure has cheap reversible remedies and expensive irreversible ones; a factual baseline is what tells them apart before anything is deleted. Order remediation by irreversibility: status and dry runs first, ballast release next, cleanup of unprotected files after that, and emergency deletion last — never skip forward while a more reversible step remains untried.
Named failure mode — wrong-mount relief: reclaiming gigabytes on a filesystem that is not the constrained mount and declaring the pressure resolved.
Anti-pattern: escalating straight to emergency --yes because pressure is
critical. Corrective: urgency raises the stakes of an irreversible mistake; it
never lowers the authorization bar or the ordering above.
Constraints
- Begin with
sbh --json status,sbh check, or a dry run on the exact mount because recovery decisions need a factual baseline. - Never run
clean --yes,emergency --yes, ballast release,tune --apply,unprotect, or service/configuration changes without explicit authority because those operations mutate host state. - Preserve
.git/, open-file, young-file, non-writable-parent, and.sbh-protectvetoes because they prevent unsafe or ineffective cleanup. - Confirm that ballast or reclaimed bytes affect the constrained mount because free space on another filesystem does not resolve the pressure.
- Run one action once, capture before/after evidence, and stop because the caller owns any further mutation. A negative result is returned to the caller; this skill does not retry or escalate it.
Output
Return mount, free bytes, pressure state, dry-run candidates, authorization used, exact command and exit code, bytes reclaimed, protection vetoes, and checked/not checked surfaces.
Full command documentation: https://github.com/Dicklesworthstone/storage_ballast_helper
Version History
- 9f8a711 Current 2026-09-22 11:02
- 8061085 2026-09-09 05:20
-
7b07a7d
2026-08-19 22:03
修复了便携式 Codex 激活元数据的保留问题,增强了技能验证的健壮性,包括重复 YAML 键、符号链接包含及可选字段规则的检查。
- 3f402e5 2026-07-24 22:10


