Agent Skills
› evolution-foundation/evo-nexus
› plugin-health
plugin-health
GitHub用于检查已安装插件的健康状态，验证文件完整性与 SHA256 一致性，检测篡改或损坏。适用于用户询问插件是否正常工作、报告故障或需要验证完整性的场景。
Trigger Scenarios
插件是否正常工作
插件健康检查
插件状态查询
验证插件完整性
Install
npx skills add evolution-foundation/evo-nexus --skill plugin-health -g -y
SKILL.md
Frontmatter
{
"name": "plugin-health",
"metadata": {
"version": "1.0.0",
"category": "plugins"
},
"description": "Check an installed plugin's health — verify manifest SHA256 matches files on disk, detect tampering or corruption. Use when the user asks if a plugin is working, reports a bug, or wants to validate integrity. Triggers on \"plugin X está funcionando?\", \"health plugin X\", \"status plugin X\", \"está ok o plugin Y?\"."
}
Plugin Health
Run on-demand integrity check for a plugin. Compares .install-manifest.json SHA256 entries against actual files on disk. Detects tampering, partial corruption, or missing files.
How to use
Step 1 — Resolve the slug
If not given, list and ask:
from dashboard.backend.sdk_client import evo
plugins = evo.get("/api/plugins")
Step 2 — Run health check
health = evo.get(f"/api/plugins/{slug}/health")
Response shape:
{
"status": "active" | "broken" | "routine_activation_pending",
"reason": "sha_mismatch" | "missing_files" | null,
"files": [".claude/agents/plugin-foo-agent.md", ...], // if broken
"checked_at": "..."
}
Step 3 — Report
If active: plugin is healthy. Summarise: total files checked, all SHA256 matching, registered hooks/heartbeats/routines still wired.
If broken:
- List corrupted/missing files
- Suggest options:
- Reinstall:
plugin-installwith same source URL (overwrites files, preserves data) - Uninstall + reinstall: clean slate
- Manual fix: edit files back to original state (if user knows what was changed)
- Reinstall:
If routine_activation_pending: scheduler was offline during install. Tell user to start/restart scheduler.
Error handling
HTTP 404 not_found— plugin not installed.HTTP 500 health_check_failed— filesystem permission issue or manifest unreadable. CheckADWs/logs/plugins/.
Notes for the agent
- Broken state doesn't auto-disable. Plugin files may still work partially. User should decide whether to act.
- If multiple plugins broken at once, likely the user did a git operation or
.claude/migration. Health check is diagnostic, not autofix.
Version History
- 7f5dd76 Current 2026-07-25 04:57
