ShowenV2/docs/WORKFLOW.md

ShowenV2 开发流程规范

核心原则

方案先行，记录完整，审核通过才执行。

---

标准工作流程

1. 方案阶段

• CEO 在 PROGRESS.md 或 TEAM_CHAT.md 中写明任务方案
• 方案内容: 目标、涉及文件、技术方案、验收标准
• git commit 方案文档

2. 派发阶段

• CEO 通过 kilo run -m openai/gpt-5.4 --auto --dir <dir> 派发，消息中指示读取灵魂文件和 TEAM_CHAT.md
• 任务描述中包含: 角色身份、具体要求、上下文文件列表、验收标准
• 更新 PROGRESS.md 记录谁在做什么

3. 审核阶段

• 成员交付后 CEO 检查:
  • cargo check 零 warning？
  • 逻辑与旧代码行为一致？
  • 代码风格一致？
  • 没有安全问题？
• 合格: git commit + 绩效记录 + 灵魂文件更新
• 不合格: 在 TEAM_CHAT.md 记录问题，重新派发（同人或换人）

4. 记录阶段

• 每次 git commit 前更新 PROGRESS.md
• 重大决策写入"关键决策记录"
• 成员经验写入 souls/.md
• 沟通记录写入 TEAM_CHAT.md

---

文件职责

文件	用途
PROGRESS.md	项目进度、完成状态、待办事项
TEAM.md	团队成员档案、制度、绩效
TEAM_CHAT.md	团队异步沟通、任务讨论、问题记录
souls/.md	成员灵魂：思想/性格/记忆/技能
WORKFLOW.md	本文件，开发流程规范

---

CEO 操作模板

派发任务

# 正确方式：把所有内容放在消息字符串里，让 kilo 自己读文件
kilo run -m openai/gpt-5.4 --auto \
  --dir /home/showen/Showen/ShowenV2 \
  "你是<角色名>。先读取 souls/<name>.md 和 TEAM_CHAT.md。任务：<具体说明>。完成后 cargo check 确认通过。"

审核提交

# 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 结构完整, 双连接架构正确