ai-agent-deep-dive/docs/05-commands-ui-and-operator-experience.md

# 05. 命令系统、界面与操作者体验需求文档

## 1. 为什么命令系统是一级产品能力

这类产品不是单轮对话工具，而是一个长期运行的操作者界面。因此，命令系统不是附属功能，而是操作面板。

## 2. 命令系统需求

产品需要支持用户快速控制以下对象：
- memory
- permissions
- hooks
- mcp
- skills
- tasks
- review / plan / status
- 输出风格
- model
- sandbox
- 插件管理

## 3. 命令系统的产品目标

1. 降低复杂能力的学习成本
2. 提供清晰的系统控制入口
3. 把高级功能从自然语言里解耦出来
4. 为插件和技能提供统一入口面

## 4. UI / TUI 的核心需求

### 4.1 任务可见性
用户需要看到：
- 当前在做什么
- 后台任务是否运行中
- 子 agent 在做什么
- 哪些动作在等待权限

### 4.2 状态反馈
系统需要及时反馈：
- 进度
- 错误
- 被阻断原因
- 工具运行状态

### 4.3 结构化展示
系统需要把复杂状态结构化展示出来，例如：
- memory 面板
- permissions 面板
- skills 列表
- hooks 状态
- mcp 状态
- tasks 状态

## 5. 为什么操作者体验是核心需求

如果系统很强，但用户看不懂当前状态，就会产生：
- 不信任
- 不敢授权
- 不知道何时干预
- 不知道下一步怎么控制

因此产品必须让操作者感觉：
- 任务是透明的
- 系统是可控的
- 能力是可发现的

## 6. 后台任务与通知需求

一旦支持 background agents，系统就必须支持：
- 后台任务注册
- 进度更新
- 完成通知
- 输出文件查看
- 必要时 kill / cancel

## 7. 命令系统的扩展需求

命令系统还必须允许：
- 内建命令
- 插件命令
- skill 入口
- 条件启用的功能命令

## 8. 产品经理视角下的总需求句

> 这套产品不仅要有能力，还要有可操作性。命令系统与界面层的目标，是把复杂的 AI 运行时变成用户可发现、可控制、可追踪的操作者体验。