Files
xiaoxia-saas/docs/checklists/session-start.md
T

114 lines
3.4 KiB
Markdown

# session-start.md
# 小虾 SaaS 会话启动检查清单
**用途**: 每次进入小虾 SaaS 项目工作前,必须逐项确认,避免新会话失忆、环境跑偏、文档路径失效。
**状态**: ✅ 生效中
---
## 一、强制读取顺序
启动后必须先读:
1. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\AGENTS.md`
2. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\META.md`
3. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\小虾SaaS全自动化开发完整体系.md`
4. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\小虾SaaS开发环境防跑偏收敛方案.md`
5. `F:\openclaw-saas\docs\PHASE7-PROGRESS.md`
6. `F:\openclaw-saas\docs\PHASE7-DESIGN.md`
7. `F:\openclaw-saas\docs\checklists\session-start.md`
---
## 二、路径检查(强制)
在开始工作前,必须确认以下路径真实存在:
- [ ] `META.md` 存在
- [ ] `小虾SaaS全自动化开发完整体系.md` 存在
- [ ] `小虾SaaS开发环境防跑偏收敛方案.md` 存在
- [ ] `F:\openclaw-saas\docs\PHASE7-PROGRESS.md` 存在
- [ ] `F:\openclaw-saas\docs\PHASE7-DESIGN.md` 存在
- [ ] `F:\openclaw-saas\docs\checklists\session-start.md` 存在
**如果不存在:**
- 立即停止当前任务
- 先修正文档路径或补齐缺失文件
- 禁止带着失效路径继续工作
---
## 三、理解检查(必须能答)
### 项目状态
- [ ] 当前 Phase 是:Phase 7 - 核心视频剪辑业务
- [ ] 当前 Phase 主要目标:打通上传→分类→生成→成片主链路
- [ ] 当前正在做的事:环境与 CI 收口 / 或正式业务开发(按最新进度文档)
### 团队结构
- [ ] 8 个 Agent 分别是:requirement / arch / code_dev / lint_review / test / build_pack / release / ops_monitor
- [ ] 小虾工作量占比:12.5%
### Git / CI 规则
- [ ] main 和 develop 禁止直接 push
- [ ] Commit 格式:`<type>(<scope>): <subject>`
- [ ] Gitea CI 真源:`F:\openclaw-saas\.gitea\workflows\`
- [ ] `.github/workflows``.gitea/workflows` 必须保持一致
### 环境规则
- [ ] CI Python 唯一标准:`venv + 官方 PyPI`
- [ ] 当前统一容器基座:`catthehacker/ubuntu:act-latest`
- [ ] 不能再混用全局 `pip` / apt 替代 / `--break-system-packages`
---
## 四、开始工作前的判断
在正式动手前,必须先判断当前任务属于哪类:
- [ ] 文档修正
- [ ] 环境收敛
- [ ] Agent 编排
- [ ] Phase 7 业务开发
- [ ] Git / CI / 部署
- [ ] 运维 / 监控
然后确认:
- [ ] 需要读哪一份相关文档
- [ ] 需要哪个 Agent 主导
- [ ] 是否会影响 Git / CI / 环境真源
---
## 五、禁止事项
以下情况一旦出现,必须立刻停下:
- [ ] 我不知道当前 Phase
- [ ] 我不知道当前 CI 真源在哪
- [ ] 我不知道文档路径是否有效
- [ ] 我打算先改了再说
- [ ] 我准备临时换一个环境方案试试
- [ ] 我没有看完核心文档就开始执行
---
## 六、向老大的启动汇报模板
完成检查后,对老大的标准汇报应为:
> 会话启动完成,已加载核心文档;当前 Phase 为 Phase 7,当前任务已对齐开发体系与环境收敛规则,可以开始执行。
---
## 七、结束语
这份清单不是形式,而是防止:
- 新会话失忆
- 文档路径漂移
- 环境规则混乱
- 再次出现“边跑边修、越修越乱”
**不做检查,不允许开工。**