Back to Details

initialization

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Initialization

初始化

Project setup and feature breakdown for INIT state.
INIT状态下的项目搭建与功能拆解。

Execution Order (MANDATORY)

执行顺序（强制要求）

Follow this exact sequence. Do NOT skip steps.
请严格遵循此顺序，不得跳过任何步骤。

Step 1: Global Setup (once per machine)

步骤1：全局设置（每台机器执行一次）

bash
undefined
bash
undefined

Check if global CLAUDE.md exists

检查全局CLAUDE.md是否存在

[ -f ~/.claude/CLAUDE.md ] || ~/.claude/skills/initialization/scripts/global-init.sh
undefined
[ -f ~/.claude/CLAUDE.md ] || ~/.claude/skills/initialization/scripts/global-init.sh
undefined

Step 2: Global Hooks (once per machine)

步骤2：全局钩子（每台机器执行一次）

bash
undefined
bash
undefined

Check and install global hooks

检查并安装全局钩子

[ -x ~/.claude/hooks/verify-state-transition.py ] ||
~/.claude/skills/global-hook-setup/scripts/setup-global-hooks.sh

**IMPORTANT**: Load `global-hook-setup` skill if hooks missing.
[ -x ~/.claude/hooks/verify-state-transition.py ] ||
~/.claude/skills/global-hook-setup/scripts/setup-global-hooks.sh

**重要提示**：若钩子缺失，请加载`global-hook-setup`技能。

Step 3: MCP Servers (once per project)

步骤3：MCP服务器（每个项目执行一次）

bash
undefined
bash
undefined

Check and install MCP servers

检查并安装MCP服务器

[ -d mcp/token-efficient-mcp ] ||
~/.claude/skills/mcp-setup/scripts/setup-all.sh --non-interactive

**IMPORTANT**: Load `mcp-setup` skill if MCP missing.
[ -d mcp/token-efficient-mcp ] ||
~/.claude/skills/mcp-setup/scripts/setup-all.sh --non-interactive

**重要提示**：若MCP缺失，请加载`mcp-setup`技能。

Step 4: Project Structure

步骤4：项目结构

bash
~/.claude/skills/initialization/scripts/init-project.sh
Creates:
  • .claude/config/project.json
    - Project settings
  • .claude/progress/state.json
    - State (transitions to INIT)
  • CLAUDE.md
    - Project documentation
  • .claude/CLAUDE.md
    - Quick reference
bash
~/.claude/skills/initialization/scripts/init-project.sh
将创建以下内容：
  • .claude/config/project.json
    - 项目设置
  • .claude/progress/state.json
    - 状态（切换至INIT）
  • CLAUDE.md
    - 项目文档
  • .claude/CLAUDE.md
    - 快速参考手册

Step 5: Project Hooks (once per project)

步骤5：项目钩子（每个项目执行一次）

bash
undefined
bash
undefined

Check and install project hooks

检查并安装项目钩子

[ -x .claude/hooks/verify-tests.py ] ||
~/.claude/skills/project-hook-setup/scripts/setup-project-hooks.sh --non-interactive

**IMPORTANT**: Load `project-hook-setup` skill if hooks missing.
[ -x .claude/hooks/verify-tests.py ] ||
~/.claude/skills/project-hook-setup/scripts/setup-project-hooks.sh --non-interactive

**重要提示**：若钩子缺失，请加载`project-hook-setup`技能。

Step 6: Check Dependencies

步骤6：检查依赖

bash
~/.claude/skills/initialization/scripts/check-dependencies.sh
Fix any errors before proceeding.
bash
~/.claude/skills/initialization/scripts/check-dependencies.sh
请先修复所有错误再继续。

Step 7: Create Feature List

步骤7：创建功能列表

  • Analyze user requirements
  • Break down into atomic features (INVEST criteria)
  • Create 
    .claude/progress/feature-list.json
bash
~/.claude/skills/initialization/scripts/create-feature-list.sh
  • 分析用户需求
  • 将需求拆解为符合INVEST原则的原子化功能
  • 创建
    .claude/progress/feature-list.json
bash
~/.claude/skills/initialization/scripts/create-feature-list.sh

Step 8: Initialize Progress

步骤8：初始化进度跟踪

bash
~/.claude/skills/initialization/scripts/init-progress.sh
bash
~/.claude/skills/initialization/scripts/init-progress.sh

Step 9: Verify INIT Complete

步骤9：验证INIT完成

bash
~/.claude/skills/initialization/scripts/verify-init.sh
Must pass all 14 checks before transitioning to IMPLEMENT.
bash
~/.claude/skills/initialization/scripts/verify-init.sh
必须通过全部14项检查后，方可切换至IMPLEMENT状态。

