第二十九课：/init 自动生成与优化

学习目标

• 掌握 /init 命令的使用方法
• 学会分析生成结果
• 了解手动优化技巧

一、/init 命令

在 Codex 交互会话中输入 /init，代理会分析项目并自动生成 AGENTS.md 脚手架。

1.1 使用方法

codex
> /init

代理会：

1. 扫描项目结构
2. 检测技术栈
3. 识别包管理器
4. 查找测试框架
5. 生成 AGENTS.md

1.2 生成内容

/init 通常会检测并生成：

• 项目概述
• 安装命令
• 开发命令
• 测试命令
• 构建命令
• 项目结构

二、分析生成结果

2.1 检查准确性

生成后应该检查：

• 命令是否正确
• 技术栈是否准确
• 是否遗漏重要信息

2.2 补充缺失信息

/init 可能遗漏：

• 环境变量配置
• 数据库设置
• 部署流程
• 已知问题

2.3 删除无关信息

/init 可能包含不需要的信息，应该删除。

三、手动优化技巧

3.1 添加项目上下文

## 项目背景
这是一个面向中小企业的 CRM 系统，主要功能包括客户管理、销售跟踪、报表生成。

3.2 添加常见问题

## 常见问题
- 首次运行需要创建数据库：pnpm db:create
- 如果遇到类型错误，重新生成 Prisma Client：pnpm prisma generate

3.3 添加工作流

## 开发工作流
1. 从 main 分支创建特性分支
2. 开发并测试
3. 提交 PR
4. 代码审查
5. 合并到 main

四、/init 的局限性

/init 有以下局限：

• 可能检测错误的技术栈
• 可能遗漏特殊的项目约定
• 无法了解项目的业务逻辑
• 无法知道已知的坑

因此，/init 生成的结果需要人工审核和优化。

五、本课小结

要点	说明
/init	自动生成 AGENTS.md 脚手架
生成内容	概述、命令、结构
局限性	可能不准确，需要人工优化
优化	补充上下文、问题、工作流

下一步

下一课我们将了解跨代理兼容性。