|
1 | | -# SingerOS 总体待办清单 |
| 1 | +核心流程: |
2 | 2 |
|
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订阅消费->页面响应 |
10 | 8 |
|
11 | | ---- |
| 9 | +授权管理: |
12 | 10 |
|
13 | | -## 当前关注重点 |
| 11 | +- [ ] 第三方账户授权接入(github等) |
| 12 | +- [ ] |
14 | 13 |
|
15 | | -1. **API接口规范** - 需要完善API接口定义,为前端开发提供明确的接口契约 |
16 | | -2. **会话管理体系** - 需要建立Session/Conversation数据模型和管理API,支持多轮对话场景 |
17 | | -3. **事件流转验证** - 需要验证Webhook→Event→Agent→Response完整链路的可行性 |
18 | | -4. **架构模块完善** - 需要根据v3.1架构文档补充Execution Engine等关键模块 |
| 14 | +上下文优化: |
19 | 15 |
|
20 | | ---- |
| 16 | +- [ ] 记忆模块 @裴 |
| 17 | +- [ ] 上下文压缩 |
| 18 | +- [ ] 自我学习进化 |
| 19 | +- [ ] 错误、异常捕获/纠正,提升稳定性 |
| 20 | +- [ ] 对话响应风格优化 |
21 | 21 |
|
22 | | -## P0 - 紧急任务(1-2周内必须完成) |
| 22 | +流程能力完善: |
23 | 23 |
|
24 | | -### 目标:让前端可以开始开发,同时打通核心事件链路 |
| 24 | +- [ ] 共享工作目录 |
| 25 | +- [ ] 项目绑定 |
| 26 | +- [ ] 消息渠道拓展、IM、webhook |
25 | 27 |
|
26 | | -#### P0-1: API接口定义(立即开始) |
| 28 | +定制流程/示例skill |
27 | 29 |
|
28 | | -**优先级:★★★★★** |
29 | | -**目的:前端不再闲着,可以基于接口定义和Mock数据开发** |
| 30 | +- [ ] PR Review |
| 31 | +- [ ] ... |
30 | 32 |
|
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 | +基础模块完善 |
40 | 34 |
|
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