| name | init-project |
| description | Use when setting up a new project (general or research) or when .pipeline-state.json is missing. Triggers on "init project", "初始化项目", "set up labmate", "first time setup", "initialize".
|
| disable-model-invocation | true |
Init Project
Initialize a project skeleton in the user's existing project. Supports two types: general (lightweight — knowhow, project-skill, changelog) and research (full — adds experiments, scripts, papers, slides). Idempotent: safe to run multiple times — existing files/directories are skipped, never overwritten or deleted.
Language: Default to English for all output. If user responds in Chinese, switch to Chinese for the rest of the session.
执行流程
Step 1: 检测现有结构
-
使用 Bash 运行 git status --porcelain 检查 git 仓库状态：
- 若输出非空（有未提交更改），警告用户并询问是否继续：
"检测到 git 工作区有未提交更改。继续将在此基础上写入文件。确认继续？(Y/n)"
- 若用户回答 n，立即停止。
-
检查以下路径是否存在，记录结果（用于后续 skip 判断）：
CLAUDE.mdexp/docs/.pipeline-state.json.gitignore
-
输出检测摘要（中文），例如：
检测结果：CLAUDE.md 不存在 | exp/ 已存在 | docs/ 不存在 | .pipeline-state.json 不存在 | .gitignore 已存在
Step 2: 收集项目信息
全部自动推断，用户只需确认或修改。
-
用 Bash 获取 basename $(pwd) 作为 {project-name}
-
用 Bash 获取 {compute_env} 默认 local
-
浏览项目现有文件（README、代码、目录名等），推断出：
{description} — 一句话描述（从 README 或目录结构推断）{domain} — 研究领域（从代码、依赖、README 关键词推断）
-
一次性展示给用户确认：
自动检测到以下信息：
- 项目名称：
fars-autotrain
- 描述：
Auto post-training benchmark agent
- 领域：
NLP / Post-training
- 计算环境：
local
需要修改哪项？（直接回车 = 全部确认）
-
用户可以直接回车确认，或输入要改的内容（如 "描述改为 xxx"）
-
自动推断项目类型：
- 若项目已有
exp/ 目录，或 README 中包含 experiment/benchmark/training 关键词 → 默认 research
- 否则默认
general
- 在确认信息中增加一行：
- 项目类型：
general（可选：research / general）
Step 3: 创建目录结构
原则：只创建不存在的文件/目录。已存在则跳过并记录。
插件路径：通过 SKILL.md 所在目录推导插件根目录。
- 此 SKILL.md 位于
<plugin_root>/skills/init-project/SKILL.md
- 因此
<plugin_root> = SKILL.md 向上两级目录
- 所有 references 文件读取自
<plugin_root>/references/
按下列清单逐项处理：
通用部分（general + research 均执行）
3.1 Knowhow 目录
以下目录若不存在则创建并写入 .gitkeep：
docs/knowhow/infrastructure/docs/knowhow/toolchain/docs/knowhow/debug-solutions/docs/knowhow/runbooks/
3.2 文档目录（通用）
docs/specs/.gitkeep — 若 docs/specs/ 不存在则创建
3.3 pipeline 状态文件
若 .pipeline-state.json 不存在，写入：
{
"type": "{type}",
"project_name": "{project-name}",
"description": "{description}",
"domain": "{domain}",
"compute_env": "{compute_env}",
"current_exp": null,
"stage": "dev",
"skill_updated_at": null
}
将占位符替换为 Step 2 收集的值。{type} 为 general 或 research。
3.4 project-skill 空模板
若 .claude/skills/project-skill/SKILL.md 不存在，创建：
---
name: project-skill
description: "Use when advising on project architecture, experiment history, codebase navigation, or research findings."
user-invocable: false
---
# {project-name} — Project Knowledge
> {description}
## Project overview
(run /labmate:update-project-skill to populate)
## Experiment history
(none yet)
## Key findings
(none yet)
将 {project-name} 和 {description} 替换为 Step 2 的值。确保 .claude/skills/project-skill/ 目录存在。
3.5 CHANGELOG.md
若 CHANGELOG.md 不存在，写入：
# Changelog
## Unreleased
- Project initialized with LabMate
Research 专属部分（仅当 type=research 时执行，type=general 则跳过以下全部）
3.6 实验目录
exp/.gitkeep — 若 exp/ 不存在则创建目录并写入空文件exp/summary.md — 若不存在则写入以下内容：
# Experiment Summary
Cross-experiment flight recorder. One row per experiment.
| Exp ID | Motivation | Status | Key Finding |
|--------|-----------|--------|-------------|
3.7 文档目录（research）
以下目录若不存在则创建并写入 .gitkeep：
# Domain Literature Landscape
> Research domain: {domain}
## Key Papers
(待填写 — 使用 @domain-expert 协助整理文献)
## Research Gaps
(待填写)
将 {domain} 替换为 Step 2 收集的研究领域。
3.8 脚本文件
逐一处理（若目标文件已存在则跳过）：
| 目标路径 | 来源（相对插件根） |
|---|
scripts/launch_exp.py | references/launch_exp.py |
scripts/monitor_exp.sh | references/monitor_exp.sh |
scripts/download_results.sh | references/download_results.sh |
viewer/app.py | references/viewer-app.py |
viewer/static/index.html | references/viewer-static/index.html |
操作步骤：
- 用 Read 读取插件 references 中的源文件内容
- 若目标文件不存在，用 Write 写入
- 确保父目录存在（必要时用 Bash
mkdir -p 创建）
3.9 Slides
slides/.gitkeep — 若 slides/ 不存在则创建
Step 4: 生成 CLAUDE.md
从插件读取模板：
- 根据项目类型选择模板：
general → 用 Read 读取 <plugin_root>/references/claude-md-template-general.mdresearch → 用 Read 读取 <plugin_root>/references/claude-md-template-research.md
- 替换以下占位符：
{project-name} → Step 2 的项目名称{description} → Step 2 的一句话描述{date} → 今天日期，格式 YYYY-MM-DD
写入规则：
Step 5: 追加 .gitignore 规则
-
若 .gitignore 不存在，先用 Write 创建空文件（内容为空字符串）
-
用 Read 读取现有 .gitignore 内容，将所有行存入集合 existing_lines
-
根据项目类型确定待追加规则：
若类型为 general：
仅追加以下规则（不读取 references/gitignore-rules.md）：
# labmate rules
.pipeline-state.json
.labmate-hook-state.json
若类型为 research：
用 Read 读取 <plugin_root>/references/gitignore-rules.md，按以下逻辑处理全部行。
-
逐行处理待追加规则的每一行：
- 空行：追加空行（用于格式间隔）
- 注释行（以
# 开头）：始终追加（作为 section 标记）
- 规则行（其他）：
- strip 首尾空白
- 若该行不在
existing_lines 中，则追加
- 若已存在，跳过
-
将所有待追加内容一次性用 Edit 写入 .gitignore 末尾
Step 6: 输出摘要
以中文输出结构化摘要，格式如下：
=== /init-project 完成 ===
项目类型：{type}
已创建：
（根据实际操作列出已创建的文件/目录）
已跳过（已存在）：
（根据实际操作列出已跳过的文件/目录）
已更新：
（根据实际操作列出已更新的文件）
=== 建议后续步骤 ===
1. 检查变更：
git diff
2. 确认无误后提交：
git add -A && git commit -m "chore: init project skeleton"
3. （若 type=research）开始第一个实验：
/labmate:new-experiment
（若 type=general）刷新项目知识：
/labmate:update-project-skill
根据实际操作结果填写"已创建"、"已跳过"、"已更新"列表。
错误处理
- 读取插件 references 文件失败：输出错误信息，说明
<plugin_root>/references/ 中缺少对应文件，跳过该文件继续执行其余步骤
- 写入文件失败（权限等）：输出错误，跳过该文件，最终摘要中标记为
! 写入失败
- 任何步骤失败不中断整体流程，继续执行后续步骤，最终汇总所有错误
幂等性保证
- 已存在的文件：只读，不覆盖
.gitignore 规则：逐行去重，不重复追加CLAUDE.md section：仅追加缺失 section- 目录：已存在则跳过
mkdir
.pipeline-state.json：已存在则完整跳过（不更新字段）
