메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | harness-init |
| description | 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. |
适用三种场景：
检查项目根目录下是否有 .claude/hooks/ 和 CLAUDE.md。
用户直接让 AI 安装 Harness Starter，还没有模板文件。需要：
package.json 的 repository 字段获取仓库地址，克隆到临时目录：
git clone https://github.com/<package.json repository>.git /tmp/harness-starter
cp -r /tmp/harness-starter/.claude/ .claude/
cp /tmp/harness-starter/CLAUDE.md ./
cp /tmp/harness-starter/.lsp.json ./
cp /tmp/harness-starter/.gitignore ./.gitignore 2>/dev/null || true
cp -r /tmp/harness-starter/scripts/ ./scripts/ 2>/dev/null || true
mkdir -p .github/workflows 2>/dev/null
cp -r /tmp/harness-starter/.github/ ./.github/ 2>/dev/null || true
跳过 Step 0，直接执行 Step 1。
优先从已有文件自动推断，推断不到再问用户：
检查以下文件，提取项目信息：
package.json → 项目名、技术栈（React/Vue/Next 等）、测试框架（jest/vitest 等）pyproject.toml → 项目名、Python 依赖go.mod → 模块名、Go 版本Cargo.toml → 项目名、Rust 依赖composer.json → PHP 项目Gemfile → Ruby 项目CMakeLists.txt → C/C++ 项目对于多语言项目，选择主要技术栈填写。
用 Step 1 检测到的信息替换 CLAUDE.md 中的 【待填写】 占位符。
如果无法自动推断，询问用户：
检查 CLAUDE.md 是否已包含以下核心章节：
如果缺失，补充进去。已有的内容不要覆盖。
根据 Step 1 检测到的技术栈，扫描当前可用的 Skill，询问用户最常见的任务类型，生成路由表写入 CLAUDE.md。
检查以下位置，汇总所有可用 Skill：
.claude/skills/ — 项目本地 Skill（如 harness-init、harness-mode）~/.claude/skills/ — 用户全局 Skill[Available Skills] 列表根据技术栈列出常见任务类型，例如：
| 技术栈 | 常见任务 | 可路由 Skill |
|---|---|---|
| React/Next.js | 组件开发、性能优化 | vercel-react-best-practices |
| 前端/UI | 页面/H5/幻灯片 | frontend-slides |
| Node.js/npm | 包管理、构建 | 项目已有 Skill |
| Python | 测试、格式化 | 项目已有 Skill |
| 公众号/内容 | 微信排版、写作 | wechat-article-formatter |
原则：只推荐当前会话中实际可用的 Skill，不要假设用户安装了某个 Skill。
在 CLAUDE.md 末尾追加一个 # Skill 路由 章节，格式如下：
# Skill 路由
根据项目技术栈和任务类型，推荐以下 Skill：
| 任务类型 | Skill | 触发条件 |
|---------|-------|---------|
| React 组件开发 | vercel-react-best-practices | 涉及 .tsx / .jsx 文件修改 |
| 微信文章排版 | wechat-article-formatter-skill | 用户要求排版/发布公众号内容 |
| Harness 管理 | harness-init / harness-mode | 用户要求调整 Harness 配置 |
| [项目已有] | [skill-name] | [触发场景] |
> Agent 在遇到对应任务时，应优先调用路由表中的 Skill。
生成路由表后，向用户确认：
检查 .claude/hooks/ 下五个文件是否存在：
pre-tool-check.mjs — 防止 AI 修改 .envpost-tool-check.mjs — 自动格式化pre-compact.mjs — 长会话保留 Loop 状态session-context.mjs — 自动注入 git 状态 + Loop 状态session-review.mjs — 对话结束生成审查报告 + GC 扫描缺失则从模板复制。已有则跳过，不要覆盖。
检查 .claude/settings.json 中是否注册了所有 Hook（PreToolUse / PostToolUse / PreCompact / SessionStart / Stop）。
缺失则补充，已有的其他配置不要删除。
检查 typescript-language-server 是否可用。
如果不可用，根据 Step 1 检测到的语言安装对应的 language server。
如果 .lsp.json 里的语言配置和项目不符，根据检测结果修改。
询问用户是否需要规范驱动开发工作流。 如果用户确认：
npm install -g @fission-ai/openspecopenspec init.claude/ 下添加 commands 和 skills，不要阻止执行 node scripts/check.mjs，向用户展示结果。
如果有失败项，逐一处理。
可选：向用户介绍 GC Agent：
node scripts/gc-scan.mjs — 手动执行 8 维度健康扫描/loop 24h "node scripts/gc-scan.mjs" — 定时自动扫描.claude/loops/LOG.md向用户说明当前 Harness 状态：
Entry point for new users — guides through initialization, architecture review, and cleanup. Use when the user first opens this project or says "开始" / "初始化" / "怎么用".
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.
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.