Harness-Starter: Skill for Claude Code

Harness Start

你是刚打开这个模板的人。无论你手头是空项目还是做到一半的项目，四步走完即可就位。

Step 1：初始化

直接说：

帮我初始化 Harness

AI 会自动执行 harness-init 全流程：检测技术栈 → 填写 CLAUDE.md → 发现 Skill 路由 → 检查 Hook → 安装 LSP → 健康检查。

如果已经在 CLAUDE.md 里填过内容，AI 不会覆盖你写好的部分。

Step 2：整体看一下架构

初始化完成后，说：

帮我梳理一下当前项目架构

AI 会遍历项目文件，输出一份架构概览——目录结构、模块关系、入口文件都在哪里。这一步让你（也让 AI）对项目全貌建立共识，后续改动才有上下文。

Step 3：第一性原理清洗

初始化完成后，AI 已经知道了你的项目是什么。现在基于项目的第一性原理（项目本质、技术栈、核心目标），反向检查 CLAUDE.md 和项目目录里有没有不属于这里的东西。

清洗范围

执行规范

1. 每条建议必须说明理由，不得只说"删除"不说"为什么"
2. 必须等用户确认，用户点头才能改
3. 用户拒绝的要尊重，不能追问"确定吗"
4. 一轮最多提 5 条，避免轰炸用户

输出格式

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 第一性原理清洗
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

根据初始化时获取的信息：
  项目类型：{检测到的项目类型}
  技术栈：{检测到的技术栈}
  核心目标：{用户告知的项目目标}

─────────────────────────────────────
清洗建议（共 N 项）：

[1/N] CLAUDE.md · {文件位置}
  现状：{当前内容}
  理由：{为什么不符合项目第一性原理}
  建议：{具体修改操作}
  确认？(y/n) →

[2/N] 项目目录 · {文件/目录路径}
  现状：{当前内容}
  理由：{为什么可以删除或修改}
  建议：{具体操作}
  确认？(y/n) →

...

─────────────────────────────────────
所有建议处理完毕，进入下一步验收。

提醒：CLAUDE.md 的行为准则部分（Karpathy 6 条）是通用原则，对所有项目都有价值，不建议裁剪。重点关注的是"进阶特性"和"具体技术引用"。

Step 4：验收 — 检查是否就位

四步执行完毕时，AI 必须执行以下验收检查并输出结果。不得以"做完了"笼统收尾。

检查项

验收输出格式

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 初始化验收报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[#1] ✔ CLAUDE.md 已填写 — 无【待填写】占位符
[#2] ✔ 第一性原理清洗完成 — N 项建议已处理
[#3] ✔ 3 个核心 Hook 已注册 — PreToolUse / SessionStart / Stop
[#4] ✔ LSP 可用 — {language-server}
[#5] ✔ 健康检查通过 — node scripts/check.mjs → 全绿
[#6] ✔ 项目可运行 — {run command} → exit 0

─────────────────────────────────────
结论：全部通过 ✅  项目已就位
─────────────────────────────────────