所有手动搭Harness的教程可以退休了!3个Skill帮你从零搭到可视化,一次全通关!

我折腾了两周多才摸明白的Harness搭建流程,现在被人打包成了3个Skill,装上就能用。
先说清楚,Harness不是什么新鲜词,就是模型之外那一整套让它能干活的东西。文件夹怎么分层、权限开多大、Skill装几个,开源项目从来不管,全靠你自己动手搭。
DeepSeek再强也一样,它给的只是内核,剩下的活儿留给你自己。
我之前的做法是什么?手动建文件夹,凑合着分类,遇到不知道往哪放的文件就丢进一个"其他"目录,时间久了自己都找不到东西。
现在有人把这套流程拆成了三个Skill,分别叫star-your-harness、better-your-harness、view-your-harness,对应搭建、体检、可视化。项目地址是 SpaceZephyr/build-your-harness,MIT协议,零依赖,Claude Code、Codex、Cursor、OpenClaw全都能用。

一、star-your-harness:从零开始不用瞎猜

如果你刚装完Codex或者Claude Code,正对着空文件夹发愁,这个Skill就是给你用的。
安装命令一句话:
帮我安装 Skill https://github.com/SpaceZephyr/build-your-harness.git
装完之后发一句"帮我搭一个xxx职位的harness",它会先问你四个问题:你是干什么的、想让AI帮你做什么、资料现在散在哪、打算放哪儿。

回答完,它按你的职业生成分层目录。拿产品经理举例,入口层放CLAUDE.md,上下文层放关于我和素材库,产出层放需求、原型、调研、已交付,记忆层带索引,工具层放Skill和自动化脚本。
每一层旁边都标着它在Harness里的作用,你确认之后才真正落盘创建文件,不会碰你本地已有的东西。
我对这个流程的评价是:终于不用自己瞎拍脑袋分类了。

二、better-your-harness:给你的文件夹做个CT

搭完之后不代表就没问题了,用久了照样会乱。
我拿这个Skill扫了一遍自己维护的内容创作目录,结果有点意外。
首次加载要吃掉12878个token,这还只是读入口文件和各层README的量。信噪比只有2.2%,一万多个被跟踪的文件里,真正算源文件的还不到230个。
Skill装了262个,但真实被调用过的只有7个,加起来总共调用21次。最后一次提交是179天前,工作区堆了一万多项没提交的改动。
它按五个维度查了34项:安全与隐私、上下文质量、工具装备、记忆、学习。查完之后不是甩给你一堆问题就完事,而是直接给出可以复制的修复口令,带绝对路径、具体文件清单、验证命令,还提前打了一句"先给我看,不要直接改"。

密钥这种敏感信息,报告里只会出现变量名,值不会露出来。

三、view-your-harness:把文件夹变成一面卡片墙

前两个解决的是"哪里有问题"和"怎么搭",这个解决的是"平时怎么用"。
它起一个本地服务,把你的文件和Skill全部铺成卡片。文件页统计总数、占用空间,按文档、代码、数据、图片分类,还能按最近改动或者体积排序。Markdown文件直接在页面里预览和改,懒得手动分类的话直接交给AI处理。

Skill页更直接,列出项目下所有装过的Skill,标好调用次数。用过和从没用过的分得清清楚楚,没用的直接删,不用再翻文件夹去确认。
这个统计不是拍脑袋估的,认的是会话日志里真实的Skill调用记录。

四、这套东西到底解决了什么

我之前用手动整理的方式弄了很久都搞不定分类和体检,换成这三个Skill之后,从搭建到体检到日常查看,一条流程走完。
而且这三个Skill不绑定某一款Agent,换了工具照样能用。不管你明天换成哪个新模型、新客户端,你自己的Harness还在,工作能无缝接上。

转自:https://mp.weixin.qq.com/s/Q9r526yAc45g_jlKS9kXuQ