harness-init

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Harness Init Skill

Sets up a project so VibeCoder can start development with natural language only. Completes with minimum 1 question, ready to start development immediately.

搭建项目环境，让VibeCoder仅通过自然语言即可启动开发。 只需至少1个问题即可完成配置，完成后可立即启动开发。

Quick Reference

快速参考

"Want to launch a new project fastest" → this skill
"Leave it to you" / "Quickly" → proceed with defaults, no questions
"With Next.js + Supabase" → technology specification
"Introduce harness to existing project" → analyze existing code

"想要最快启动新项目" → 使用本技能
"交给你处理" / "快速完成" → 使用默认配置，无需额外提问
"基于Next.js + Supabase" → 指定技术栈
"在现有项目中引入Harness" → 分析现有代码

Deliverables

交付内容

Real project generation (e.g., create-next-app) + initial setup
Prepare
```
Plans.md
```
/
```
AGENTS.md
```
/
```
CLAUDE.md
```
/
```
.claude/
```
Optional: Codex CLI compatibility (
```
.codex/
```
+
```
AGENTS.md
```
)
Environment diagnosis → SSOT initialization → Final validation
→ Ready to run Plan→Work→Review immediately

生成真实项目（例如create-next-app）并完成初始配置
生成
```
Plans.md
```
/
```
AGENTS.md
```
/
```
CLAUDE.md
```
/
```
.claude/
```
文件
可选：支持Codex CLI兼容性（生成
```
.codex/
```
+
```
AGENTS.md
```
）
环境诊断 → SSOT初始化 → 最终验证
→ 可立即执行Plan→Work→Review流程

Usage

使用方法

bash

/harness-init                              # Interactive setup (min 1 question)
/harness-init blog --mode=solo             # With partial specification
/harness-init --stack=next-supabase        # Specify tech stack

bash

/harness-init                              # 交互式配置（至少1个问题）
/harness-init blog --mode=solo             # 带部分配置项的初始化
/harness-init --stack=next-supabase        # 指定技术栈

Feature Details

功能详情

Feature	Reference
Execution Flow	See references/execution-flow.md
Smart Defaults	See references/smart-defaults.md
Generated Files	See references/generated-files.md

功能	参考文档
执行流程	查看references/execution-flow.md
智能默认配置	查看references/smart-defaults.md
生成文件清单	查看references/generated-files.md

Optimized Flow

优化后的流程

Before: Up to 11 dialogue rounds After: Minimum 1, maximum 2 dialogue rounds

Step 1: Unified question (1 time)
  ├─ What are you building?
  ├─ Who will use it?
  └─ Leave it to me or detailed settings?

Step 2: Confirmation (skip if "leave it to me")
  └─ Tech stack + project name

→ Execute setup (includes background analysis)

Step 3: Completion report

优化前：最多需要11轮对话 优化后：最少1轮，最多2轮对话

步骤1：统一提问（1次）
  ├─ 你要开发什么项目？
  ├─ 项目的目标用户是谁？
  └─ 交给我默认配置还是需要详细设置？

步骤2：确认配置（若选择“交给我处理”则跳过此步骤）
  └─ 确认技术栈 + 项目名称

→ 执行初始化配置（包含后台代码分析）

步骤3：生成完成报告

Arguments

参数说明

Argument	Description	Example
`[project description]`	What to build	`"EC site"`
`--mode`	solo / 2agent	`--mode=solo`
`--stack`	Tech stack	`--stack=next-supabase`
`--name`	Project name	`--name=my-app`
`--lang`	Language	`--lang=en`

参数	说明	示例
`[project description]`	项目描述	`"EC site"`
`--mode`	运行模式（solo / 2agent）	`--mode=solo`
`--stack`	指定技术栈	`--stack=next-supabase`
`--name`	项目名称	`--name=my-app`
`--lang`	语言设置	`--lang=en`

Smart Defaults

智能默认配置

Item	Default	Auto-determination
Language	ja	Config file
Mode	Solo	2-Agent if .cursor/ exists
Tech stack	next-supabase	In auto mode
Skills Gate	Auto-configured	Adjust with `/skills-update`

配置项	默认值	自动判定规则
语言	ja	读取配置文件自动判定
运行模式	Solo	若存在.cursor/目录则自动切换为2-Agent模式
技术栈	next-supabase	自动模式下的默认选择
技能网关	自动配置	通过 `/skills-update` 命令调整

Next Steps

后续操作

After setup:

"
```
/plan-with-agent
```
I want to create XXX" → Create plan
"
```
/work
```
" → Execute tasks in Plans.md
"
```
npm run dev
```
" → Start dev server
If you need Codex CLI: run
```
/setup codex
```

初始化完成后：

输入"
```
/plan-with-agent
```
我想开发XXX" → 生成开发计划
输入"
```
/work
```
" → 执行Plans.md中的开发任务
执行"
```
npm run dev
```
" → 启动开发服务器
若需要Codex CLI支持：执行
```
/setup codex
```
命令