SuperAPI AI 工具集

better-your-harness

通用与其它

查看项目

更新于 10-16 08:40

技能介绍

用途:对本地项目做 AI 协作环境体检,产出单页、自包含、可直接转发的可视化 HTML 报告。共五层扫描:安全与卫生(.gitignore、明文凭证、Agent 权限、hooks)、上下文质量(入口文件、冷启动成本、目录结构、悬空索引)、工具装备(Skill/MCP/子 Agent、僵尸 Skill)、记忆、学习。

使用方式分四步:先用 python3 ~/.claude/skills/better-your-harness/scripts/scan.py <项目根目录> -o /tmp/harness/findings.json 扫描;再读 findings.json,撰写 analysis.json,只能对脚本已有 id 填 severity/title/why/fix_prompt 并给各层 comment;随后运行 python3 ~/.claude/skills/better-your-harness/scripts/render.py /tmp/harness/findings.json -a /tmp/harness/analysis.json -o <项目>/harness-report.html 渲染;最后告知报告位置并口头复述最高优先级 1-2 条。

限制:报告数字必须可溯源,不确定写「未统计」;密钥值不得进入报告或对话,只写路径、变量名与命中模式;不得发明新 finding。覆盖度 15/33 是「已具备项/应有项」,不使用百分制评分。会话统计依赖本地日志,换客户端或清日志会缺失;凭证扫描为启发式,可能漏报或误报;应有项由该技能自定,非行业标准。