技能介绍

问题在哪

SKILL.md 是模型决定要不要加载、加载后照着做的运行时指令包：description 决定何时被唤醒，正文每次触发都会占上下文。常见问题是只写「做什么」不写「何时用」导致永远不被触发；把框架教程、大段脚本塞进正文，别人装上路径失效，或每次白付 token。

怎么体检

本技能把「Agent Skill 最佳实践」落成可复用流程：机检（check.py，零依赖，可 --json 与 CI）按 12 项打分——触发、篇幅、渐进披露、脚本外置、可移植、安全红线等；#2 触发 / #3 篇幅 / #4 渐进披露等项权重更高，「缺 README」类只轻扣。可选叠加 SkillSpector 做更深安全模式扫描（只建议扫外来 skill；自研宜用 baseline 回归）；可选 触发力实测（trigger_eval.py，自付 API，判 description 写得准不准）。机检之上必须定性复核：通读 description 当模型、区分私有事实与可删的通用教学，再出中文报告（✓/▲/✗ + Top 3 优先改项）。用户同意后可代做瘦身、拆 references/、外置 scripts/、补触发句，并重跑对比分数。

边界与注意

免费：文本/JSON 报告与评分；触发力实测与品牌可视化报告卡为可选/增值，不跑也不影响完整体检。体检只读，不打开 .env / 密钥文件；改文件须先说明并获同意。机检对 description「准不准」有盲区，怀疑触发时再用实测；SkillSpector 总分易通胀，以条目与源码为准，勿当安装门禁。