Add teaching Python agent CLI with Poetry and CI

docs/05-commands-ui-and-operator-experience.md

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