Add teaching Python agent CLI with Poetry and CI

docs/12-workspace-and-isolation.md

@@ -0,0 +1,59 @@
+# 12. 工作区与隔离策略规格
+
+## 1. 目标
+
+不同 agent 不能默认拥有相同的文件系统权限。产品必须允许根据角色与场景控制工作区隔离。
+
+## 2. 隔离模式
+
+Python 版建议至少定义：
+
+### 2.1 shared workspace
+主线程默认工作区，共享项目目录。
+
+### 2.2 read-only workspace
+用于探索、规划、验证等只读角色。
+
+### 2.3 temp workspace
+用于临时脚本、临时测试产物。
+
+### 2.4 worktree workspace
+用于隔离修改型子任务，避免污染主分支。
+
+### 2.5 remote workspace
+用于远程执行环境（第一版可不做）。
+
+## 3. 为什么隔离必须存在
+
+没有隔离会导致：
+- 子任务互相污染
+- 验证角色破坏项目
+- fork 实验影响主线程
+- 风险动作边界模糊
+
+## 4. 角色与隔离建议
+
+- Explore Agent -> read-only
+- Plan Agent -> read-only
+- Verification Agent -> read-only + temp writable
+- General Agent -> shared 或 worktree
+- 高风险实现任务 -> worktree
+
+## 5. 路径翻译需求
+
+如果子任务运行在 worktree 中，而继承的上下文引用的是父工作区路径，系统需要能做路径翻译或重新读取。
+
+## 6. 清理需求
+
+隔离工作区结束后必须支持：
+- 清理临时文件
+- 清理临时目录
+- 清理 worktree（如适用）
+- 清理孤儿进程
+
+## 7. 验收标准
+
+1. 只读角色不能修改项目文件
+2. 验证角色只能在 temp 目录写测试脚本
+3. worktree 任务不污染主项目目录
+4. 任务结束后能清理隔离资源