SpaceZephyr

Star Your Harness — AI skill for Claude Code

AI community

跟 AI 聊四句话，给自己搭一个 harness.

How to install Star Your Harness

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

What Star Your Harness does

跟 AI 聊四句话，给自己搭一个 harness。先出可视化方案报告让你判断，确认后才落盘。生成的目录直接通过 better-your-harness 体检。零依赖。

Alternatives in AI

Impeccable — The design language that makes your AI harness better at design 13.9k ★
ARIS Agent Guide — For AI agents reading this repo 6.2k ★
Osaurus — Own your AI. The native macOS harness for AI agents -- any model, persistent memory, autonomous execution, cry 5.1k ★

README

star-your-harness

跟 AI 聊四句话，给自己搭一个 harness：一个专门给 AI 协作用的工作目录。

先出一份**可视化方案报告**让你过目，你在页面上把拿不准的地方判断掉，确认之后才落盘。**在你点头之前，一个文件都不会被创建或移动。**

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

跟 [better-your-harness](https://github.com/SpaceZephyr/better-your-harness) 是一对：**这个负责搭，那个负责体检。**

什么是 harness

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

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

这个工具给你一个**立得住的骨架**，剩下的你往里填。

一分钟上手

git clone https://github.com/SpaceZephyr/star-your-harness.git
cd star-your-harness

写一份 `profile.json`：

{
  "name": "我的写作 harness",
  "dir": "/Users/you/harness",
  "role": "content-creator",
  "naming": "numbered-en",
  "why": "资料散在三个地方，每次让 AI 干活都要重新解释背景",
  "sources": ["/Users/you/旧笔记"]
}

三步走：

# 1. 出方案（不写盘）
python3 scripts/plan.py profile.json -o plan.html

# 2. 浏览器打开 plan.html，把「要你判断的」那几行调好，点「复制我的决定」
#    存成 decisions.json

# 3. 预演 → 执行
python3 scripts/apply.py plan.json -d decisions.json
python3 scripts/apply.py plan.json -d decisions.json --apply

装成 Claude Code 的 Skill，让它替你跑完整流程（含访谈）：

ln -s "$(pwd)" ~/.claude/skills/star-your-harness

然后说一句「帮我搭一个 harness」。

方案报告长什么样

一个自包含的 HTML，四块：

区块	内容
1 会建成什么样	目录树，左边色条标它属于 harness 哪一层，右边标会写几个文件
2 需要注意的地方	目标目录非空、来源是代码工程、同名冲突
3 要你判断的	每个待搬文件一个下拉框，带判断依据和把握程度，全都能改
4 确认执行	「复制我的决定」按钮

判断结果通过复制按钮回传。深浅色自适应，可打印，图表全是手绘内联 SVG。

生成出来是什么

CLAUDE.md              入口：目录地图 + 6 条行为规则 + 任务路由表
README.md
.gitignore             含凭证兜底那几行
.claude/settings.json  一个 hook：拦截 git add -A

00-inbox/              没想好放哪的先扔这                    ← 入口
10-about-me/           我是谁 / 工作偏好 / 质量标准           ← 上下文层
20-<产出>/             因职业而异                            ← 产出层
30-vault/              别人的东西：摘录、案例、参考           ← 上下文层
40-memory/             MEMORY.md 索引 + 种子记忆             ← 记忆层
50-protocols/          workflows + daily-log + iterations/   ← 学习层
60-