Skip to content

Commit 5c22462

Browse files
authored
Merge pull request #40 from calebax/feat/github-workflow
docs: TODO清单
2 parents 7eab89a + 09858eb commit 5c22462

3 files changed

Lines changed: 28 additions & 896 deletions

File tree

docs/TODO.md

Lines changed: 28 additions & 262 deletions
Original file line numberDiff line numberDiff line change
@@ -1,273 +1,39 @@
1-
# SingerOS 总体待办清单
1+
核心流程:
22

3-
> **最后更新:2026-04-25**
4-
> **架构版本:v3.1(三核架构 + 领域驱动设计)**
5-
>
6-
> 本文档是SingerOS项目的总体待办清单,按优先级和阶段划分。
7-
> 详细的Server和Worker任务分别参见:
8-
> - [TODO_SERVER.md](./TODO_SERVER.md) - Server端具体任务
9-
> - [TODO_WORKER.md](./TODO_WORKER.md) - Worker端具体任务
3+
- [ ] 数字员工 CRUD
4+
- [ ] 数字员工绑定对应worker服务,启停管理
5+
- [ ] 会话管理CRUD
6+
- [ ] agent运行流程(接收、处理、响应)@裴
7+
- [ ] 消息发送、调用执行流程。NATS订阅消费->页面响应
108

11-
---
9+
授权管理:
1210

13-
## 当前关注重点
11+
- [ ] 第三方账户授权接入(github等)
12+
- [ ]
1413

15-
1. **API接口规范** - 需要完善API接口定义,为前端开发提供明确的接口契约
16-
2. **会话管理体系** - 需要建立Session/Conversation数据模型和管理API,支持多轮对话场景
17-
3. **事件流转验证** - 需要验证Webhook→Event→Agent→Response完整链路的可行性
18-
4. **架构模块完善** - 需要根据v3.1架构文档补充Execution Engine等关键模块
14+
上下文优化:
1915

20-
---
16+
- [ ] 记忆模块 @裴
17+
- [ ] 上下文压缩
18+
- [ ] 自我学习进化
19+
- [ ] 错误、异常捕获/纠正,提升稳定性
20+
- [ ] 对话响应风格优化
2121

22-
## P0 - 紧急任务(1-2周内必须完成)
22+
流程能力完善:
2323

24-
### 目标:让前端可以开始开发,同时打通核心事件链路
24+
- [ ] 共享工作目录
25+
- [ ] 项目绑定
26+
- [ ] 消息渠道拓展、IM、webhook
2527

26-
#### P0-1: API接口定义(立即开始)
28+
定制流程/示例skill
2729

28-
**优先级:★★★★★**
29-
**目的:前端不再闲着,可以基于接口定义和Mock数据开发**
30+
- [ ] PR Review
31+
- [ ] ...
3032

