1
2
3
4
5
6

// 检查目标文件是否存在
let init_target = self.config.cwd.join(DEFAULT_AGENTS_MD_FILENAME);
if init_target.exists() {
    // 安全退出，避免覆盖
    return;
}

1
2
3
4
5
6

const command = {
  type: 'prompt',
  name: 'init',
  description: 'Initialize new CLAUDE.md file(s) and optional skills/hooks',
  // ...
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

用户输入 `/init`
    │
    ▼
ChatComposer::parse_slash_command() → SlashCommand::Init
    │
    ▼
ChatWidget::handle_slash_command_dispatch()
    │
    ▼
ChatWidget::dispatch_command(SlashCommand::Init)
    │
    ├─ 检查: AGENTS.md 是否存在？
    │       ├─ YES → 显示提示并返回
    │       └─ NO  ↓
    │
    ▼
加载 INIT_PROMPT (prompt_for_init_command.md)
    │
    ▼
submit_user_message(INIT_PROMPT)
    │
    ▼
Session → Turn → ModelClient → OpenAI API
    │
    ▼
模型生成内容 → write_to_file 工具调用
    │
    ▼
生成 ./AGENTS.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

// tui/src/chatwidget/slash_dispatch.rs:176-187
SlashCommand::Init => {
    let init_target = self.config.cwd.join(DEFAULT_AGENTS_MD_FILENAME);
    if init_target.exists() {
        let message = format!(
            "{DEFAULT_AGENTS_MD_FILENAME} already exists here. Skipping /init."
        );
        self.add_info_message(message, /*hint*/ None);
        return;
    }
    const INIT_PROMPT: &str = include_str!("../../prompt_for_init_command.md");
    self.submit_user_message(INIT_PROMPT.to_string().into());
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

Generate a file named AGENTS.md that serves as a contributor guide.

Document Requirements:
- Title: "Repository Guidelines"
- Length: 200-400 words
- Use Markdown headings

Recommended Sections:
1. Project Structure & Module Organization
2. Build, Test, and Development Commands
3. Coding Style & Naming Conventions
4. Testing Guidelines
5. Commit & Pull Request Guidelines

1
2
3
4
5
6
7
8
9

# Repository Guidelines

## Project Structure & Module Organization
- src/ - 源代码
- tests/ - 测试代码

## Build, Test, and Development Commands
- `npm test` - 运行测试
- `npm run build` - 构建项目

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

用户输入 `/init`
    │
    ▼
SlashCommandParser → CommandRegistry.get('init')
    │
    ▼
CommandExecutor.execute(command)
    │
    ▼
getPromptForCommand() → 返回 Prompt 数组
    │
    ├─ NEW_INIT 特性启用?
    │       ├─ YES → NEW_INIT_PROMPT (225 行)
    │       └─ NO  → OLD_INIT_PROMPT (20 行)
    │
    ▼
Agent 执行 8 阶段流程
    │
    ├─ Phase 1: 询问用户需求
    ├─ Phase 2: 探索代码库
    ├─ Phase 3: 填补信息 gaps
    ├─ Phase 4: 写入 CLAUDE.md
    ├─ Phase 5: 写入 CLAUDE.local.md (可选)
    ├─ Phase 6: 创建技能 (可选)
    ├─ Phase 7: 建议优化 (可选)
    └─ Phase 8: 总结

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// src/commands/init.ts:226-254
const command = {
  type: 'prompt',
  name: 'init',
  get description() {
    return feature('NEW_INIT') &&
      (process.env.USER_TYPE === 'ant' || isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
      ? 'Initialize new CLAUDE.md file(s) and optional skills/hooks'
      : 'Initialize a new CLAUDE.md file'
  },
  contentLength: 0,
  progressMessage: 'analyzing your codebase',
  source: 'builtin',
  async getPromptForCommand() {
    maybeMarkProjectOnboardingComplete()
    return [{
      type: 'text',
      text: feature('NEW_INIT') &&
        (process.env.USER_TYPE === 'ant' || isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
        ? NEW_INIT_PROMPT
        : OLD_INIT_PROMPT,
    }]
  },
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

## Phase 1: Ask what to set up

Use AskUserQuestion to find out:
- "Which CLAUDE.md files should /init set up?"
  Options: "Project CLAUDE.md" | "Personal CLAUDE.local.md" | "Both"

- "Also set up skills and hooks?"
  Options: "Skills + hooks" | "Skills only" | "Hooks only" | "Neither"

## Phase 2: Explore the codebase

Launch a subagent to survey:
- manifest files (package.json, Cargo.toml, etc.)
- README, Makefile, CI config
- existing CLAUDE.md, .cursor/rules, AGENTS.md
- Formatter configuration

## Phase 3: Fill in the gaps

Ask about:
- Codebase practices (non-obvious commands, gotchas)
- Personal preferences (role, familiarity, sandbox URLs)

## Phase 4: Write CLAUDE.md

Include only what Claude would get wrong without it:
- Build/test/lint commands that can't be guessed
- Code style rules that differ from defaults
- Non-obvious gotchas

## Phase 5: Write CLAUDE.local.md (if chosen)

Include personal preferences, sandbox URLs, communication style.

## Phase 6: Create skills

Name: verify-deep, session-report, deploy-sandbox
Location: .claude/skills/<skill-name>/SKILL.md

## Phase 7: Suggest hooks

- Format-on-edit hook
- Pre-commit hook

## Phase 8: Summary and next steps

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

./
├── CLAUDE.md              # 团队共享的项目指南
├── CLAUDE.local.md        # 个人配置（gitignored）
├── .claude/
│   ├── skills/
│   │   ├── verify/
│   │   │   └── SKILL.md
│   │   └── deploy/
│   │       └── SKILL.md
│   └── settings.json       # Hooks 配置
└── .gitignore             # 更新以包含 CLAUDE.local.md

1
2
3
4
5
6
7

Codex:
  用户输入 → 检查文件 → 提交 Prompt → 模型生成 → 写入文件

Claude Code:
  用户输入 → 询问需求 → 探索代码库 → 询问补充信息
          → 生成提案 → 用户确认 → 写入多个文件
          → 创建技能 → 建议优化 → 总结

1
2
3
4
5
6
7

pub enum SlashCommand {
    Feedback,
    New,
    Init,      // 内置命令
    Compact,
    // ...
}

1
2
3
4
5
6

const command = {
  type: 'prompt',
  name: 'init',
  description: 'Initialize project',
  async getPromptForCommand() { /* ... */ },
} satisfies Command

1

const INIT_PROMPT: &str = include_str!("../../prompt_for_init_command.md");

1
2
3

async getPromptForCommand() {
  return [{ type: 'text', text: NEW_INIT_PROMPT }]
}

1
2
3
4

feature('NEW_INIT') &&
  (process.env.USER_TYPE === 'ant' || isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
  ? NEW_INIT_PROMPT
  : OLD_INIT_PROMPT

1
2
3

> /init
[分析代码库...]
AGENTS.md 已创建

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

> /init
我来帮你初始化这个项目。

1. 你想要创建哪些文件？
   - Project CLAUDE.md
   - Personal CLAUDE.local.md
   - Both project + personal

2. 还要设置技能和 hooks 吗？
   - Skills + hooks
   - Skills only
   - Hooks only
   - Neither, just CLAUDE.md

[用户选择后...]

让我先探索一下代码库...

[分析完成后...]

我发现了这些信息：
- 项目类型：TypeScript + React
- 构建工具：npm
- 测试框架：Jest

[询问补充信息...]

[生成提案...]

这个提案看起来对吗？
- • Format-on-edit hook — ruff format <file>
- • /verify skill — npm test
- • CLAUDE.md note — "run tests before PR"

[用户确认后...]

CLAUDE.md 已创建
CLAUDE.local.md 已创建
技能 /verify 已创建
Hooks 已配置

1
2

> /init
AGENTS.md already exists here. Skipping /init.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

> /init
我发现已有 CLAUDE.md。让我先阅读它，然后建议改进...

[分析现有文件后...]

建议的改进：
1. 添加构建命令部分
2. 更新测试指令
3. 添加代码风格指南

是否应用这些更改？