docs: 建立开发流程规范 WORKFLOW.md
方案先行,记录完整,审核通过才执行。 包含: 标准流程4阶段, CEO操作模板, 第二轮任务方案 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
99
WORKFLOW.md
Normal file
99
WORKFLOW.md
Normal file
@@ -0,0 +1,99 @@
|
||||
# ShowenV2 开发流程规范
|
||||
|
||||
## 核心原则
|
||||
**方案先行,记录完整,审核通过才执行。**
|
||||
|
||||
---
|
||||
|
||||
## 标准工作流程
|
||||
|
||||
### 1. 方案阶段
|
||||
- CEO 在 PROGRESS.md 或 TEAM_CHAT.md 中写明任务方案
|
||||
- 方案内容: 目标、涉及文件、技术方案、验收标准
|
||||
- git commit 方案文档
|
||||
|
||||
### 2. 派发阶段
|
||||
- CEO 通过 `kilo run -m openai/gpt-5.4 --auto --dir <dir> -f <灵魂文件> -f TEAM_CHAT.md` 派发
|
||||
- 任务描述中包含: 角色身份、具体要求、上下文文件列表、验收标准
|
||||
- 更新 PROGRESS.md 记录谁在做什么
|
||||
|
||||
### 3. 审核阶段
|
||||
- 成员交付后 CEO 检查:
|
||||
- [ ] cargo check 零 warning?
|
||||
- [ ] 逻辑与旧代码行为一致?
|
||||
- [ ] 代码风格一致?
|
||||
- [ ] 没有安全问题?
|
||||
- 合格: git commit + 绩效记录 + 灵魂文件更新
|
||||
- 不合格: 在 TEAM_CHAT.md 记录问题,重新派发(同人或换人)
|
||||
|
||||
### 4. 记录阶段
|
||||
- 每次 git commit 前更新 PROGRESS.md
|
||||
- 重大决策写入"关键决策记录"
|
||||
- 成员经验写入 souls/<name>.md
|
||||
- 沟通记录写入 TEAM_CHAT.md
|
||||
|
||||
---
|
||||
|
||||
## 文件职责
|
||||
|
||||
| 文件 | 用途 |
|
||||
|------|------|
|
||||
| PROGRESS.md | 项目进度、完成状态、待办事项 |
|
||||
| TEAM.md | 团队成员档案、制度、绩效 |
|
||||
| TEAM_CHAT.md | 团队异步沟通、任务讨论、问题记录 |
|
||||
| souls/<name>.md | 成员灵魂:思想/性格/记忆/技能 |
|
||||
| WORKFLOW.md | 本文件,开发流程规范 |
|
||||
|
||||
---
|
||||
|
||||
## CEO 操作模板
|
||||
|
||||
### 派发任务
|
||||
```bash
|
||||
kilo run -m openai/gpt-5.4 --auto \
|
||||
--dir /home/showen/Showen/ShowenV2 \
|
||||
-f souls/<成员名>.md \
|
||||
-f TEAM_CHAT.md \
|
||||
"<任务描述>"
|
||||
```
|
||||
|
||||
### 审核提交
|
||||
```bash
|
||||
# 1. 检查改动
|
||||
git diff --stat
|
||||
# 2. 验证编译
|
||||
export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:$PATH"
|
||||
cargo check
|
||||
# 3. 审核代码(CEO 读文件)
|
||||
# 4. 提交
|
||||
git add <files> && git commit -m "<msg>"
|
||||
# 5. 更新进度
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 当前第二轮任务方案
|
||||
|
||||
### 任务 A: ServiceManager Broadcast (张明远)
|
||||
- **目标**: Message 实现 Clone,Broadcast 真正转发给所有插件
|
||||
- **文件**: core/message.rs, core/service_manager.rs
|
||||
- **方案**: derive(Clone) for Message + 所有子类型; Broadcast 遍历 plugins 调 handle_message(msg.clone())
|
||||
- **验收**: cargo check 通过, Broadcast 消息能到达所有插件
|
||||
|
||||
### 任务 B: VideoProcessor (李思琪)
|
||||
- **目标**: 完整迁移旧 video_processor.rs 的 VideoTransformer + VideoProcessor
|
||||
- **文件**: plugins/video/processor.rs, plugins/video/mod.rs
|
||||
- **方案**: 三大类 VideoTransformer(帧变换) + TransitionEffect(过渡) + VideoProcessor(主循环+状态机)
|
||||
- **验收**: cargo check 通过, API 方法完整 (play/pause/next/trigger/status)
|
||||
|
||||
### 任务 C: HttpPlugin (赵雨薇)
|
||||
- **目标**: 完整 HTTP API + Web UI
|
||||
- **文件**: plugins/http/mod.rs, plugins/http/routes.rs
|
||||
- **方案**: warp 路由, std::thread 跑 tokio runtime, 通过 Envelope 与其他插件通信
|
||||
- **验收**: cargo check 通过, 路由覆盖旧 api_server.rs 所有 endpoint
|
||||
|
||||
### 任务 D: BlePlugin (王浩然)
|
||||
- **目标**: BLE GATT 配网 + LocalName 双连接修复
|
||||
- **文件**: plugins/ble/mod.rs, plugins/ble/gatt.rs
|
||||
- **方案**: 双 D-Bus 连接 (conn_server 回调线程 + conn_client 同步注册)
|
||||
- **验收**: cargo check 通过, GATT 结构完整, 双连接架构正确
|
||||
Reference in New Issue
Block a user