31-
- [ ] 数字员工管理API
32-
- 创建、查询、更新、删除、启用/停用数字员工
33-
- 支持分页列表查询
34-
- [详细任务 → TODO_SERVER.md](./TODO_SERVER.md#1-数字员工管理)
35-
36-
- [ ] 会话管理API
37-
- 创建会话、发送消息、查询会话历史
38-
- 支持流式响应(SSE)
39-
- [详细任务 → TODO_SERVER.md](./TODO_SERVER.md#2-会话管理)
33+
基础模块完善
4034

41-
- [ ] 项目绑定API
42-
- 项目CRUD、GitHub OAuth授权、账号管理
43-
- [详细任务 → TODO_SERVER.md](./TODO_SERVER.md#3-项目绑定)
44-
45-
#### P0-2: NATS Stream会话控制(第2周)
46-
47-
**优先级:★★★★**
48-
**目的:实现基于SessionID的事件路由和隔离**
49-
50-
- [ ] Session-based Stream策略设计
51-
- [ ] Session Stream生命周期管理
52-
- [ ] Consumer Group管理
53-
- [ ] 消息TTL和清理策略
54-
- [ ] [详细任务 → TODO_WORKER.md](./TODO_WORKER.md#1-nats-jetstream优化)
55-
56-
#### P0-3: 会话上下文管理(第2周)
57-
58-
**优先级:★★★★**
59-
**目的:Agent支持会话历史和上下文**
60-
61-
- [ ] SessionContext存储接口
62-
- [ ] 基于Redis的短期记忆
63-
- [ ] Agent Run时注入会话历史
64-
- [ ] 对话轮次限制
65-
- [ ] [详细任务 → TODO_WORKER.md](./TODO_WORKER.md#2-会话上下文管理)
66-
67-
---
68-
69-
## P1 - 重要任务(3-4周完成)
70-
71-
### 目标:完善架构模块,打通事件流转
72-
73-
#### P1-1: Execution Engine实现(架构要求)
74-
75-
**优先级:★★★★**
76-
**目的:符合v3.1架构文档要求,Event Engine与Execution Engine解耦**
77-
78-
- [ ] Execution Engine核心逻辑
79-
- [ ] 任务分发器
80-
- [ ] 同步/异步执行器
81-
- [ ] 重试和超时控制
82-
- [ ] Orchestrator重构使用Execution Engine
83-
- [ ] [详细任务 → TODO_WORKER.md](./TODO_WORKER.md#3-execution-engine实现)
84-
85-
#### P1-2: Event Engine完善
86-
87-
**优先级:★★★**
88-
**目的:事件路由插件化,去除硬编码**
89-
90-
- [ ] 独立Router提取
91-
- [ ] 内置事件处理器(PR/Issue/Push)
92-
- [ ] [详细任务 → TODO_WORKER.md](./TODO_WORKER.md#4-event-engine完善)
93-
94-
#### P1-3: GitHub PR Review完整链路
95-
96-
**优先级:★★★★★**
97-
**目的:端到端验证MVP核心功能**
98-
99-
- [ ] PR Diff获取能力
100-
- [ ] PR Review发布能力
101-
- [ ] code-review Skill实现
102-
- [ ] Webhook配置
103-
- [ ] 端到端测试
104-
- [ ] [详细任务 → TODO_WORKER.md](./TODO_WORKER.md#6-github-pr-review完整链路)
105-
106-
---
107-
108-
## P2 - 次要任务(5-6周完成)
109-
110-
### 目标:前端功能完善,Skill系统落地
111-
112-
#### P2-1: 前端功能开发
113-
114-
**优先级:★★★**
115-
**目的:完整的用户界面**
116-
117-
- [ ] 数字员工管理页面
118-
- [ ] 会话页面(消息气泡、流式打字机)
119-
- [ ] 会话历史侧边栏
120-
- [ ] 项目绑定界面
121-
- [ ] [详细任务 → TODO_SERVER.md](./TODO_SERVER.md#5-前端协同)
122-
123-
#### P2-2: Skill实现
124-
125-
**优先级:★★**
126-
**目的:将SKILL.md转换为可执行的Go代码**
127-
128-
- [ ] code-review Skill
129-
- [ ] weather Skill
130-
- [ ] commit-conventions Skill
131-
- [ ] humanizer-zh Skill
132-
- [ ] [详细任务 → TODO_WORKER.md](./TODO_WORKER.md#5-skill实现)
133-
134-
---
135-
136-
## P3 - 扩展任务(后续规划)
137-
138-
### 长期能力建设
139-
140-
- [ ] Memory系统(长期记忆/RAG)
141-
- [ ] Workflow Engine(DAG编排)
142-
- [ ] Policy Engine(权限控制)
143-
- [ ] Model Router(多模型管理)
144-
- [ ] 多租户隔离
145-
- [ ] RBAC权限
146-
- [ ] 成本管理
147-
- [ ] 其他渠道Connector(GitLab、飞书、企业微信)
148-
- [ ] Edge Runtime
149-
- [ ] Remote Runtime
150-
- [ ] Runtime Manager
151-
152-
---
153-
154-
## 里程碑
155-
156-
### Phase 1(Week 1)- 接口定义完成 ✅ 进行中
157-
- [ ] 数字员工API定义完成
158-
- [ ] 会话管理API定义完成
159-
- [ ] 项目绑定API定义完成
160-
- [ ] DTO和数据模型定义完成
161-
- [ ] 前端可以基于Mock开始开发
162-
163-
**交付物:**
164-
- TODO_SERVER.md 完整定义
165-
- API文档
166-
- Mock数据和服务
167-
168-
### Phase 2(Week 2)- 会话控制完成
169-
- [ ] NATS Stream会话管理实现
170-
- [ ] Session上下文持久化
171-
- [ ] Agent支持会话历史
172-
- [ ] 前端会话页面对接真实API
173-
174-
**交付物:**
175-
- Session管理API可用
176-
- SSE流式响应可用
177-
- 前端可以发送消息并收到流式响应
178-
179-
### Phase 3(Week 3)- 事件流转打通
180-
- [ ] Execution Engine实现
181-
- [ ] Event Engine完善
182-
- [ ] GitHub PR Review端到端跑通
183-
- [ ] 前端会话功能完整
184-
185-
**交付物:**
186-
- 测试仓库创建PR后自动收到AI Review
187-
- Review包含具体的代码分析
188-
- 无错误日志
189-
190-
### Phase 4(Week 4)- MVP完善
191-
- [ ] 所有P0/P1任务完成
192-
- [ ] Issue自动回复可用
193-
- [ ] 前端功能完善
194-
- [ ] 稳定性优化
195-
196-
**交付物:**
197-
- MVP功能完整可用
198-
- 系统稳定性 > 99%
199-
- 端到端延迟 < 30秒
200-
201-
---
202-
203-
## 任务分配建议
204-
205-
### 后端团队(2-3人)
206-
207-
**后端开发A(API方向):**
208-
- 数字员工管理API
209-
- 会话管理API
210-
- 项目绑定API
211-
212-
**后端开发B(事件方向):**
213-
- Execution Engine实现
214-
- Event Engine完善
215-
- NATS Stream管理
216-
- GitHub工具实现
217-
218-
**前端开发(1人):**
219-
- 数字员工管理页面
220-
- 会话页面
221-
- 项目绑定页面
222-
- API对接和WebSocket/SSE
223-
224-
---
225-
226-
## 风险控制
227-
228-
### 关键风险
229-
230-
1. **API设计不合理** - 需要反复调整
231-
- 缓解:先出接口文档评审,再实现
232-
233-
2. **NATS Stream策略复杂** - 可能影响性能
234-
- 缓解:先实现基础版,后续优化
235-
236-
3. **Execution Engine与Orchestrator解耦困难**
237-
- 缓解:先定义清晰接口,逐步迁移
238-
239-
### 不允许做的事情
240-
241-
- ❌ 不要设计复杂Agent(Plan/Reflect)
242-
- ❌ 不要做Memory系统(短期除外)
243-
- ❌ 不要做多租户
244-
- ❌ 不要做过度的Workflow Engine
245-
246-
---
247-
248-
## 成功标准
249-
250-
### MVP验收(Phase 3完成后)
251-
252-
- [ ] 可以创建一个代码助手数字员工
253-
- [ ] 可以绑定GitHub仓库
254-
- [ ] 可以通过GitHub PR事件触发任务
255-
- [ ] 可以自动分析代码并生成Review
256-
- [ ] 可以回写PR审查评论到GitHub
257-
- [ ] 可以查看任务执行记录
258-
- [ ] 审查质量达到人工审查的60%以上
259-
- [ ] 端到端延迟小于30秒
260-
- [ ] 系统稳定性大于99%
261-
262-
---
263-
264-
## 相关文档
265-
266-
- [ARCHITECTURE.md](./ARCHITECTURE.md) - 架构设计文档(v3.1)
267-
- [PRD.md](./PRD.md) - 产品需求文档(v2.0)
268-
- [TODO_SERVER.md](./TODO_SERVER.md) - Server端详细任务
269-
- [TODO_WORKER.md](./TODO_WORKER.md) - Worker端详细任务
270-
271-
---
272-
273-
*最后更新:2026-04-25*
35+
- [ ] 账户、租户体系
36+
- [ ] 数据库版本管理
37+
- [ ] 响应结构规范
38+
- [ ] 业务规则、数据配置
39+
- [ ] ci/cd

0 commit comments

Comments
 (0)