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 运行时变成用户可发现、可控制、可追踪的操作者体验。