Add teaching Python agent CLI with Poetry and CI

docs/README.md

@@ -0,0 +1,97 @@
+# 产品需求文档反推总览
+
+> 目标：基于现有源码结构，反推出这套 AI 编程产品的核心需求与产品设计，而不是复述实现细节。
+
+## 文档原则
+
+- 只写需求、目标、交互、约束、边界条件
+- 不直接泄露原始源码实现
+- 如需描述机制，只用自然语言或 Python 风格伪代码
+- 文档站在产品经理 / 系统设计者视角，回答“为什么需要这个能力”
+
+## 文档结构
+
+1. `00-product-overview.md`
+   - 产品定位
+   - 核心用户
+   - 核心问题
+   - 顶层系统能力
+
+2. `01-system-prompt-and-orchestration.md`
+   - 系统提示词层的需求
+   - 为什么要做动态拼装
+   - 为什么要做角色化 agent orchestration
+
+3. `02-tools-permissions-and-execution.md`
+   - 工具系统需求
+   - 权限系统需求
+   - Hook / 执行链路 / 安全要求
+
+4. `03-skills-plugins-mcp.md`
+   - Skills 需求
+   - Plugins 需求
+   - MCP 集成需求
+
+5. `04-memory-and-session.md`
+   - 记忆系统需求
+   - Session 管理需求
+   - 压缩、归档、恢复、摘要需求
+
+6. `05-commands-ui-and-operator-experience.md`
+   - 命令系统需求
+   - TUI / 状态栏 / 任务可视化需求
+   - 操作者体验
+
+7. `06-verification-and-quality.md`
+   - 验证 agent 需求
+   - 质量保证需求
+   - 失败报告与可追溯性需求
+
+8. `07-architecture-map.md`
+   - 按模块汇总产品能力地图
+   - 用于快速定位需求归属
+
+9. `08-agent-runtime-loop.md`
+   - 主循环规格
+   - 多轮执行与终止条件
+
+10. `09-message-model-and-state.md`
+   - 消息模型
+   - 会话与状态对象
+
+11. `10-context-management.md`
+   - 上下文预算
+   - 压缩与恢复
+
+12. `11-task-model.md`
+   - 任务模型
+   - 后台执行与通知
+
+13. `12-workspace-and-isolation.md`
+   - 工作区隔离策略
+   - 角色与写权限边界
+
+14. `13-failure-recovery.md`
+   - 失败处理
+   - 恢复机制
+
+15. `14-configuration-system.md`
+   - 配置来源与优先级
+   - Agent / Session 配置项
+
+16. `15-mvp-scope.md`
+   - Python MVP 范围
+   - 哪些先做，哪些后置
+
+17. `16-python-implementation-notes.md`
+   - Python 版实现建议
+   - 模块划分与里程碑
+
+## 阅读建议
+
+如果你想快速理解这套产品：
+
+1. 先看 `00-product-overview.md`
+2. 再看 `04-memory-and-session.md`
+3. 再看 `02-tools-permissions-and-execution.md`
+4. 最后看 `03-skills-plugins-mcp.md` 和 `06-verification-and-quality.md`