القائمة
Entry point for new users — guides through initialization, architecture review, and cleanup. Use when the user first opens this project or says "开始" / "初始化" / "怎么用".
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Garbage Collection Agent — 定期扫描项目健康状态，检测文档/代码一致性漂移，自动发起修复提案。
Independently verifies whether a completed task meets its defined goal conditions. Implements maker/checker separation — the agent that wrote the code does not grade its own work. Use after task execution to validate completion before marking done.
Reviews technical decisions before implementation. Detects outdated or suboptimal approaches by searching current best practices. Use when the user asks to implement something using a specific tool, library, or methodology.
Initialize this project with the Harness Engineering starter template. Detects project language, installs dependencies, and updates CLAUDE.md placeholders. Use when the user wants to set up or reset the Harness configuration.
Switch Harness workflow mode (full/hotfix/tweak) and development phase (design/build/fix). Use when the user wants to change the current working mode or phase.
| name | harness-start |
| description | Entry point for new users — guides through initialization, architecture review, and cleanup. Use when the user first opens this project or says "开始" / "初始化" / "怎么用". |
你是刚打开这个模板的人。无论你手头是空项目还是做到一半的项目，四步走完即可就位。
直接说：
帮我初始化 Harness
AI 会自动执行 harness-init 全流程：检测技术栈 → 填写 CLAUDE.md → 发现 Skill 路由 → 检查 Hook → 安装 LSP → 健康检查。
如果已经在 CLAUDE.md 里填过内容，AI 不会覆盖你写好的部分。
初始化完成后，说：
帮我梳理一下当前项目架构
AI 会遍历项目文件，输出一份架构概览——目录结构、模块关系、入口文件都在哪里。这一步让你（也让 AI）对项目全貌建立共识，后续改动才有上下文。
初始化完成后，AI 已经知道了你的项目是什么。现在基于项目的第一性原理（项目本质、技术栈、核心目标），反向检查 CLAUDE.md 和项目目录里有没有不属于这里的东西。
| 维度 | 检查什么 | 示例 |
|---|---|---|
| 🧠 CLAUDE.md 规则 | 每条规则是否与项目相关？ | 个人博客不需要 tech-review 引用 |
| 📁 项目目录 | 模板文件是否仍残留？ | scripts/gc-scan.mjs 对于简单项目可能多余 |
| 🛠️ 技术栈对齐 | CLAUDE.md 中提到的技术是否项目在用？ | 纯 Python 项目不应引用 TypeScript |
| 🎯 目标对齐 | 规则是否服务于项目目标？ | 博客项目不需要 CI 检查 |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 第一性原理清洗
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
根据初始化时获取的信息：
项目类型：{检测到的项目类型}
技术栈：{检测到的技术栈}
核心目标：{用户告知的项目目标}
─────────────────────────────────────
清洗建议（共 N 项）：
[1/N] CLAUDE.md · {文件位置}
现状：{当前内容}
理由：{为什么不符合项目第一性原理}
建议：{具体修改操作}
确认？(y/n) →
[2/N] 项目目录 · {文件/目录路径}
现状：{当前内容}
理由：{为什么可以删除或修改}
建议：{具体操作}
确认？(y/n) →
...
─────────────────────────────────────
所有建议处理完毕，进入下一步验收。
提醒：CLAUDE.md 的行为准则部分（Karpathy 6 条）是通用原则，对所有项目都有价值，不建议裁剪。重点关注的是"进阶特性"和"具体技术引用"。
四步执行完毕时，AI 必须执行以下验收检查并输出结果。不得以"做完了"笼统收尾。
| # | 检查项 | 自动/手动 | 证据来源 |
|---|---|---|---|
| 1 | CLAUDE.md 无占位符 | 自动 | grep '【待填写】' CLAUDE.md → 0 匹配 |
| 2 | 第一性原理清洗完成 | 手动确认 | Step 3 逐条确认记录完整 |
| 3 | 3 个核心 Hook 已注册 | 自动 | .claude/settings.json 中 PreToolUse/SessionStart/Stop 齐全 |
| 4 | LSP 可用 | 自动 | 检查 language server 安装状态 |
| 5 | 健康检查通过 | 自动 | node scripts/check.mjs 输出全绿 |
| 6 | 项目能正常运行 | 手动确认 | 根据项目类型执行对应的 run 命令 |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 初始化验收报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[#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
─────────────────────────────────────
结论：全部通过 ✅ 项目已就位
─────────────────────────────────────
含 ✘ 的项不处理完毕，四步流程不算结束。
你的项目就脱离模板状态了。之后正常开发即可——每次会话 AI 会自动加载 git 状态、审查记录和 Loop 状态。
下次打开新项目时，AI 会重新执行以上四步流程，根据新项目的"第一性原理"重新清洗。
关于 tech-review：Harness Starter 内置了技术方案审查能力。当你在开发中要求 AI 实现某个技术方案时，AI 会自动审查该方案在当前行业是否仍然是最佳实践。详见
.claude/skills/tech-review/SKILL.md。