CLAUDE.md Hierarchy

CLAUDE.md 层级结构

FileScopePurpose
~/.claude/CLAUDE.md
GlobalUser preferences, skill enforcement
CLAUDE.md
ProjectProject documentation (100-300 lines)
.claude/CLAUDE.md
LocalQuick reference (<50 lines)
文件范围用途
~/.claude/CLAUDE.md
全局用户偏好设置、技能强制执行规则
CLAUDE.md
项目项目文档（100-300行）
.claude/CLAUDE.md
本地快速参考手册（少于50行）

Exit Criteria (Code Verified)

退出标准（代码已验证）

bash
undefined
bash
undefined

Project structure initialized

项目结构已初始化

[ -f "CLAUDE.md" ] # Project documentation created [ -f ".claude/CLAUDE.md" ] # Quick reference created [ -f ".claude/config/project.json" ] # Project config [ -d ".claude/progress/" ] # Tracking directory
[ -f "CLAUDE.md" ] # 已创建项目文档 [ -f ".claude/CLAUDE.md" ] # 已创建快速参考手册 [ -f ".claude/config/project.json" ] # 已生成项目配置 [ -d ".claude/progress/" ] # 已创建跟踪目录

Feature list created

功能列表已创建

[ -f ".claude/progress/feature-list.json" ] jq '.features | length > 0' .claude/progress/feature-list.json jq '.features[0] | has("id", "description", "priority", "status")' .claude/progress/feature-list.json
[ -f ".claude/progress/feature-list.json" ] jq '.features | length > 0' .claude/progress/feature-list.json jq '.features[0] | has("id", "description", "priority", "status")' .claude/progress/feature-list.json

Dependencies verified

依赖已验证

scripts/check-dependencies.sh --quiet
scripts/check-dependencies.sh --quiet

Hooks installed

钩子已安装

[ -x "~/.claude/hooks/verify-state-transition.py" ] # Global hooks [ -x ".claude/hooks/verify-tests.py" ] # Project hooks
undefined
[ -x "~/.claude/hooks/verify-state-transition.py" ] # 全局钩子已安装 [ -x ".claude/hooks/verify-tests.py" ] # 项目钩子已安装
undefined

Scripts

脚本说明

ScriptPurpose
scripts/global-init.sh
One-time setup for ~/.claude/CLAUDE.md (global preferences)
scripts/init-project.sh
Initialize .claude/ structure, generate CLAUDE.md files
scripts/detect-project.sh
Detect Python/Node/Django/etc
scripts/check-dependencies.sh
Verify MCP, env vars, services, ports
scripts/create-init-script.sh
Generate init.sh for dev server
scripts/create-feature-list.sh
Generate feature-list.json
scripts/init-progress.sh
Initialize .claude/progress/
scripts/verify-init.sh
Verify all INIT criteria met
脚本用途
scripts/global-init.sh
一次性设置~/.claude/CLAUDE.md（全局偏好）
scripts/init-project.sh
初始化.claude/目录结构、生成CLAUDE.md文件
scripts/detect-project.sh
检测项目类型（Python/Node/Django等）
scripts/check-dependencies.sh
验证MCP、环境变量、服务、端口状态
scripts/create-init-script.sh
生成用于开发服务器的init.sh脚本
scripts/create-feature-list.sh
生成feature-list.json
scripts/init-progress.sh
初始化.claude/progress/目录
scripts/verify-init.sh
验证是否满足所有INIT状态标准

References

参考文档

FileLoad When
references/feature-breakdown.mdBreaking down requirements
references/project-detection.mdDetecting project type
references/mvp-feature-breakdown.mdMVP-first tiered feature generation (10/30/200)
文件加载场景
references/feature-breakdown.md需求拆解时加载
references/project-detection.md项目类型检测时加载
references/mvp-feature-breakdown.md按MVP优先层级生成功能时加载（10/30/200规则）

Assets

资源文件

FilePurpose
templates/CLAUDE.project.template.mdTemplate for CLAUDE.md (project root)
templates/CLAUDE.local.template.mdTemplate for .claude/CLAUDE.md (quick reference)
templates/framework-templates/*.mdFramework-specific content (python, node, rust, go)
assets/feature-list.template.jsonTemplate for new feature lists
文件用途
templates/CLAUDE.project.template.mdCLAUDE.md（项目根目录）模板
templates/CLAUDE.local.template.md.claude/CLAUDE.md（快速参考）模板
templates/framework-templates/*.md框架专属内容模板（Python、Node、Rust、Go等）
assets/feature-list.template.json新功能列表模板