基本用法
了解 Auto-Coder.Chat 的四种日常使用模式：传统模式、异步模式、SubAgents Cowork 和 Headless 模式。
基本用法
Auto-Coder.Chat 提供四种使用模式，适应不同的开发场景。
cd your-project
auto-coder.chat # 经典命令行
auto-coder.chat.lite # 轻量命令行
| 模式 | 命令 | 适用场景 |
|---|---|---|
| 传统模式 | /auto | 同步执行，实时看进展 |
| 异步模式 | /async | 后台并行，自动合并 |
| SubAgents Cowork | $workflow | 多 Agent 分阶段协作 |
| Headless 模式 | auto-coder.run | 脚本化调用、自动化流水线、非交互场景 |
传统模式（/auto）
最直接的使用方式 —— 通过 /auto 命令让 AI 分析并执行编码任务：
/auto 帮我实现一个用户登录功能
/auto 后面直接接你的需求描述即可。AI 会在当前会话中同步执行任务，你可以实时看到进展。
文件引用
使用 @ 符号引用文件路径，按 Tab 键自动补全：
/auto 重构 @src/utils/auth.ts 中的认证逻辑
会话管理
# 开启一个全新的会话
/auto /new
# 查看所有历史会话
/auto /list
Headless 模式（auto-coder.run）
当你希望在非交互环境中运行 Auto-Coder（例如 Claw、CI/CD、批处理脚本）时，推荐使用无头 CLI 入口 auto-coder.run（别名 auto-coder.cli）。
快速上手：
auto-coder.run --from-prompt-file task.md --verbose --output-format stream-json
--from-prompt-file：prompt 文件化，便于版本管理和复用--verbose：输出更完整的执行过程，方便排查--output-format stream-json：实时流式事件，便于程序解析与进度跟踪
完整的参数说明、会话复用、--async 并行执行、CI/CD 与 Claw 集成示例，请参考 Headless 模式。
常用命令速查
| 命令 | 说明 |
|---|---|
/auto <需求> | 同步执行编码任务 |
/auto /new | 开启新会话 |
/auto /list | 查看历史会话 |
/auto /merge <job> | 合并异步任务到主分支 |
/async /name <name> /time <time> <需求> | 提交异步任务 |
/async /name <name> /workflow <wf> | 异步执行 workflow |
/async /list | 查看异步任务列表 |
/async /task <name> | 查看任务详情 |
/workflow <name> [key=value] | 执行 workflow（标准命令） |
$<name> <需求> | 执行 workflow（快捷方式） |
/chat <问题> | 与 AI 聊天（不修改代码） |
auto-coder.run --from-prompt-file <file> | Headless 模式（Claw/自动化友好） |
!<command> | 执行外部 shell 命令 |
@<path> + Tab | 文件路径补全 |
下一步
- 了解异步模式，将任务提交到后台并行执行
- 了解 Headless 模式，在脚本与 CI/CD 中非交互式运行 Auto-Coder
- 了解 Cowork 模式，将复杂任务拆解为多阶段工作流
- 查看项目结构了解项目组织方式