SpaceZephyr

Build Your Harness — Development skill for Claude Code

Development community

两个配套的 Agent Skill:一个搭 harness,一个给 harness 体检.

How to install Build Your Harness

This entry records only its repository, not the path inside it, so there is no exact command to give. Open SpaceZephyr/build-your-harness and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Build Your Harness does

两个配套的 Agent Skill:一个搭 harness,一个给 harness 体检。标准 SKILL.md 格式,Claude Code / Codex / Cursor / OpenClaw 通用,脚本也能直接当 CLI 跑。五层框架 + 可视化报告,破坏性动作一律先出方案等你点头。零依赖。

Alternatives in Development

  • Understand Anything — Graphs that teach graphs that impress 80.7k ★
  • Petdex — A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and 4k ★
  • Haft — Engineering decisions engine that know when they're stale 1.4k ★

README

build-your-harness


`star-your-harness.skill`  ·  `better-your-harness.skill`  ·  `view-your-harness.skill`


![LICENSE](https://img.shields.io/badge/LICENSE-MIT-DFB317?style=for-the-badge&labelColor=555555) ![AGENT SKILLS](https://img.shields.io/badge/AGENT_SKILLS-STANDARD-4CAF50?style=for-the-badge&labelColor=555555) ![DEPENDENCIES](https://img.shields.io/badge/DEPENDENCIES-ZERO-2196F3?style=for-the-badge&labelColor=555555)

![RUNTIME](https://img.shields.io/badge/RUNTIME-CLAUDE_CODE_%C2%B7_CODEX_%C2%B7_CURSOR_%C2%B7_OPENCLAW-7C3AED?style=for-the-badge&labelColor=555555)

公众号 / 小红书 / B站 / 知乎:空格的键盘  |  [wzfh520@gmail.com](mailto:wzfh520@gmail.com)


三个配套的 Agent Skill:**一个负责搭 harness,一个负责给 harness 体检,一个负责日常翻。**

Skill 干什么 产出
**star-your-harness** 从零搭一个 harness 可视化方案报告 → 你确认 → 目录骨架落盘
**better-your-harness** 给现有 harness 体检 可视化体检报告 + 可一键复制的修复口令
**view-your-harness** 日常翻你的 harness 本地只读工作台:文件清单 + Skill 装备台

零依赖,只需要 Python 3.8+。不联网,不上传任何东西。

不绑定任何一个 Agent

三个 Skill 用的是标准 `SKILL.md` 格式(YAML frontmatter + 正文),**任何能读它的 Agent 都能用**:Claude Code、Codex、Cursor、OpenClaw、以及各种 buddy 系工具。

更彻底一点:**底层全是纯 Python 命令行脚本,不 import 任何 Agent 相关的东西。** 你完全不用 Skill 机制,直接当 CLI 跑也行,产出的 HTML 报告是一样的。Skill 那层只是替你把访谈、判断、串流程这些事包起来。

体检工具还会**同时扫描多个 runtime 的 Skill 目录**(`~/.claude/skills`、`~/.codex/skills`、项目级 `.claude/skills` 和 `.agents/skills`),按唯一名字去重,所以你混着用几个 Agent 也能得到一个统一的清单。

什么是 harness

不是笔记软件,不是知识库,是**你和 Agent 之间的那层结构**。

你写过 CLAUDE.md 或 AGENTS.md、装过 Skill、接过 MCP、建过记忆目录,那些零件加起来就是 harness。问题是大多数人的 harness 是**攒**出来的不是**搭**出来的:目录随手建,规则想起来才写,资料散在三个地方,每次让 Agent 干活都要重新解释一遍背景。

更麻烦的是你不知道它现在什么状况。装了多少 Skill 真正被调用过?Agent 读你这个仓库要先吃掉多少 token?有没有明文密钥躺在一个没被 `.gitignore` 覆盖的地方?

star 管搭,better 管查状况,view 管你每天翻着看手上到底有什么。

五层框架

三个工具共用同一套语言,所以搭出来的东西能直接被体检、被翻阅:

层 是什么 落地成什么